サーバとコンソールの設定

Pandora FMS ドキュメント一覧に戻る

Pandora FMS には、基本的なコンポーネントがあり、それぞれ正しく動作させるためには設定が必要です。

• ウェブコンソール
• Pandora FMS サーバ
• データベース

このトピックでは、3 つの要素すべての設定ファイルと他の重要な要素について説明します。

Pandora FMS サーバの主な設定は、デフォルト パス /etc/pandora の pandora_server.conf ファイルにあります。

Pandora FMS の設定ファイルは、UNIX の基本的なプレーンテキストファイルになっています。# が先頭にある行は、使われていない設定やコメントです。Windows で設定を編集する場合は、このフォーマットに対応するエディタを利用してください。UTF-8 以外を扱う場合は、Pandora FMS リモートコンフィグのエンコーディング変更(Change remote config encoding) パラメータを有効にしてください。全設定パラメータは以下に示します。

コンソールに表示される Pandora FMS のサーバ名を設定します。デフォルトではコメントアウトされており、ホスト名が使われます。

XML データを受け取るディレクトリを設定します。デフォルトは、/var/spool/pandora/data_in / です。ここに RAM ディスクや高速なハードディスクを用いることにより、Pandora FMS のパフォーマンスを向上できます。

Pandora FMS サーバのログファイルを設定します。デフォルトは、/var/log/pandora/pandora_server.log です。

SNMP コンソール ログはデフォルトで以下にあります。

  /var/log/pandora/pandora_snmptrap.log

Pandora FMS のエラーログを設定します。デフォルトは、/var/log/pandora/pandora_server.error です。

Pandora サーバをデーモンとして動作させるかどうかです。

--D

オプション付きでサーバを起動すると、デーモンとして実行されます。

常に 'Mysql' です。(デフォルト値、 MySQL は Pandora FMS のデータベースソフトウエアです)。

接続するデータベース名です。デフォルトの値は 'pandora' です。

Pandora データベースに接続するユーザを設定します。デフォルトは、pandora です。

Pandora FMS データベースに接続する時のパスワードを設定します。

Pandora FMS データベースが動作するホストの IPアドレスかまたはホスト名を設定します。サーバと同一のホストにデータベースをインストールした場合は、127.0.0.1 です。

(オプション) データベースの接続ポートを指定する場合に利用します。コメントアウトされている場合は、デフォルトで 3306 が設定されます。

Pandora サーバをデーモンで動作させるかどうかを指定します。-D オプションを付けてサーバを起動した場合も、デーモンとして実行されます。

サーバログの詳細レベルです。設定可能範囲は 0(オフ) から 10(詳細レベル最大) です。10に設定すると、モジュール、プラグイン、アラートを含め、サーバが実行するすべてのログを表示します。

マスターサーバの優先順位です。稼働しているサーバで最も値(正の整数です)の大きいものがマスターになります。同じ値の場合はランダムです。0 に設定した場合は、そのサーバはマスターにはなりません。より詳細は、冗長化構成(HA)の章を参照してください。

SNMP トラップコンソールを有効にする場合は 1 に設定します。無効にする場合は 0 を設定します。SNMP コンソールは、UNIX のsnmptrapd に依存していますが、サービスは Pandora とともに起動・停止されます。Pandora を起動する前に、システム上に snmptrapd プロセスが起動していないことを確認してください。

SNMP コンソールのスレッド数です。それぞれのスレッドが SNMP トラップを処理します。デフォルトは '1' です。

1 に設定すると、同一発信元からのトラップは平行処理されません。デフォルトは 0 です。

1 に設定すると、SNMP コンソールは SNMP トラップ処理で変数バインディングの変換を試みます。デフォルトは '0' です。

1 に設定すると、SNMP コンソールは SNMP トラップ処理で enterprise 文字列の変換を試みます。デフォルトは '1' です。

有効化(1)している場合、snmptrapd は “authenticationFailure” トラップを無視します。デフォルトの値は 1 です。

有効化(1)している場合、snmptrapd はエージェントのアドレスの代わりに pdu アドレスを読み込みます。デフォルトの値は 0 です。

snmp_trapd バイナリのパスです。manual に設定すると、サーバは snmp_trapd を起動しません。デフォルトの値は manual です。

snmp_forward_ip で指定されたホストへの SNMP trap 転送を有効化(1) または無効化 (0) します。

SNMP トラップの転送先ホストの IP アドレスです。

SNMP トラップ転送で利用する SNMP バージョンです。このトークンでは以下の値が指定できます。

• 1
• 2c
• 3

SNMP バージョン 3 用です。認証セキュリティ名を定義します。より詳細は、snmpcmd のマニュアルページ を参照してください。

SNMP バージョン 3 用です。認証(セキュリティ)エンジン ID を定義します。より詳細は、snmpcmd のマニュアルページ を参照してください。

SNMP バージョン 3 用です。認証プロトコルを定義します。このトークンには、以下の値を指定できます。

• MD5
• SHA

より詳細は、snmpcmd のマニュアルページ を参照してください。

SNMP バージョン 3 用です。認証パスワードを定義します。より詳細は、snmpcmd のマニュアルページ を参照してください。

SNMP バージョン 3 用です。暗号化プロトコルを定義します。このトークンでは以下の値を設定できます。

• DES
• AES

より詳細は、snmpcmd のマニュアルページ を参照してください。

SNMP バージョン 3 用です。暗号化パスフレーズを定義します。より詳細は、snmpcmd のマニュアルページ を参照してください。

SNMP バージョン 3 用です。セキュリティレベルを定義します。このトークンには以下の値を設定できます。

• noAuthNoPriv
• authNoPriv
• authPriv

SNMP コミュニティ を定義します。(public, private, など)

Pandora FMS ネットワークサーバを有効にする場合は 1 に設定します。無効にする場合は 0 に設定します。

Pandora FMS データサーバを有効にする場合は 1 に設定します。無効にする場合は 0 に設定します。

# Enable (1) or disable (0) the Data Server smart queue, which gives priority
# to new data coming from agents at the expense of buffered XML files.
dataserver_smart_queue 1

有効化(1)すると、サーバは、各エージェントから届く古いデータよりも新しいデータを優先します。(LIFO モード)

Pandora FMS 自動検出サーバを有効にする場合は 1 に設定します。無効にする場合は 0 に設定します。

Pandora FMS プラグインサーバを有効にする場合は 1 に設定します。無効にする場合は 0 に設定します。

タイムアウトを制御しプラグインを実行するプログラムの絶対パスの設定です。デフォルトは、/usr/bin/timeout です。利用しているシステムにこのコマンドが無い場合は、代りに Pandora FMS に含まれる /usr/bin/pandora_exec を利用してください。

Pandora FMS 予測サーバを有効にする場合は 1 に設定します。無効にする場合は 0 に設定します。

Pandora FMS WMI サーバを有効にする場合は 1 に設定します。無効にする場合は 0 に設定します。

# WMI client binary (wmic by default).
#wmi_client pandorawmic

wmic のフルパスです。デフォルトは /usr/bin/pandorawmic です。

# Sync Server
#syncserver

Pandora FMS の同期サーバを有効にするには 1、無効にする場合は 0 に設定します。

ICMP 監視のタイムアウト(秒単位)です。デフォルトの値は 2 です。WAN の監視をする場合は、いくつかの監視でより多くの時間が必要となるため、誤検出を避けるためにこの値を増やすことをお勧めします。

サーバダウンと認識する時間を秒で設定します。各サーバは、サーバの状態をチェックしており、最新の更新よりここに指定した時間を経過すると、ダウンしているものと認識されます。これは、複数のサーバーがある場合の 高可用性 (HA) の仕組みに影響します。

通常は '0' ですが、Pandora FMS Server をデバッグしたい場合に '1' にすると、以下のファイルにサーバの状態がスレッドごとに定期的に書き出されます。

/tmp/<サーバ名>.<サーバタイプ>.<スレッド番号>.log

例:

 [root_pandorafms]# cat /tmp/pandorafms.*
 2017-12-05 09:44:19 pandorafms dataserver (thread 2):[[CONSUMER|]] Waiting for data.
 2017-12-05 09:44:39 pandorafms dataserver (thread 3):[[PRODUCER|]] Queuing tasks.
 2017-12-05 09:44:40 pandorafms eventserver (thread 21):[[CONSUMER|]] Waiting for data.
 2017-12-05 09:44:40 pandorafms eventserver (thread 22):[[PRODUCER|]] Queuing tasks.
 2017-12-05 09:44:14 pandorafms inventoryserver (thread 17):[[CONSUMER|]] Waiting for data.
 2017-12-05 09:44:39 pandorafms inventoryserver (thread 18):[[PRODUCER|]] Queuing tasks.
 2017-12-05 09:44:14 pandorafms networkserver (thread 4):[[CONSUMER|]] Waiting for data.
 2017-12-05 09:44:14 pandorafms networkserver (thread 5):[[CONSUMER|]] Waiting for data.
 2017-12-05 09:44:14 pandorafms networkserver (thread 6):[[CONSUMER|]] Waiting for data.
 2017-12-05 09:44:14 pandorafms networkserver (thread 7):[[CONSUMER|]] Waiting for data.
 2017-12-05 09:44:39 pandorafms networkserver (thread 8):[[PRODUCER|]] Queuing tasks.
 2017-12-05 09:44:14 pandorafms pluginserver (thread 13):[[CONSUMER|]] Waiting for data.
 2017-12-05 09:44:39 pandorafms pluginserver (thread 14):[[PRODUCER|]] Queuing tasks.
 2017-12-05 09:44:14 pandorafms predictionserver (thread 15):[[CONSUMER|]] Waiting for data.
 2017-12-05 09:44:39 pandorafms predictionserver (thread 16):[[PRODUCER|]] Queuing tasks.
 2017-12-05 09:44:39 pandorafms reconserver (thread 10):[[PRODUCER|]] Queuing tasks.
 2017-12-05 09:44:14 pandorafms reconserver (thread 9):[[CONSUMER|]] Waiting for data.
 2017-12-05 09:44:15 pandorafms webserver (thread 19):[[CONSUMER|]] Waiting for data.
 2017-12-05 09:44:40 pandorafms webserver (thread 20):[[PRODUCER|]] Queuing tasks.
 2017-12-05 09:44:14 pandorafms wmiserver (thread 11):[[CONSUMER|]] Waiting for data.
 2017-12-05 09:44:39 pandorafms wmiserver (thread 12):[[PRODUCER|]] Queuing tasks.

メインループの実行間隔を秒で設定します。デフォルト値は 5秒です。

この値は、server_thread および max_queue_files パラメータとともに、サーバのパフォーマンス調整に使います。

ネットワークサーバのスレッド数を設定します。これは、同時にいくつのチェックを実行するかを意味します。数値を増やすと、その分の処理能力が必要になります。20以上のスレッドでは、多くの CPU およびコアが必要です。

icmp_proc モジュールにおいて、ping を実行する数を設定します。モジュールの状態を正しく認識するためには、少なくとも 1 を設定する必要があります。デフォルト値は 1 です。大きい値に設定し初回の ping が ok であれば、以降はスキップされます。

1回の ping 実行の中で何回パケットを投げるかを設定する icmp_packets パラメータと混同しないようにしてください。icmp_checks は、何回 ping を実行するかの回数を指定します。

一度の ping 要求で送信する ICMP パケットの数を定義します。デフォルトは 1です。

TCP の接続リトライ数を設定します。デフォルト値は 1です。

TCP 接続のタイムアウト値を設定します。デフォルト値は 30 です。

SNMP 接続のリトライ数を設定します。デフォルト値は 1 です。

SNMP 接続のタイムアウト値を設定します。デフォルトは 3 です。

通常、(proc) などの SNMP ブーリアンデータの取得に失敗した場合や、NULL が返ってきた場合は、該当モジュールはダウンと認識しますが、このパラメータを 0 に設定することによりそれを無視します。

サーバで実行するプラグインのスレッド数を設定します。同時にいくつのチェックを実行するかを示します。

プラグインのタイムアウト値です。この時間を超えると、モジュールは不明状態になります。デフォルトは 5 です。プラグインの実行に数秒かかるような場合は、この値を大きくする必要があります。

WMI のタイムアウトを設定します。ここで設定した時間を越えると、モジュールは不明状態になります。デフォルトは 10 です。

WMI サーバ のスレッド数を設定します。同時にいくつのチェックを実行するかを示します。

自動検出サーバ のスレッド数を設定します。同時にいくつのチェックを実行するかを示します。

データサーバのスレッド数を指定します。同時にいくつの XML ファイルの処理を実行するかを示します。データサーバ に特有のルールとして、マシンの物理プロセッサーよりも多くのスレッドが使用されるべきではありません。

メールサーバ (MTA) の IP アドレスを設定します。

nslookup -type = mx my.domain

メールサーバのポート番号を設定します。

メールサーバのユーザを設定します。(認証に必要な場合)

メールサーバのパスワードを設定します。(認証に必要な場合)

メールサーバの認証の仕組みを設定します。設定可能な値は、LOGIN PLAIN CRAM_MD5 DIGEST-MD です。(必要な場合)

メールの発信元アドレスを設定します。デフォルトは、pandora@localhost です。

デフォルトは 1です。1 に設定すると、メールは宛先毎に別便で送信されます。 0 に設定すると、すべての宛先を含む形で1通のメールを送信します。

# Encoding to use on mail subject (MIME-Header by default)
# mail_subject_encoding MIME-Header-ISO_2022_JP

デフォルトでは無効になっています。 コンソール言語が日本語で、サーバの $LANG が ja_jp.UTF-8 の場合、この高度なトークンにより、電子メールアラートのマクロに対してその言語での正しい文字エンコーディングが有効になります。

SMTP 接続の暗号化タイプです。(none, ssl, starttls)

これを定義すると、自動検出処理でのエージェント検出時にオペレーティングシステム情報検出に利用されます。デフォルトは、/usr/bin/xprobe2 です。

自動検出サーバに必要なプログラムの指定で、デフォルトは、/usr/bin/nmap です。

ICMP サーバに必要なプログラムの指定で、デフォルトは、/usr/sbin/fping です。

1 から 5 の間で nmap がどの程度アグレッシブに動作するかを指定します。1 はゆっくりですが信頼性があります。5は早いですが信頼性は低くなります。デフォルトは 2です。

nmap_timing_template と同じですが、サテライトサーバおよび自動検出サーバのネットワークスキャンが対象となります。

SNMP のチェックに必要なプログラムの指定で、デフォルトは、/usr/bin/snmpget です。snmp の標準クライアントの場所を設定します。Windows の場合はバイナリが提供されます。

Enterprise SNMP サーバが必要とする braa バイナリの場所を設定します。(/usr/bin/braa がデフォルトです)

モジュールがエラーだった場合に、braa にてモジュールを処理する前に、通常のネットワークサーバでリトライする回数を指定します。

Enterprise SNMP サーバが SNMPv3 リクエストで利用する pandorafsnmp バイナリのパスです。(/usr/bin/pandorafsnmp がデフォルトです)

データファイル受信により新たなエージェントが作られた場合のデフォルトグループの設定です。ここでのグループの定義が無い場合は、エージェントは XML に含まれるグループで作成されます。

データファイルの受信を通じてデータサーバで作成された、新しいエージェントのデフォルトグループの名前。ここでグループを定義しない場合、エージェントは XML に含むグループに作成されます。

# Works like autocreate_group, except the name of the group is specified (instead of its id). Do not set both.
#autocreate_group_name Unknown

autocreate_group のように動作しますが、グループの名前を指定します(ID ではない)。両方を設定しないでください。

1 に設定すると、新規エージェントは autocreate_group で指定されたグループに追加されます。(エージェントにより指定されたグループは、フォールバックとして利用されます)

0 に設定すると、新規エージェントはエージェントによって指定されたグループに追加されます。(autocreate_group により指定されたグループは、フォールバックとして利用されます)

例えば、次の設定の場合、可能な場合は XML データファイル内で指定されたグループに、そうでない場合は ID 10 のグループに新しいエージェントが所属します。

 autocreate_group 10
 autocreate_group_force 0

この値を 1 に設定すると、システムに存在しないエージェントから XML ファイルを受信したときに、そのエージェントを自動作成します。

Pandora FMS のログファイルの最大サイズをバイトで設定します。設定されたサイズに達すると、既存のファイルは pandora_server.log.old にリネームされ、新たなログファイル pandora_server.log が作成されます。デフォルトは、65536 バイトです。

入力ディレクトリで指定したディレクトリから　Pandora FMS データサーバが読み込む、XML ファイルの最大数です。これにより、データサーバが多くのファイルを読み込みサーバのパフォーマンスに影響を与えることを避けることができます。デフォルト値は 5000 です。

デフォルトは有効(1)で、日時(タイムスタンプ)に XML 内 (.data) で定義されたものを利用します。つまり、タイプスタンプは、エージェントで生成されたものを利用します。

無効化(0)すると、XML ファイルのタイムスタンプ、つまり サーバのタイムスタンプ を利用します。これは、エージェントによって生成された日付を 全体的に 使用することを無効にし、すべてのデータ参照の際にサーバの日時を使用したい場合に便利です。タイムスタンプは、Pandora サーバが XML を受信したタイミングになります。

デフォルトでは 0 で、無効になっています。有効化すると(秒単位の値)、サーバは N秒ごとに内部的に再起動します(1日 = 86400)。このオプションは、一部のスレッドまたは特定の Pandora FMS サーバの制御不能な障害が原因の問題が見られる場合に役立ちます。

デフォルトは 0 です。1 に設定すると、サーバにクリティカルなエラーが発生した場合に、設定した秒数後にサーバを再起動します。

デフォルトは 60 です。restart が有効に設定されているときに、サーバにクリティカルなエラーが発生したあとに再起動するまでの秒数を設定します。

GIS サーバ機能を有効化(1)または無効化(0)します。

2つの GIS 位置情報を同一の位置と見なすマージン(メートル)です。

自動検出における逆ジオロケーションファイルです。これは、MaxMind GPL GeoLiteCity.dat フォーマットを用いた、逆ジオロケーション情報データベースファイルです。設定ファイルでこれが有効な場合は、自動検出およびソフトウエアエージェントを用いた場合のエージェント作成時の IP によるジオロケーションは無効化されます。ジオロケーションは、GIS 機能が全体で無効化されている場合(activate_gis の設定)は動作しません。

自動検出タスクで見つかったエージェントをランダムに配置する範囲の半径(メートル)です。円の中心は、IP の位置情報検出によって決まります。

サーバには、セルフモニタリングフラグがあります。これは、サーバ内に Pandora FMS サーバの重要なパラメータをモニタリングする仮想エージェントを作成します。これを有効化するには、self_monitoring を 1 に設定する必要がります。

self_monitoring の時間間隔を秒単位で指定します。デフォルトは 300秒です。

XML で親の名前を送信してエージェントが親を更新できるかどうかを定義します。パラメータが設定されていないか 0 である場合はエージェント情報は無視されます。そうでない場合、サーバーが parent_name 属性を持つ XML を受信すると、サーバーはこの名前のエージェントを検索し、見つかった場合は XML エージェントの親を更新します。

デフォルトで利用する wmi クライアントです。

GPS 座標をテキストの位置情報に変換します(逆ジオロケーション)。これには、Google マップの API を使います。この機能を使えるようにするためには、インターネットアクセスが必要です。また、Pandora FMS サーバから Google API への接続速度により GIS 情報処理のパフォーマンスに影響します。

GPS 座標をテキストの位置情報に変換します(逆ジオロケーション)。これには、OpenStreetMap の API を使います。このサービスは Google マップほど正確ではありませんが無料です。また、コードの修正によりローカルサーバーに接続するように変更できるという利点もあります。

ウェブのチェック(Goliat サーバ)を有効にする場合は 1 に設定します。無効にする場合は 0 に設定します。Web ユーザエクスペリエンス（WUX）監視サーバとは関係ありません。

ウェブテストサーバ(Goliat)のスレッド数を設定します。このコンポーネントにいくつのスレッドを割り当てるかを示します。

ウェブ監視モジュール(Goliat)のデフォルトタイムアウトを秒単位で指定します。

バージョン 747 以降では、デフォルトで curl が利用されます。このパラメータを “LWP” にすると、ウェブ監視に curl の代わりに Perl の WWW ライブラリ(LWP) が利用されます。

Pandora FMS リモートインベントリサーバを有効にする場合は 1 に設定します。無効にする場合は 0 に設定します。 インベントリデータがエージェントからデータサーバに送信される場合は、リモートインベントリサーバを有効にする必要はありません。

リモートインベントリサーバのスレッド数を設定します。

Pandora FMS エクスポートサーバを有効にする場合は 1 に設定します。無効にする場合は 0 に設定します。

エクスポートサーバのスレッド数を設定します。このコンポーネントにいくつのスレッドを割り当てるかを示します。

1 にするとイベント相関サーバを有効にします。0 で無効です。(デフォルトは 1 です) correlationserver も参照してください。

イベントサーバがイベントを探す時間範囲(秒)です。例えば、3600 に設定すると、イベントサーバは最新の 1時間以内に生成されたイベントをチェックします。時間範囲が長いルールがある場合は、この値を変更する必要があります。 非常に大きな値を設定すると、システムのパフォーマンスが低下し、操作に必要なリソース（CPU、RAM）が増えます。

1 に設定すると、最後に生成されたイベントが '処理中(in progress)' の場合、(復旧するまで)アラートが実行されません。デフォルトは 0 です。

Enterprise ICMP サーバを有効(1)または無効(0)にします。

ICMP Enterprise サーバのスレッド数を設定します。(3がデフォルトです)

Pandora FMS SNMP サーバを有効(1)または無効(0)にします。

Enterprise SNMP サーバのスレッド数を設定します。(3がデフォルトです)

Pandora FMS トランザクションサーバを有効(1)または無効(0)にします。

デフォルトは 1です。このパラメータは単なるトランザクションの有無であり、値の変更によってトランザクションサーバの動作が変更されることはありません。

トランザクションサーバがトランザクションにかける最大の秒数。

予測サーバのスレッド数を設定します。

producer/consumer サーバのブロックサイズの指定で、1ブロックあたりのモジュール数の設定です(15がデフォルトです)。これは、Enterprise SNMP および ICMP サーバによってどの程度の要求が処理されるかに影響します。

有効化(1)すると、XML データファイルはキューではなくスタックで処理され、古いデータ(モジュールの現在のタイムスタンプよりも古いタイムスタンプを持つデータ)は、イベントやアラートを発報しません。デフォルトの値は 0 です。

有効化(1)すると、サーバはポリシーキューを確認します。デフォルトの値は 1 です。

有効化(1)した場合、同一モジュールで新たなイベントが発生すると以前のイベントを自動承諾します。デフォルトの値は 1 です。

この設定により、Pandora FMS が生成するイベントを CSV フォーマットのテキストファイルに落とすことができます。このオプションを有効化すると、Pandora FMS のパフォーマンスが低下します。

例:

event_file /var/log/pandora/pandora_events.txt

# Set the maximum number of traps that will be processed
# from a single source in a configured time interval.
snmp_storm_protection 25

Pandora FMS の SNMP コンソールは、指定した時間間隔内では、ここで指定した数以上の同一発信元からのトラップを処理しません。この数に達した場合はイベントが生成されます。

# Silenced time period in seconds, when trap storm is detected
snmp_storm_silence_period 300

このパラメータで、SNMPトラップストームの検出における静観時間(秒単位)を設定します。デフォルトは 300 です。

snmp_storm_protection の時間間隔を秒単位で指定します。

例えば、同一発信元からのトラップを 10分で 1000件までに制限する場合は次の通りです。

 snmp_storm_protection 1000
 snmp_storm_timeout 600

モジュールが正常状態になったときに生成されるイベントのテキスト。_module_ および _data_ マクロをサポートしています。

モジュールが障害状態になったときに生成されるイベントのテキスト。_module_ および _data_ マクロをサポートしています。

モジュールが正常状態から警告状態になったときに生成されるイベントのテキスト。_module_ および _data_ マクロをサポートしています。

モジュールが障害状態から警告状態になったときに生成されるイベントのテキスト。_module_ および _data_ マクロをサポートしています。

モジュールが不明状態になったときに生成されるイベントのテキスト。_module_ および _data_ マクロをサポートしています。

これに指定した時間(秒)より古いイベントが自動承諾されます。0 に設定するとこの機能は無効になります。

例えば、生成後 10時間たった時点でイベントを自動承諾するには次のようにします。

event_expiry_time 36000

このパラメータは、event_expiry_time の影響を軽減するために利用します。イベントテーブル全体の検索をしなくなります。指定した期間(秒)の最近のイベントのみが自動的に承諾されます。この値は、event_expiry_time より大きい値である必要があります。

デフォルト値は、1日です。

event_expiry_window 86400

1 に設定すると、データベースメンテナンススクリプト (pandora_db) 実行時に、ネットワークサーバで実行される SNMP モジュールが、Enterprise SNMP サーバへ渡されます。

1 に設定すると、非同期モジュールがその実行間隔の 2倍の時間データを受信しなかったら正常状態になります。0 に設定するとその動作が無効にになります。

コンソールの API の URL です。通常は /include/api.php で終わりるものです。

コンソール API のパスワードです。パスワードは全体の設定セクションにあります。空の設定もできます。

要求されたアクションを実行する権限を持ったコンソールのユーザです。モジュールグラフイメージをアラートメールに挿入することができる必要があります。

コンソールの API ユーザのパスワードです。

暗号化パスワードの鍵を生成するために利用する暗号化フレーズです。デフォルトではコメントアウトされています。

有効化(1)すると、不明 状態のモジュールイベントが有効になります。デフォルトは 1 です。

モジュールが不明状態になるまでの時間間隔(モジュール実行間隔の倍数)。デフォルトでは、モジュール実行間隔の 2倍です。

アラートの最大処理時間を秒単位で定義します。この時間を超えると実行が中断されます。デフォルトでは 15秒です。この値を 0 に設定すると、Pandora サーバはアラートの実行を中断しません。

このパラメータで、コンソールの管理画面からリモートでのサーバの設定可否を設定します。0 で無効化、1 で有効化です(変更後は Pandora FMS サーバを再起動する必要があります)。Tentacle によって、ソフトウエアエージェントのリモート設定のように動きます。

リモート設定ファイルを送信する IP アドレスです。デフォルトでは localhost です。

リモート設定のための tentacle ポートです。デフォルトは 41121 です。

Tentacle サーバ の ウォッチドッグ を有効化または無効化します。デフォルトは 1 (有効化) で、0 で無効化されます。Pandora FMS サーバの手動起動/停止 も合わせて参照してください。

# Enable (1) or disable (0) the Tentacle Server watchdog (enabled by default).
tentacle_service_watchdog 1

拡張設定のための tentacle クライアントに与える追加パラメータです。“ ” でくくる必要があります。(例: “-v-r 5”)

サーバ起動後から指定した秒数の間、モジュールの状態変化イベントを発生させないようにし、かつモジュールアラートを実行しないようにします。

サーバ起動後から指定した秒数の間、モジュールが不明状態にならないようにします。

XML parser 用の追加の .enc ファイルを置くディレクトリです。ここにあるファイルは、起動時にデータサーバによって自動的に読み込まれます。

動的間隔の間に動的しきい値を何回再計算するかです。

動的な警告しきい値の計算に利用される障害間隔の長さに対するパーセンテージです。値が小さいと、障害と警告のしきい値は近くなります。

変わらないデータに対するモジュールの標準偏差を調整するために使用されるモジュールの平均に対する割合。大きい値にすると、動的しきい値の間隔が広くなります。

デフォルトは 0です。1に設定すると、不明モジュールが不明になった時一度だけでなく定期的に更新されます。不明モジュールに関連付けられたアラートも定期的に評価されます。

ウェブユーザエクスペリエンス分析(WUX)サーバを有効化します。wux_host および wux_port の設定が必要です。

Pandora ウェブロボットデーモンサービス(PWRD)を動かすサーバの IP アドレス/FQDN を指定します。

Pandora ウェブロボットデーモンサービス(PWRD)のポート番号を指定します。デフォルトは 4444 です。

宛先 Web アドレスと Selenium サーバに接続するための最大時間。デフォルトでは、値 15 がコメントアウトされた状態です。

最大 WUX トランザクション時間。デフォルト値は、30 です。

# Force closing previous sessions on remote wux_host,
# only for Selenium Grid server 3.
#clean_wux_sessions 1

このパラメータを有効化(1)すると、Pandora FMS サーバを起動するたびにキューに入る可能性のある WUX セッションをクリアできます。(Selenium 3 のみ)

'1' で Pandora FMS Syslog サーバを有効化します。'0' で無効化します。

syslog 出力ファイルのフルパスです。例:

syslog_file /var/log/messages

Syslog サーバのスレッド数です。

Syslog サーバが一度に読むファイルの最大行数です。

同期サーバの通信ポートです。デフォルトでは、値 41121 でコメントアウトされています。

同期サーバの SSI 通信設定のための認証局証明書のパスです。デフォルトでは、/home/cacert.pem でコメントアウトされています。

同期サーバの SSI 通信設定のためのサーバ証明書のパスです。デフォルトでは、/home/tentaclecert.pem でコメントアウトされています。

同期サーバの SSI 通信設定のための秘密鍵のパスです。デフォルトでは、/home/tentaclekey.pem でコメントアウトされています。

同期サーバの接続試行回数です。デフォルトでは、値 3 でコメントアウトされています。

同期サーバの接続最大タイムアウトです。デフォルトでは、値 10 でコメントアウトされています。

同期サーバ用の Tentacle サーバのアドレスです。

秒単位の Pandora FMS HA データベースツールの実行間隔。デフォルトでは 30 の記載でコメントアウトされています。

秒単位の Pandora FMS HA データベースツールの監視間隔。デフォルトでは 60 の記載でコメントアウトされています。

1 にすると Pandora FMS プロビジョニングサーバ(メタコンソール) を有効化します。0 で無効です。

Pandora FMS プロビジョニングサーバ(メタコンソール)のスレッド数です。

プロビジョニングサーバ(メタコンソール)のキャッシュリフレッシュ間隔を秒(デフォルトは 500)で指定します。キャッシュは、設定済の全 Pandora FMS ノードを含みます。

リモート実行モジュールを実行するスクリプト ssh_launcher.sh への絶対パスを示します。スクリプトのデフォルトのパスは次のとおりです。

/usr/share/pandora_server/util/ssh_launcher.sh

秒単位でのリモート実行モジュールの最大実行時間です。デフォルトは 10 です。

リモート実行モジュールのタイムアウト処理を実行するファイルへの絶対パスを示します。 これは、ssh_launcher の使用、Windows から Linux への plink による接続、および Windows システムへの接続でのみ有効です。

• Windows 版 Pandora FMS でのデフォルト実行パスは次の通りです。

C:\PandoraFMS\Pandora_Server\bin\pandora_exec.exe

• Linux 版 Pandora FMS でのデフォルト実行パスは次の通りです。

/usr/bin/timeout

Pandora FMS バージョン 7 から、カスタムインストールでは、“user” トークン “group” トークンの両方を定義して、ポリシーや一括操作、または “/var/spool/pandora/data_in/conf” にあるエージェントの .conf に関連するものなど、コンソールファイルで変更を行うファイルのユーザとグループを設定することができます。

# Enable (1) or disable (0) Pandora FMS Alert Server.
alertserver 0

Pandora FMS アラートサーバ を有効化(1) または無効化(0) します。デフォルトは 0 です。

# Pandora FMS Alert Server threads.
alertserver_threads 4

Pandora FMS アラートサーバ スレッドです。デフォルトは、4 です。

# Generate an hourly warning event if alert execution is
# being delayed more than alertserver_warn seconds.
alertserver_warn 180

アラートの実行が alertserver_warn 秒を超えて遅延している場合は、1時間ごとの警告イベントを生成します。 デフォルトは 180秒です。

# If set to 1, alerts are queued for the Pandora FMS Alert Server. If alertserver is set to 1, alerts are always queued.
alertserver_queue 1

このトークンを使用すると、(少なくとも) 1 つ以上の PFMS 上で稼働環境にインストールされているアラートサーバで、alertserver を持たない他の PFMS サーバ (ノード) からのアラートを設定し、キューに入れることができます。

dbssl 0

データベース接続における SSL の有効化(1)または無効化(0)をします。デフォルト値は 0 です。

# dbsslcafile

信頼できるSSL certificate authorities のリストが含まれる PEM フォーマットファイルへのパスです。デフォルトではコメントアウトされています。有効化するには、コメントを外し、ファイルのパスを設定します。

# dbsslcapath

PEM フォーマットで信頼できる SSL 証明書 authority certificates が含まれる ディレクトリやフォルダ のパスです。デフォルトではコメントアウトされています。有効化するには、コメントを外し、ディレクトリのパスを設定します。

verify_mysql_ssl_cert 0

1 に設定されている場合、MySQL 接続 (SSL 証明書の CN) で検証を行い、それらが一致しない場合は接続しません。 デフォルト値は 0 です。

# Pandora FMS HA MySQL cluster splitbrain auto-recovery (PANDORA FMS ENTERPRISE ONLY)
# IMPORTANT! Please understand and configure all settings from pandora_console/index.php?
sec=gservers&sec2=enterprise/godmode/servers/HA_cluster&tab=setup
# before enable this feature.
#splitbrain_autofix 0

これは、両方のノードがメインまたは マスター として動作する スプリットブレーン、が発生した pandora_ha 環境を自動的に復旧できるようにするパラメータ ( 1 で有効) です。

サーバ(サーバ) → データベースHA管理(Manage database HA) → セットアップ(Setup) の全値を理解し設定する必要があります:

# Pandora FMS HA MySQL cluster splitbrain auto-recovery settings (PANDORA FMS ENTERPRISE ONLY)
# Maximum number of retries
#ha_max_splitbrain_retries 2

スプリットブレーン自動復旧 の初回実行が失敗した場合に何回再試行するかです。

# Pandora FMS HA MySQL cluster splitbrain auto-recovery settings (PANDORA FMS ENTERPRISE ONLY)
# Maximum number of retries to verify resync status.
#ha_max_resync_wait_retries 3

スプリットブレーン自動復旧 処理の最後に同期が成功したかどうかをチェックする回数です。

# Pandora FMS HA MySQL cluster splitbrain auto-recovery settings (PANDORA FMS ENTERPRISE ONLY)
# Maximum number of seconds waiting while verifying resync status.
#ha_resync_sleep 10

上記のトークンで設定されたリトライ間の秒数です。両方のパラメーターは スプリットブレーン自動復旧 機能に依存します。

# Network manager configuration server (PANDORA FMS ENTERPRISE ONLY).
ncmserver 1

NCM サーバのスレッド数です。

# NCM utility to execute SSH and Telnet connections.
ncm_ssh_utility /usr/share/pandora_server/util/ncm_ssh_extension

NCM サーバの実行バイナリのパスです。デフォルトでは以下にインストールされています:
/usr/share/pandora_server/util/ncm_ssh_extension

このバイナリは、NCM サーバの設定において Telnet または SSH でネットワークデバイスへ接続するために利用されます。

# Enable (1) or disable (0) Pandora FMS Correlation Server
# (PANDORA FMS ENTERPRISE ONLY).
correlationserver 0

このサーバは、eventserver を 置き換える ものです。これを利用するには、次のように eventserver を無効化し、correlationserver を有効化する必要があります。

eventserver 0
correlationserver 1

このサーバは、相関するアラートを時間間隔で評価し、多数の同時イベントが発生する環境でワークキューを最適化します。

有効化されている場合は、アラートの pass および drop は影響しません(常に pass として評価されます)。イベントプールおよびログの評価は、correlation_thresholdで定義された間隔で実行されます。

このサーバには、アラートルールのいずれかに準拠する評価プールにイベントまたはログがなくなるたびに、相関アラート回復の仕組みが組み込まれています。アラートが取得されると、アクションで定義された '取得' 条件で自動的にアクションが実行されます。マクロは使えません。実行時にその情報が無いためです。そのため、報告されるのは取得されたアラートのタイトルとその取得時刻のみです。

# Time in seconds to re-evaluate correlation alerts pool
# (PANDORA FMS ENTERPRISE ONLY).
correlation_threshold 30

correlationserver でのイベントプールとログを評価する時間(秒単位)です。

# Pre-load windows on start with available information.
# (PANDORA FMS ENTERPRISE ONLY).
#preload_windows 0

Pandora FMS サーバを起動した際に、相関アラートを評価するために event_window 内でイベントを事前にロードします。 これを無効にすると、correlationserver においてイベントプールが空になるため、発報されたアラートごとにアラートリカバリが開始されます。再起動のたびに処理が行われないように、デフォルトで有効にすることをお勧めします。

# Activate (1) Pandora FMS Discovery server
discoveryserver 1

この設定パラメータは、自動検出サーバを有効化するために利用します。有効化: 1、無効化: 0 です。デフォルトは有効化されています。

# Log retrieving, items per request.
elastic_query_size 10

Elasticsearch を使用したログ収集のリクエストごとのアイテム数です。高い値にすると、Elasticsearch が停止する可能性があります。デフォルト値は 10 です。

# Correlated Alerts, group cache ttl (in seconds). Set to 0 to disable.
# (PANDORA FMS ENTERPRISE ONLY).
#event_server_cache_ttl 10

correlationserverに、グループキャッシュの保持時間(秒単位)を設定します。 有効化時のデフォルトは、10 です。

# Correlated Alerts, log window in seconds (3600 by default)
# (PANDORA FMS ENTERPRISE ONLY).
log_window 3600

correlationserverのロギング期間(秒単位)。デフォルトは 3600 です。event_window も確認してください。

# Pandora Sample Agent. If enabled, every 10 minutes, this embedded agent
# will make sample data. Disabled by default.
sample_agent 0

有効化した場合(sample_agent 1)、組み込みエージェントがテストデータを生成します。エージェントは Sample_Agent という名前で作成され(システムグループ Servers に割り当てられます)、それぞれのテストイベントも含まれます。 変更を加えるには、Pandora FMS サーバを再起動する必要があります。 テストが終わったら、このエージェントは無効化(sample_agent 0)してください。

Google Chrome® ウェブブラウザの Pandora FMS 拡張によるイベント表示:

# Pandora Sample Agent interval (in seconds).
sample_agent_interval 600

sample_agent の秒単位の実行間隔です。

# Number of unknown modules that will be processed per iteration.
unknown_block_size 1000

一度の実行で Pandora FMS データサーバによって処理される不明モジュールの数 (デフォルトは 1000)。

Pandora FMS Netflow サーバを有効化 (1) または無効化 (0) します。

# Enable (1) or disable (0) the Pandora FMS Netflow Server (PANDORA FMS ENTERPRISE ONLY).
netflowserver 0

Pandora FMS NetFlow サーバのスレッド数です。

# Number of threads for the Pandora FMS Netflow Server (PANDORA FMS ENTERPRISE ONLY).
netflowserver_threads 1

Pandora FMS サーバは、設定ファイルでの設定以外にもいくつかのオプションがあります。特定のケースでは、マシン自体で設定を行うため環境変数が必要です。これには、サーバの起動スクリプトで bash の書式で書かれた変数のファイルを読み込みます。デフォルトでは、/etc/pandora/pandora/pandora_server.env です。

設定可能な変数は次の通りです。

この変数は、サーバによって表示される初期メッセージ内の製品名をカスタマイズするのに利用します。そうしないと、データベースがロードされるまではカスタム名にはなりません。

この変数は、サーバによって表示される初期メッセージ内の製品作者名をカスタマイズするのに利用します。そうしないと、データベースがロードされるまではカスタム名にはなりません。

 #!/bin/bash
 PANDORA_RB_PRODUCT_NAME ="Custom product"
 PANDORA_RB_COPYRIGHT_NOTICE ="Custom copyright"

Pandora FMS SNMP コンソールは、SNMP トラップを受信するために snmptrapd を利用します。snmptrapd は、トラップを受信してログファイルを出力する、ほとんどの UNIX システムにある基本的なツールです。Pandora FMS では、snmptrapd をカスタムログファイルを書くように設定し、それを定期的に読み込みます。また、アラートが定義されていれば、それの実行も行います。

以前は、snmptrapd は特に明示的な設定を行わなくてもトラップを受け取っていました。バージョン 5.3 より、受信するトラップを制限するアクセス制御が厳しくなっており、デフォルトではどこからもトラップを受け取りません。

snmptrapd は、正しく設定しないとトラップを受け取れず、Pandora FMS コンソールにトラップを表示することができません。

次のファイルで snmptrapd を設定する必要があります。

/etc/snmp/snmptrapd.conf

存在しない場合は、ワーニングやエラーを次のファイルで確認してください。

/var/log/pandora/pandora_snmp.log

基本的な snmptrapd.conf は次のような設定になっています。

authCommunity log public

もし、あなたが利用している Linux ディストリビューションで動作しなければ、次のコマンドを使用して利用している snmptrapd バージョンにおいてトラップ受信を有効にする構文を確認してください。

man snmptrapd.conf

デフォルトでは、Pandora FMS ソフトウエアエージェントは、データをサーバに送るのに Tentacle プロトコル (IANA http://www.iana.org/assignments/port-numbers により、ポート 41121/tcp が割り当てられています) を利用します。エージェントは、ローカル(NFS,SMB)や、SSH、FTP など、他の方法でデータを送るように設定することもできます。もし、Tentacle プロトコルでデータを送りたい場合は、データを受信するための Tentacle サーバを設定する必要があります。デフォルトでは、Pandora FMS サーバをインストールすると、Tentacle サーバも同じマシンにインストールされます。

Tentacle サーバの設定を調整したい場合は、Tentacle サーバデーモンの起動スクリプトを直接編集します。

/etc/init.d/tentacle_serverd

以下に、Tentacle サーバの設定オプションを示します。

PANDORA_SERVER_PATH

データを受け取るディレクトリのパスを設定します。デフォルトでは /var/spool/pandora/data_in です。

TENTACLE_DAEMON

Tentacle デーモンを設定します。デフォルトでは、tentacle_server です。

TENTACLE_PATH

Tentacle のバイナリのパスを設定します。デフォルトでは /usr/bin です。

TENTACLE_USER

Tentacle デーモンを起動するユーザを設定します。デフォルトでは pandora です。

TENTACLE_ADDR

サーバが待ち受けるアドレスを設定します。0.0.0.0 を設定すると全アドレスで待ち受けます。デフォルトは全アドレスで待ち受ける 0.0.0.0 です。

TENTACLE_PORT

サーバが待ち受けるポート番号を設定します。デフォルトは 41121 (IANA により公式に割り当てられたポート) です。

TENTACLE_EXT_OPTS

Tentacle サーバを実行するときの追加オプションを設定します。証明書やパスワード の認証を使うように Tentacle を設定できます。

MAX_CONECTIONS

最大同時接続数です。デフォルトは 10 です。

MAX_SIZE

サーバが受け取る最大ファイルサイズをバイトで指定します。デフォルトは、2000000 です。

以下も参照してください:

• Tentacle の暗号化設定
• Tentacle でのデータ圧縮

Pandora ウェブロボットデーモンは、Enterprise 版のサービスで、ウェブの自動ブラウジングを行うために必要なものです。WUX 機能の一部で、module ライブラリにあります。

以下を含んでいます:

• バージョン 46 の Firefox ブラウザバイナリ
• ウェブブラウジングセッションを記録・実行するための設定済のプロファイル
• セッション自動化サーバ
• ウェブブラウジングセッションレコーダ (.xpi)

PWRD に関するより詳細は、こちらを参照してください。

多数のコアと RAM を備えたマシンを使用している場合、このオプションを使用して、最も要求の厳しいサーバ (データサーバやセカンダリサーバプロセスの使用など) のプロセスを分離すると便利です。

これにより、メインサーバのタスクに影響を与えることなく、リソースの最適な使用が可能になり、メインプロセスによって管理される残りのコンポーネントの動作に影響を与えることなく、最も積極的にワークロードをセカンダリプロセスに委任できます。

設定

/etc/pandora/conf.d

バージョン 770 を初めてインストールすると、conf.d ディレクトリが作成されます。このディレクトリには、各追加プロセスのファイルが含まれます。

pandora_server/conf/pandora_server_sec.conf.template ファイルは、conf.d ディレクトリに .conf 拡張子を付けて、適切な名前 (たとえばpandora_server_sec.conf、pandora_server_ter.conf など) でコピーする必要があります。

コピーしたファイルは、次の操作規則に準拠するように編集する必要があります。

• 設定ファイルでは、一意のサーバ名 (サーバ名) を定義する必要があります。メイン プロセスまたは別のセカンダリプロセスと同じにすることはできません。 空でないことおよび、コメントアウト されていないことを確認してください。
• セカンダリサーバは常に master 0 でなければなりません。マスター タスクは、常にメインサーバによって実行されます。
• 設定ファイルの拡張子は .conf で、conf.d ディレクトリ内にある必要があります。
• セカンダリサーバの設定ファイルが定義されると、pandora_server サービスがメインサーバとセカンダリサーバの両方を管理し、設定されたすべてのプロセスの起動、停止、状態表示を行います。

Pandora FMS ウェブコンソールには、ウェブサーバが必要で、いくつかのプログラミング言語を利用します。

Pandora FMS には、それが機能するために必要ないくつかのファイルを含む一連のフォルダがあります。これらのファイルへのアクセスを避けるために、コンソールの一部のフォルダーには、アクセスを制限する .htaccess ファイルがあります。 Apache 設定 でこれを有効にするには、.htaccess を使用してこれらの権限を上書きできるようにする必要があります。 それには、トークン AllowOverride を All に設定します。

AllowOverride All

以下を置き換える:

AllowOverride None

Pandora FMS Web コンソールには、インストール中に自動的に生成される設定ファイルがあります。それは、/consolepath/include/config.php にあります。

例えば、CentOS のシステムであれば以下にあります。

/var/www/html/pandora_console/include/config.php

設定オプションはファイルの先頭部分にあり、次の通りです。

$config["dbtype"]

利用するデータベースのタイプです。デフォルトは MySQL です。

$config["dbname"]

接続する Pandora FMS データベース名を設定します。デフォルトは pandora です。

$config["dbuser"]

Pandora FMS データベースに接続するユーザ名を設定します。デフォルトは pandora です。

$config["dbpass"]

Pandora FMS データベースに接続するユーザのパスワードを設定します。

$config["dbhost"]

Pandora FMS データベースのホスト名もしくは IP アドレスを設定します。サーバと同一ホストにインストールしているのであれば、127.0.0.1 または localhost です。

$config["homedir"]

Pandora FMS ウェブコンソールのディレクトリを設定します。通常は、/var/www/pandora_console や /srv/www/htdocs/pandora_console です。

$config["homeurl"]

Pandora FMS コンソールの URL のベースディレクトリを設定します。通常は /pandora_console です。

$config["public_url"]

Pandora FMS サーバが apache の mod_proxy などを使ったリバースプロキシ配下にある場合に、URL を文字列で指定します。

$config["id_console"]=id;
$config["console_description"]="description";

id はゼロよりも大きい整数です。

これら 2 つの変数を使用すると、自動検出タスクの実行における負荷を複数のコンソールで分散できます。

• 自動検出コンソールタスク を参照。
• コンソール管理 を参照。
• レポート専用コンソール を参照。

Apache サーバに Pandora FMS しかない場合は、ユーザがサーバの / URL にアクセスした際に /pandora_console へ自動的にリダイレクトするメリットがある場合があります。これを行うには、次の内容で index.html ファイルを作成し、ウェブサーバのルートディレクトリ (/var/www または /srv/www/htdocs) に配置します。

 <html>
 <head>
 <meta HTTP-EQUIV="REFRESH" content="0; url=pandora_console/index.php">
 </head>
 </html>

bearer トークンを使用したヘッダー認証が正しく機能するには、HTTP_AUTHORIZATION=$1 ディレクティブが /etc/httpd/conf.d/php.conf ファイルに含まれている必要があります。

# Redirect to local php-fpm if mod_php (5 or 7) is not available
<IfModule !mod_php5.c>
  <IfModule !mod_php7.c>
    <IfModule !mod_php.c>
      # Enable http authorization headers
      SetEnvIfNoCase ^Authorization$ "(.+)" HTTP_AUTHORIZATION=$1
      <Proxy "unix:/run/php-fpm/www.sock|fcgi://localhost">
        ProxySet timeout=1200
      </Proxy>

      <FilesMatch \.(php|phar)$>
        SetHandler "proxy:fcgi://localhost"
      </FilesMatch>

    </IfModule>
  </IfModule>
</IfModule>

Pandora FMS ドキュメント一覧に戻る