====== ログの監視と収集 ======
{{indexmenu_n>9}}
[[ja:documentation:start|Pandora FMS ドキュメント一覧に戻る]]
===== 概要 =====
{{ :wiki:pfms-log-collection-monitoring.png }}
{{:wiki:icono-modulo-enterprise.png |Enterprise 版}}Pandora FMS におけるログ監視には、以下の 2つの異なる手法があります。
- **モジュールベース**: 非同期監視としの Pandora でログを表現します。ユーザにより事前設定された条件を満たすデータを検出した場合にアラートを関連付けることができます。 ログのモジュール表現では、以下を行うことができます:
- ログの中で正規表現にマッチする数を数えるモジュールの作成
- ログメッセージの行および内容を取得
- **複合表示ベース**: キャプチャしたい複数の発生元のログからすべての情報を 1つのコンソールで表示し、ログが処理されたタイムスタンプを使用して情報を順番に整理できます。
バージョン 7.0NG 712 からは、Pandora FMS に、ログ情報を保存するための [[https://en.wikipedia.org/wiki/Elasticsearch|Elasticsearch]] が組み込まれているため、パフォーマンスが大幅に向上しています。
===== 動作の仕組み =====
処理は単純です。
{{ :wiki:logsesquema.png?650 }}
* [[:ja:documentation:pandorafms:introduction:03_glossary#ソフトウエアエージェント|ソフトウエアエージェント]]で分析されたログ (**eventlog** またはテキストファイル) は、Pandora サーバへ転送されます。エージェントから送信される [[:ja:documentation:pandorafms:introduction:03_glossary#データファイルxml_データ|XML]] に (RAW) データとして含まれます。
* Pandora FMS データサーバは、エージェントから XML を受け取ります。そこには、監視とログの両方の情報が含まれています。
* データサーバが XML データを処理する時に、ログ情報を識別し、報告されたエージェントに関する情報やログのソースをプライマリデータベースに保存し、ログの保存には情報を自動的に ElasticSearch に送信します。
* Pandora FMS はデータを Elasticsearch インデックスに保存し、各 Pandora FMS インスタンスの日次インデックスを生成します。
* Pandora FMS サーバには、システム管理者が定義した間隔(デフォルトでは90日)でインデックスを削除するメンテナンスタスクがあります。
===== サーバの必要条件 =====
Pandora FMS サーバと Elasticsearch は別々のサーバに展開することをお勧めします。
* Rocky Linux 8 または RHEL 8。
* 最低 4GB のメモリ、ただし ElasticSearch インスタンスでは、6GB のメモリを推奨します。
* Elastic が動作するサーバでの SWAP の無効化。
* 最低 2 CPUコア。
* 最低 20GB のシステムディスク空き領域。
* 最低 50GB の ElasticSearch データディスク空き領域(保存されるデータの量に応じて、異なる場合があります)。 Elasticsearch のディスク使用量は非常に多いため、読み取りと書き込みの速度が速いほど、**環境のパフォーマンスが向上します**。
* Pandora FMS サーバから、Elasticsearch API (デフォルトポートは 9200/TCP) への接続性。
上記の最低条件のシングルノード環境では、毎日最大 1 GB のデータを保存し、デフォルトで 8日間保存できます。
より高いデータ復元力とフォールトトレランスが必要な場合は、Elasticsearch クラスターを構成する必要があります(データの整合性を保証するために最低 3つのノード)。 クラスタ環境に移行する場合、ノード間で負荷を分散し、環境の処理能力を 2倍(3ノードの場合)にすることもできます。 //異なるノード//で同時に処理したい場合は**負荷分散システムが必要になります**。
===== Elasticsearch のインストールと設定 =====
Elasticsearch の公式ドキュメントは以下にあります。
* [[https://www.elastic.co/guide/en/elasticsearch/reference/current/install-elasticsearch.html|https://www.elastic.co/guide/en/elasticsearch/reference/current/install-elasticsearch.html]]
==== インストール ====
Rocky Linux 8 の場合、RPM パッケージを使用してインストールすることをお勧めします。これは、Elasticsearch データベースのインストールに必要なものすべてを含んだ単一のパッケージです。
ダウンロードには、[[https://www.elastic.co/downloads/elasticsearch|https://www.elastic.co/downloads/elasticsearch]] へ行き、''Linux x86_64'' ( AMD® または Intel® 64 ビットプロセッサ) を選択します。
パッケージをダウンロードしたら、Eleasticsearch をインストールするサーバにアップロードし、そのディレクトリに移動して、必要な権限を持ったユーザで次のように実行します。
dnf install ./downloaded_packet.rpm
次のような出力が表示されます。
{{ :wiki:pfms-rmp_-i_elasticsearch-8.2.0-x86_64.rmp.png }}
サービスが正しくインストールされたことを確認するには、次のコマンドを実行します。
systemctl status elasticsearch.service
次のような出力が表示されます。
{{ :wiki:pfms-systemctl_status_elasticsearch.service-dead.png }}
Elasticsearch サービスが無効になっていることに注意してください。
==== ノードの設定 ====
\\
最初に、設定ファイル ''/etc/elasticsearch/elasticsearch.yml'' を編集し、**Elasticsearch サービスを起動**する必要があります。
このファイルには、Elasticsearch サービスのすべてのパラメータ設定が含まれています。詳細については、公式ドキュメントを参照してください。
* [[https://www.elastic.co/guide/en/elasticsearch/reference/current/settings.html|https://www.elastic.co/guide/en/elasticsearch/reference/current/settings.html]]
次に、サービスを開始するために必要最小限の設定と、Pandora FMS での使用について説明します。
* ポート番号、データの場所、イベントログファイルの場所を設定します:
# ---------------------------------- Network -----------------------------------
# Set a custom port for HTTP:
http.port: 9200
# ----------------------------------- Paths ------------------------------------
# Path to directory where to store the data (separate multiple locations by a comma):
path.data: /var/lib/elastic
# Path to log files:
path.logs: /var/log/elastic
* ''xpack'' を設定します:
xpack.security.enabled: false
xpack.security.enrollment.enabled: false
{{ :wiki:pfms-eleasctisearch-xpack.security.enabled_false-xpack.security.enrollment.enabled_false.png }}
* この行を[[:ja:documentation:pandorafms:introduction:03_glossary#commenting_out_or_uncommenting_a_parameter|コメントアウト]]します。
#http.host: [_local_]
#transport.host: [_local_]
また、以下の行の //コメントを外し//、次のように定義する必要があります。
cluster.name: pandorafms
node.name: ${HOSTNAME}
network.host: 0.0.0.0
**cluster.name**
これは、グループまたはクラスタの名前です。
**node.name**
システムの環境変数 ''${HOSTNAME}'' を使っているので、ホスト名が自動的に利用されます。
**network.host**
''network.host'' に ''0.0.0.0'' を指定すると Elasticsearch は全ネットワークインタフェース(NIC)で待ち受けます。//特定の NIC を指定する場合は、特定の値を指定します。//
クラスターを使用する場合は、''discovery.seed_hosts'' を設定する必要があります(詳細については、[[:ja:quickguides:elasticsearch_cluster| Elasticsearch サーバのクラスターの構成]] を参照してください):
discover.seed_hosts : ["ip:port", "ip", "ip"]
または(フォーマット例):
discovery.seed_hosts:
- 192.168.1.10:9300
- 192.168.1.11
- seeds.mydomain.com
\\ Elasticsearch の最新バージョンでは、Java® 仮想マシンのメモリ管理は自動的に行われるため、本番環境ではこれを利用することをお勧めします。したがって、Elasticsearch の JVM の値を変更する**必要はありません**。
完了したら、以下を実行します:
systemctl start elasticsearch.service
Elasticsearch が起動するまでしばらくお待ちください。ステータスを照会するコマンドは次のとおりです。
systemctl status elasticsearch.service
次のような出力が見られます。
{{ :wiki:pfms-systemctl_status_elasticsearch.service.png }}
サービスの開始に失敗した場合は、''/var/log/elastic/'' にあるログ(この場合はファイル ''pandorafms.log'' //またはノードに付けられた名前//)を確認してください。
Elasticsearch のインストールをテストするには、ターミナルウィンドウで次のコマンドを実行します。
curl -q http://{IP}:9200/
''{IP}'' をインストールされている Elasticsearch の IP アドレスまたは URL に置き換えます。
次のような応答が得られます。
{
"name" : "3743885b95f9",
"cluster_name" : "docker-cluster",
"cluster_uuid" : "7oJV9hXqRwOIZVPBRbWIYw",
"version" : {
"number" : "7.6.2",
"build_flavor" : "default",
"build_type" : "docker",
"build_hash" : "ef48eb35cf30adf4db14086e8aabd07ef6fb113f",
"build_date" : "2020-03-26T06:34:37.794943Z",
"build_snapshot" : false,
"lucene_version" : "8.4.0",
"minimum_wire_compatibility_version" : "6.8.0",
"minimum_index_compatibility_version" : "6.0.0-beta1"
},
"tagline" : "You Know, for Search"
}
本番環境に向けては、Elasticsearch のベストプラクティスを参照することをお勧めします。
* [[https://www.elastic.co/guide/en/elasticsearch/reference/current/system-config.html#dev-vs-prod|https://www.elastic.co/guide/en/elasticsearch/reference/current/system-config.html#dev-vs-prod]]
=== Elasticsearch クラスタ設定 ===
* Elasticsearch クラスターの最小サイズは 3ノードであり、//quorum// システムを利用してデータの整合性を保証するには、常に奇数で増やす必要があります。
* 3つのノードすべての間で通信が可能であり、各ノード間でポート 9200 および 9300 へアクセスできることを確認してください。
これらのポート番号を介した接続を許可するように、各ノードのファイアウォールの設定を忘れないでください。
全ノードの Elasticsearch サービスを停止します。
systemctl stop elasticsearch.service
設定ファイル ''/etc/elasticsearch/elasticsearch.yml'' の以下の行を編集します。
#discovery.seed_hosts: ["host1", "host2"]
#cluster.initial_master_nodes: ["host1", "host2"]
該当行を //[[:ja:documentation:pandorafms:introduction:03_glossary#パラメータのコメントアウトとアンコメント|コメントアウト]]// し、各ノードの IP アドレスまたは URL を追加します。
discovery.seed_hosts: ["host1", "host2", "host3"]
cluster.initial_master_nodes: ["host1", "host2", "host3"]
IP アドレスでの例:
discovery.seed_hosts: ["172.42.42.101", "172.42.42.102", "172.42.42.103"]
cluster.initial_master_nodes: ["172.42.42.101", "172.42.42.102", "172.42.42.103"]
''cluster.initial_master_nodes'' の行は設定ファイル内で 1回のみ定義されていることを確認してください。**場合によっては、同じ行が同じファイルの異なる 2つの場所に表示されます。**
ノードは初回に単独で(スタンドアロンで)開始されたため、サービスを開始する前にデータフォルダーの内容(デフォルトでは ''/var/lib/elasticsearch/'')を削除する必要があります。 次のコマンドを実行します。
rm -rf /var/lib/elasticsearch/*
次に、すべてのノードでサービスを開始します。 次のコマンドで開始し、実行されていることを確認します。
systemctl start elasticsearch.service && systemctl status elasticsearch.service
次のような出力を得られます。
{{ :wiki:pfms-systemctl_status_elasticsearch.service.png }}
サービスが開始されたら、3つのノードがクラスターに正しく参加していることを確認する必要があります。任意のノードで次のコマンドを実行すると、同じ応答が返されます。
curl -XGET http://127.0.0.1:9200/_cat/nodes
{{ :wiki:pfms-elasticsearch-curl-x-get-_cat-nodes.png }}
ノードがポート ''9200'' および ''9300'' を介して通信する必要があることに加えて、Pandora FMS サーバおよび Pandora FMS Web コンソールからポート ''9200'' へアクセスできる必要があることを常に考慮してファイアウォールの設定を再度確認してください。ここまでの設定により、Pandora FMS ログストレージエンジンとして使用される Elasticsearch クラスターの準備が完了です。
===== データモデルとテンプレート =====
本番環境に導入する前に、用途に応じて、単一ノードまたはデータクラスターのいずれかの環境に応じて対応する設定をあらかじめ実施することをお勧めします。 **Pandora FMS** によって生成されるインデックスの場合、それを行う最も簡単な方法は、フィールドと保存するデータの設定を定義するためのテンプレートを定義することです。
テンプレートは、インデックス作成時にのみ適用される設定です。テンプレートを変更しても、既存のインデックスには影響しません。
**基本テンプレート** を作成するには、フィールドを定義するだけです。
{
"index_patterns": ["pandorafms*"],
"settings": {
"number_of_shards": 1,
"auto_expand_replicas" : "0-1",
"number_of_replicas" : "0"
},
"mappings" : {
"properties" : {
"agent_id" : {
"type" : "long",
"fields" : {
"keyword" : {
"type" : "keyword",
"ignore_above" : 256
}
}
},
"group_id" : {
"type" : "long",
"fields" : {
"keyword" : {
"type" : "keyword",
"ignore_above" : 256
}
}
},
"group_name" : {
"type" : "text",
"fields" : {
"keyword" : {
"type" : "keyword",
"ignore_above" : 256
}
}
},
"logcontent" : {
"type" : "text",
"fields" : {
"keyword" : {
"type" : "keyword",
"ignore_above" : 256
}
}
},
"source_id" : {
"type" : "text",
"fields" : {
"keyword" : {
"type" : "keyword",
"ignore_above" : 256
}
}
},
"suid" : {
"type" : "text",
"fields" : {
"keyword" : {
"type" : "keyword",
"ignore_above" : 256
}
}
},
"type" : {
"type" : "text",
"fields" : {
"keyword" : {
"type" : "keyword",
"ignore_above" : 256
}
}
},
"utimestamp" : {
"type" : "long"
}
}
}
}
}
Pandora FMS の Elasticsearch インターフェース(**管理ツール(Admin tools)** → ** Elasticsearch インターフェース(Elasticsearch Interface)**)を介して、ネイティブの Elasticsearch コマンドを使用し、テンプレートをアップロードできます。
これらの操作は、ネイティブの ElasticsSearch コマンドを使用してPandora FMS の ElasticSearch インターフェイスから実行できます。
* **PUT _template/**: この例では ''PUT _template/pandorafms''
{{ :wiki:pfms-elasticsearch_interface_put_template.png }}
同じ Pandora FMS インターフェースを介してテンプレートを参照することもできます。
* **GET _template/**: この例では ''GET _template/pandorafms''
{{ :wiki:getinterface.png }}
==== マルチノードテンプレート ====
**マルチノードテンプレート**を定義するには、考慮しなければならないことがいくつかあります。
* テンプレート(JSON)の設定を行うときは、**ノードと同じ数の検索を設定する** ことを考慮に入れる必要がありますが、正しく設定するには、環境に実際に存在する **レプリカの数から 1を引く** 必要があります。
例えば、3つのノードを設定した Elasticsearch を Pandora FMS 環境で使用する場合、''number_of_search'' および ''number_of_replicas'' フィールドを次のように変更します。
{
"index_patterns": ["pandorafms*"],
"settings": {
"number_of_shards": 3,
"auto_expand_replicas" : "0-1",
"number_of_replicas" : "2"
},
\\ これは非常に基本的な定義です。Elasticsearch 環境のサイズを正しく定義するには、以下で説明されている要素を考慮に入れることをお勧めします。
* [[https://www.elastic.co/blog/how-many-shards-should-i-have-in-my-elasticsearch-cluster|https://www.elastic.co/blog/how-many-shards-should-i-have-in-my-elasticsearch-cluster]]
コマンドラインから以下を実行して環境のテンプレートを一覧表示できます。
curl -X GET "localhost:9200/_cat/templates/*?v=true&s=name&pretty"
テンプレートの詳細を表示することもできます。たとえば、以下を実行すると pandorafms 用に作成したテンプレートを表示できます。
curl -X GET "localhost:9200/_template/pandorafms*?pretty"
定義した設定を JSON 形式で返します。
これらの操作は、ネイティブの Elasticsearch コマンドを使用して、Pandora FMS の Elasticsearch インターフェースから実行できます。
* **PUT _template/ {json_data}**: 作成するテンプレートのデータを入力できます。
* **GET _template/**: 作成したテンプレートを表示できます。
{{ :wiki:getinterface.png }}
===== 推奨事項 =====
**Elasticsearch のログローテーション**
**重要:** Elasticsearch のログが肥大化しないように、/etc/logrotate.d でログローテーションのエントリーを作成することをお勧めします。
cat > /etc/logrotate.d/elastic <
**インデックスの削除**
ElasticSearch サーバに対して curl でアクセスすることにより、いつでも[[https://www.elastic.co/guide/en/elasticsearch/reference/current/cat-indices.html|インデックスの一覧]]と大きさを確認することができます。
curl -q http://elastic:9200/_cat/indices?
ここで、''elastic'' はサーバの IP です。
インデックスを削除するには、DELETE コマンドを実行します。
curl -q -XDELETE http://elastic:9200/{index-name}
ここで ''elastic'' はサーバの IP で、"{index-name}" は上のコマンドの出力ファイルです。これにより、削除されたインデックスによって使用されていたスペースが解放されます。
===== Pandora FMS Syslog サーバ =====
{{:wiki:icono-modulo-enterprise.png |Enterprise 版}}バージョン NG 717 以上
このコンポーネントにより、Pandora はマシンの [[https://en.wikipedia.org/wiki/Syslog|Syslog]] を分析できます。Syslog のコンテンツを分析し、ElasticSearch サーバに格納することができます。
SyslogServer の主な利点としては、ログの統合を補完することにあります。Linux および UNIX 環境の SYSLOG 出力をもとにして、SyslogServer では、1つの共通ポイント(Pandora FMS コンソールのログビューア)で、発信元ごとに個別のログを参照したり、検索したりすることができます。
Syslog のインストールは、クライアントとサーバの両方に次のコマンドで行います。
yum install rsyslog
対象のコンピューターに Syslog をインストールしたら、設定ファイル ''/etc/rsyslog.conf'' を編集して TCP および UDP 接続を有効にする必要があることに注意してください。
(...)
# Provides UDP syslog reception
$ModLoad imudp
$UDPServerRun 514
# Provides TCP syslog reception
$ModLoad imtcp
$InputTCPServerRun 514
(...)
調整を行ったら、rsyslog サービスを再起動します。
サービスが再起動したら、ポート 514 が開いているか確認します。
netstat -ltnp
rsyslog 設定に関する詳細は、[[https://www.rsyslog.com/|公式サイト]] を参照してください。
Syslog サーバにログを送信するようにクライアントを設定します。そのためには、''/etc/rsyslog.conf'' にあるクライアント rsyslog 設定ファイルにて、リモートホストの設定をする行を見つけて有効にします。
.* @@remote-host:514
ログ送信により、クライアント名を持つコンテナエージェントが生成されるため、エージェントの重複を回避するために、クライアントのホスト名と一致する "別名" を持つエージェントを作成することをお勧めします。
この機能を有効化するには、''pandora_server.conf'' で以下の設定を有効にするだけです。
# Enable (1) or disable (0) the Pandora FMS Syslog Server
# (PANDORA FMS ENTERPRISE ONLY).
syslogserver 1
# Full path to syslog's output file (PANDORA FMS ENTERPRISE ONLY).
syslog_file /var/log/messages
# Number of threads for the Syslog Server
# (PANDORA FMS ENTERPRISE ONLY).
syslog_threads 2
# Maximum number of lines queued by the Syslog Server's
# producer on each run (PANDORA FMS ENTERPRISE ONLY).
syslog_max 65535
**syslogserver**
ローカルの SYSLOG 分析エンジンの有効化(1)または無効化(0)を設定します。
**syslog_file**
SYSLOG ファイルの場所です。
**syslog_threads**
SyslogServer のデータ処理に使う最大スレッド数です。
**syslog_max**
SyslogServer が処理する最大ウインドウサイズです。一度の実行で処理する最大の SYSLOG エントリー数です。
これは SyslogServer の最大処理ウィンドウであり、一度に処理される SYSLOG エントリの最大数になります。
ElasticSearch サーバを有効化し設定する必要があります。使用方法については、前述の内容を確認してください。
ログが Pandora FMS サーバに送信されるように、デバイスの設定を変更する必要があります。
===== Elasticsearch システムへのマイグレーション =====
\\ バージョン 712 またはそれ以前。最新のバージョンにアップグレードする必要があります。詳細については、[[:ja:documentation:pandorafms:installation:02_anexo_upgrade|Pandora FMS アップグレード]] を参照してください。
ログの新たなストレージシステムを設定後、以前から Pandora に保存されているデータを新たなシステムへマイグレートできます。
新たなシステムへマイグレートするには、/usr/share/pandora_server/util/ 以下にある次のスクリプトを実行します。
# 7.0NG 712 より前のログデータを、7.0NG 712 以降にマイグレート
/usr/share/pandora_server/util/pandora_migrate_logs.pl /etc/pandora/pandora_server.conf
===== コンソールの設定 =====
ログの表示を有効化するには、次の設定を有効化する必要があります。(**セットアップ(Setup)** → **セットアップ(Setup)** → **Enterprise**)
{{ :wiki:pfms-setup-setup-enterprise-activate_log_collector.png }}
**セットアップ(Setup)** → **セットアップ(Setup)** → **ログ収集(Log Collector)** タブで、ログビューワの動作を設定できます。
{{ :wiki:pfms-setup-setup-log_collector.png }}
この画面では以下の設定ができます。
* Elasticsearch サーバの IP または FQDN アドレス
* Elasticsearch サービスのポート
* **表示されるログの数(Number of logs being shown)**:コンソール応答の高速化のため、レコードの動的読み込みが追加されています。これを利用するには、ページの一番下へスクロールします。すると、次のレコードが読み込まれます。これらのグループのサイズは、グループあたりのレコード数としてこのフィールドに設定できます。
* **削除する日数(Days to purge)**: システムのサイズを保持するために、ログ情報を保存する最大日数を定義できます。それを超えると、Pandora FMS のクリーニング処理により自動的に削除されます。
===== Elasticsearch インタフェース =====
{{wiki:icono-modulo-enterprise.png |Enterprise 版}}バージョン NG 747 以上
{{ :wiki:es_interface.png?800 }}
デフォルトの設定では、Pandora は 1日あたりのインデックスを生成します。これは、何かを検索する際のフラグメント化の役割を持ちます。検索時に Elastic がフラグメントの場所を認識できるようにします。
この検索をデフォルトで最適化するには、Elastics が検索ごとにインデックスを生成し、**Elastics ノードと同じ数の検索を環境内で設定する必要があります**。
これらの検索とレプリカは、Pandora が自動的に生成するインデックスの作成時に設定されるため、この設定を変更するには、テンプレートを使用する必要があります。
===== データバックアップとリストア =====
データスナップショット(インデックス)は、Elastichsearch の最近のバージョンにおいてデータをバックアップするために使用するメカニズムです。 これらのスナップショットを使用して、ハードウェア障害後にデータを回復したり、ノード間でデータを転送したり、ノードからめったに使用されないインデックスを削除したりすることもできます(//後者には追加の構成が必要です//)。
これらのスナップショットは、データを段階的にバックアップすることで機能します。つまり、バックアップされていない新しいデータのみをコピーし、作成済みのバックアップの信頼性と Elasticsearch の異なるバージョン間の互換性を確保します。
\\
Elasticsearch で、これらすべての機能を保証する方法は**リポジトリ**を使用することです。
リポジトリは独自のものでも、サードパーティ(AWS S3®、Google Cloud Storage®、Microsoft Azure®)で作成することもできます。いずれの場合も、Pandora FMS と組み合わせて使用する 1つまたは複数のノードの外に物理的に配置する必要があります。 **これらのスナップショットについては、ユーザ自身の責任の元での管理となります**。
詳細については、Elasticsearch の公式ドキュメントを参照してください。
* [[https://www.elastic.co/guide/en/elasticsearch/reference/current/snapshot-restore.html|https://www.elastic.co/guide/en/elasticsearch/reference/current/snapshot-restore.html]]
==== リポジトリの作成 ====
ネットワークファイルシステム([[https://en.wikipedia.org/wiki/Network_File_System|NFS]])またはその他の共有ファイルシステムは、環境内で Elasticsearch リポジトリとノードをホストするマシンから利用可能である必要があります。
[[:ja:documentation:pandorafms:technical_annexes:10_share_var_spool_directory_between_several_pandora_servers|複数のサーバ間でのディレクトリの共有]]: このNFS を使用して Elasticsearch リポジトリを提供することは控えてください。 **システムの各コンポーネントを適切に責任はユーザにあります。**
対象の NFS をインストールして設定したら、Elastisearch ノードにディレクトリを作成してマウントします。たとえば、次のように呼び出すことができます。
/mnt/pandorafms/elk_repo
ユーザー ''elasticsearch'' に権限を付与します。
chown elasticsearch: /mnt/pandorafms/elk_repo
Elasticsearch 設定ファイルでこのパスをノード(すべてのノード)のリポジトリパスとして宣言する必要があります。
path:
repo:
- /mnt/pandorafms/elk_repo
ノードを設定したら、(すべてのノードで) elasticsearch サービスを再起動する必要があります。
systemctl start elasticsearch.service && systemctl status elasticsearch.service
[[:ja:documentation:pandorafms:monitoring:09_log_monitoring#elasticsearch_インタフェース|Pandora FMS の Elasticsearch インターフェース]] とは別に、**curl** コマンドを使用して、情報を取得したり、Elastisearch ノードに要求を伝達したりすることもできます。 リポジトリを作成するには、1つまたは複数のノード(すべてのノード)でローカルに次のコマンドを実行します。
curl -X PUT "localhost:9200/_snapshot/backup_repo?pretty" -H 'Content-Type: application/json' -d'
{
"type": "fs",
"settings": {
"location": "/mnt/pandorafms/elk_repo/"
}
}
'
''9200'' 以外のポートを利用する場合は、その値を置き換えます。
ノードから次のようなメッセージが得られます。
"acknowledged" : true
これは、リポジトリが作成されたことを示します。 リポジトリのステータスを確認するには次のようにします。
curl -X POST "localhost:9200/_snapshot/my_unverified_backup/_verify?pretty"
''my_unverified_backup'' を確認するリポジトリの名前に置き換えます。 **すべてが正常に行われた場合、リポジトリが設定されているノードのリストが表示されます。**
==== データベースのスナップショット生成 ====
スナップショットを手動で取得するには、スナップショット作成 API を使用します。 スナップショット名は、一意の名前をつけるために、[[https://www.elastic.co/guide/en/elasticsearch/reference/current/api-conventions.html#api-date-math-index-names|date math]] の使用をサポートしています。
PUT _snapshot/my_repository/
''my_repository'' をリポジトリの名前に置き換え、''my_snapshot'' をスナップショットの名前に置き換えます。 **curl** を使用する場合は、エスケープ文字を使用する必要があるため、上記のコマンドは次のようになります。
PUT _snapshot/my_repository/%3Cmy_snapshot_%7Bnow%2Fd%7D%3E
サイズによっては、スナップショットの取得に時間がかかる場合があります。 デフォルトでは、スナップショット作成 API は、バックグラウンドで実行されるスナップショットプロセスのみを実行します。 スナップショットが終了するまでクライアントが待つようにするには、クエリパラメータ ''wait_for_completion'' を true に設定します。
PUT _snapshot/my_repository/my_snapshot?wait_for_completion=true
''snapshot_today'' という名前のスナップショットを実行するには、ノードの 1つで以下のように実行します。
curl -X PUT "localhost:9200/_snapshot/backup_repo/snapshot_today?wait_for_completion=true&pretty"
9200 以外のポートを利用する場合は、該当部分を置き換えます。
パラメータ ''wait_for_completion=true'' を使用すると、プロセスが終了するまで呼び出し処理が待ちのままになります(データベースのサイズによっては時間がかかる場合があります)。
完了するとすぐに、処理の概要情報が JSON 形式で返されます。これは次のようになります。
{{ :wiki:pfms-elasticsearch-curl-x-put-wait_for_completion.png }}
含めるインデックスやメタデータなど、スナップショットの実行で特定のオプションを定義することもできます。詳細については、次を参照してください。
* [[https://www.elastic.co/guide/en/elasticsearch/reference/current/create-snapshot-api.html|https://www.elastic.co/guide/en/elasticsearch/reference/current/create-snapshot-api.html]]
\\ 例:
curl -X PUT "localhost:9200/_snapshot/backup_repo/snapshot_2?wait_for_completion=true&pretty" -H 'Content-Type: application/json' -d'
{
"indices": "pandorafms*",
"metadata": {
"taken_by": "PandoraFMS admin user",
"taken_because": "backup before upgrading"
}
}
'
=== スナップショットの一覧 ===
保存されているすべてのスナップショットの一覧を取得するには、次のコマンドを実行します。
curl -X GET "localhost:9200/_snapshot/backup_repo/*?pretty"
ここで、''backup_repo'' はリポジトリ ID であり、''*'' はすべてを表します。 Elasticsearch のスナップショット検索フィルターの詳細については、次の Web サイトをご覧ください。
* [[https://www.elastic.co/guide/en/elasticsearch/reference/current/get-snapshot-api.html|https://www.elastic.co/guide/en/elasticsearch/reference/current/get-snapshot-api.html]]
=== スナップショットの削除 ===
スナップショットを削除するには、上記のコマンドにてその名前を取得してから、ノードの 1つで実行します。
curl -X DELETE "localhost:9200/_snapshot/backup_repo/snapshot_today?pretty"
==== データベーススナップショットのリストア ====
スナップショットからインデックスを復元するには、他の技術的な考慮事項とは別に、インデックスを閉じる必要があります。 詳細については、次のリンクを参照してください。
* [[https://www.elastic.co/guide/en/elasticsearch/reference/current/snapshots-restore-snapshot.html#restore-snapshot-considerations|https://www.elastic.co/guide/en/elasticsearch/reference/current/snapshots-restore-snapshot.html#restore-snapshot-considerations]]
インデックスを復元するには、次の 2つの方法のいずれかを使用する必要があります。
- 復元する前に、元のインデックスを削除
- 復元するインデックスの名前を変更
両方の場合を、リポジトリ名に ''backup_repo''、スナップショット名に ''snapshot_today'' を例として使用して以下に示します。
* **削除およびリストア**:
競合を回避する最も簡単な方法は、既存のインデックスまたはデータストリームを//復元する前に//削除することです。
\\ インデックスまたはデータストリームが誤って再作成されないように、復元操作が完了するまですべてのインデックスを一時的に停止することをお勧めします。
インデックスの削除方法:
curl -X DELETE "localhost:9200/my-index?pretty"
インデックスのリストア方法:
curl -X POST "localhost:9200/_snapshot/backup_repo/snapshot_today/_restore?pretty" -H 'Content-Type: application/json' -d'
{
"indices": "my-index,logs-my_app-default"
}
'
* **リストアの際にリネーム**この操作をする際は十分なストレージスペースがあることを確認してください。
この方法では、すでに保存されている情報と同じものを扱います。一部のシナリオでは、この処理が役立つ場合があります。たとえば、次のような場合です。
* データ取得が正常に実行されたことを確認する必要がある。 各インデックスとその名前が変更されたコピーで、同じ情報が含まれ、同じ検索結果が返されることを確認する。
* サードパーティによって実行されたデータ監査を検証する。
curl -X POST "localhost:9200/_snapshot/backup_repo/snapshot_today/_restore?pretty" -H 'Content-Type: application/json' -d'
{
"indices": "my-index,logs-my_app-default"
"rename_pattern": "(.+)",
"rename_replacement": "restored-$1"
}
'
=== ノードの完全リストア ===
すべてのインデックスを含むノード全体を復元する場合は、復元を実行する前にインデックスサービスを停止することをお勧めします。このトピックの詳細については、次を参照してください。
* [[https://www.elastic.co/guide/en/elasticsearch/reference/current/snapshots-restore-snapshot.html#restore-entire-cluster|https://www.elastic.co/guide/en/elasticsearch/reference/current/snapshots-restore-snapshot.html#restore-entire-cluster]]
===== 表示と検索 =====
ログ収集のツールに関して、私たちは主に 2つのことに興味があります。日時やデータソース、キーワードによるフィルタリングをしての情報の検索と、時間単位ごとに発生する情報の参照(**ログビューワ**)です。この例では、直近 1時間のすべてのデータソースからのログメッセージを見てみます。**Search**, **Start date** および **End date** を見てください。
{{ :wiki:logsvistanew.png?700 |拡大するにはクリックしてください}}
//時間経過による発生表示//
最も重要で便利なフィールドは、**検索** テキストボックスに入力する検索文字列と、使用可能な 3つの **検索モード** です。
**完全一致**
文字検索で、//log// は完全マッチします。
{{ :wiki:logsvistanew2.png?700 |拡大するにはクリックしてください}}
**全単語**
単一の //ログ// の行の順序に関係なく、指定された単語(各単語はスペースで区切られることに注意してください)を //すべて// 含むかを検索します
{{ :wiki:logsvistanew4.png?700 |拡大するにはクリックしてください}}
**任意の単語**
順番は関係なく、指定した単語の //いくつか// が含んでいるかを検索します。
{{ :wiki:logsvistanew5.png?800x1052 }}
フィルタされたコンテンツのコンテキストを表示するオプションがチェックされている場合、結果は、検索に関連する他のログ行に関する情報を含む状況の概要になります。
==== 表示と高度な検索 ====
{{wiki:icono-modulo-enterprise.png |Enterprise 版}}バージョン NG 727 以上
この機能により、ログエントリをグラフに変換し、 **データキャプチャテンプレート** に従って情報を整理できます。
これらのデータキャプチャテンプレートは基本的に正規表現と識別子であり、データソースを分析してグラフとして表示できます。
高度なオプションへアクセスするには、//高度なオプション(Advanced options)// をクリックします。表示形式を選択できるフォームが表示されます。
* ログエントリーの表示 (プレーンテキスト)
* ロググラフの表示
{{ :wiki:graph_log.png?800 }}
//ロググラフ表示// オプションでは、キャプチャテンプレートを選択できます。
//Apache log model// テンプレートは、デフォルトで、標準形式の Apache ログ ([[https://httpd.apache.org/docs/2.4/en/logs.html#access-log|access_log]]) をパースし、時間応答比較グラフの取得、訪問サイトと応答コードによるソートができます。
{{ :wiki:graph_log2.png?800 }}
編集ボタン{{wiki:edit_icon.png}}を押すと、選択したキャプチャテンプレートを編集できます。作成ボタン{{wiki:new_icon.png}}では、新たなキャプチャテンプレートを追加できます。
{{ :wiki:graph_log3.png }}
このフォームでは、以下を選択できます。
**キャプチャ正規表現(Capture regexp)**
データをキャプチャするための正規表現です。取得する各フィールドは、カッコでくくります。 //(キャプチャする内容)//
**フィールド(Fields)**
正規表現を介してキャプチャされる順番です。 結果は、アンダースコアの間に書かれていない名前のキーフィールドの連結によってソートされます。
key, _value_
key,key2,_value_
key1,_value_,key2
//注意:// value フィールドが指定されていない場合、自動的に一致する正規表現の数になります。
//注意 2:// 1つだけ //value// カラムが指定されている場合は、累積値(デフォルトではパフォーマンス)を表すか、チェックボックスをオンにして平均を表すかを選択できます。
//例//
以下のフォーマットのログからエントリを取得するとします。
Sep 19 12:05:01 nova systemd: Starting Session 6132 of user root.
Sep 19 12:05:01 nova systemd: Starting Session 6131 of user root.
ユーザのログイン数をカウントするには、次のようにします。
正規表現:
Starting Session \d+ of user (.*?)\.
フィールド:
username
このキャプチャテンプレートは、選択した時間間隔におけるユーザのログイン数を返します。
{{ :wiki:graph_log4.png }}
==== 頻繁に使用するフィルタ ====
バージョン 771 以降
このオプションを使用すると、頻繁に使用するフィルタ設定を保存し、そのフィルタの一覧を作成できます。 すべてのフィルタ値を設定したら、**フィルターの保存(Save filter)** をクリックし、名前を割り当てて、**保存(Save)** をクリックします。 いつでも、保存されたフィルタをドロップダウンリストから選択し、**フィルタの読み込み(Load filter)** ボタンを使用してこれらの設定を読み込むことができます。
{{ :wiki:pfms-monitoring-log_viewer-frequently_filters.png }}
==== お気に入り要素として保存されたフィルタ ====
バージョン NG 770 以降
[[:ja:documentation:pandorafms:installation:03_interface#お気に入り|お気に入り]] システムを使用すると、タイトルの星アイコンをクリックして、フィルタ設定を含む **ログビューア** へのショートカットを保存できます。
{{ :wiki:pfms-menu-operation-favorite-log_viewer.png }}
設定したフィルタリング条件をお気に入りとして保存するための名前を求められます。
{{ :wiki:pfms-favorite_objects_menu-ask_name_for_filter.png }}
**ログビューワ** フィルタ設定は、**お気に入り(Favorite)** (**操作(Operation)** メニュー) の対応するセクションに保存されます。
{{ :wiki:pfms-menu-operation-favorite-all.png }}
===== エージェント設定 =====
ログ収集は、Windows および Unux (LInux®, MacOS X®, Solaris®, HP-UX®, AIX®, BSD® など) エージェント双方で実行されます。Windows エージェントの場合、イベントビューワモジュールで同様のフィルタを用いることにより、Windows イベントビューワから情報を取得することもできます。
Windows と Unix でのログ情報収集の例をみてみます。
==== Windows の場合 ====
バージョン 750 以降、このアクションは、詳細オプションを有効化することにより、エージェントプラグインを介して実行できます。
以下に示すタイプの処理を実行できるようになります。
**Logchannel module**
module_begin
module_name MyEvent
module_type log
module_logchannel
module_source
module_eventtype
module_eventcode
module_pattern
module_description
module_end
**Logevent module**
module_begin
module_name Eventlog_System
module_type log
module_logevent
module_source System
module_end
**Regexp module**
module_begin
module_name PandoraAgent_log
module_type log
module_regexp C:\archivos de programa\pandora_agent\pandora_agent.log
module_description This module will return all lines from the specified logfile
module_pattern .*
module_end
ログタイプモジュールの詳細説明については、次の章で確認できます。[[ja:documentation:pandorafms:installation:05_configuration_agents|特定のディレクティブ]]
module_type log
この種のタグ module_type logを 定義すると、データベースには保存されませんが、ログコレクターに送信されていることを示します。このタイプのデータを持つモジュールは、有効になっている場合はコレクターに送信され、有効になっていない場合は情報が破棄されます。
**注意**: この書式は、バージョン 5.0 以上で有効です。Enterprise 版をアップデートした状態にしているか確認してください。
==== Unix システム ====
エージェントバージョン 5.0 では、次の書式を使います。
module_plugin grep_log_module /var/log/messages Syslog \.\*
ログパースプラグイン(grep_log)と同じように、grep_log_module プラグインは、処理した情報をログファイルのソースとして "syslog" という名前でログ収集に送信します。どういったパターンの行を送信するかまたはしないかは、\.\* といった正規表現を利用します(この例では全て)。
===== エージェント表示でのログソース =====
Pandora FMS バージョン 749 以降、**ログソース状態** と呼ばれるボックスがエージェント表示に追加され、そのエージェントによる最後のログ更新の日付が表示されます。虫眼鏡のアイコンをクリックすると、そのログにフィルタした**[[:ja:documentation:pandorafms:command_center:05_visualization#ログビューワ|ログビューワ]]**表示にリダイレクトされます。
{{ :wiki:agent_view_log.png?800 }}
[[ja:documentation:start|Pandora FMS ドキュメント一覧に戻る]]