アイテムとは、1つのパフォーマンスチェック項目または可用性チェック項目です。

引数付きパラメータには、引数を渡すことができます。たとえば、vfs.fs.size[*]は引数付きパラメータです。*は、パラメータの引数として渡される任意の文字列です。正しい定義の例:

• vfs.fs.size[/]
• vfs.fs.size[/opt]

キーパラメータを含むアイテムキー形式は、構文ルールに従う必要があります。以下の例は、サポートされる構文を表しています。このラインに従って、各ポイントで使用可能な項目と文字を決定できます。ラインに従ってブロックに当たった場合、その項目や文字を使用できます。当たらない場合は使用できません。

アイテムキー

有効なアイテムキーを構築するには、キー名を指定してから、パラメータを使用するかどうかを選択します。これは、選択可能な2つのラインで表されています。

キー名

キー名では、使用可能な文字範囲が制限され、各文字が他の文字に続きます。使用可能な文字は次のとおりです: 0-9a-zA-Z_-. 具体的には以下のようになります。

• 全ての数字
• 全ての小文字
• 全ての大文字
• アンダースコア
• ダッシュ
• ドット

キーのパラメータ

アイテムキーでは、複数のパラメータをカンマ区切りで使用できます。

各キーのパラメータ

各キーパラメータは、引用符付き文字列、引用符なし文字列、または配列のいずれかになります。

パラメータは空白のままにすることもでき、デフォルト値が使用されます。その場合、追加のパラメータを指定するには、適切な数のカンマを追加してください。たとえば、アイテムキーicmpping[,,200,,500]の場合、ping同士の間隔は200ミリ秒、タイムアウトは500ミリ秒、その他のパラメータはデフォルトのままになります。

パラメータ - 引用符付き文字列

キーパラメータが引用符付き文字列の場合、Unicode文字を使用できます。二重引用符付きの場合、バックスラッシュでエスケープする必要があります。

パラメータ - 引用符なし文字列

キーパラメータが引用符なし文字列の場合、すべてのUnicode文字を使用できます。

パラメータ - 配列

キーパラメータが配列の場合、角カッコで再度囲みます。各パラメータの後に、ルールと構文を指定する複数のパラメータが続きます。

パラメータ「encoding」を使用して、対応するアイテムチェックを処理するためのエンコードを指定するため、取得されたデータは破損しません。サポート対象のエンコードのリスト(コードページ識別子)については、 (GNUプロジェクト)のドキュメントや「Code Page Identifier」に関するMicrosoft Windows SDKドキュメントなどの各ドキュメントを参照してください。空白の「encoding」パラメータが渡されると、システム固有の拡張子が付いたANSI (Windows)またはUTF-8 (比較的新しいUNIX/Linuxディストリビューションのデフォルトのロケール、システムの設定を参照)がデフォルトで使用されます。

アイテムの値が何らかの理由で取得できない場合、そのアイテムはサポートされません。このようなアイテムは固定間隔で再チェックされます。間隔は管理のセクションで設定することができます。

[]内で使用できる文字:

0-9a-zA-Z.:,()_/[空白]

取得可能なパラメータのリスト

ここでは、Zabbix WIN32エージェントでのみサポートされているパラメータについて説明します。

SNMPエージェントが収集したデータを取得するには、SNMPをサポートするようにZabbixを設定する必要があります。

SNMPパラメータを監視するために必要な手順を以下に示します。

SNMPデバイスのホストの作成

IPアドレスとポート番号161を入力します。ホストの[ステータス]は[無効]に設定します。host.SNMPテンプレートを使用すると、必要なアイテムが自動的に追加されます。ただし、テンプレートとホストの間に互換性がない場合もあります。

監視するアイテムのSNMP文字列の特定

ホストを作成した後、snmpwalk(ZABBIXインストールに付属するucd-snmp/net-snmpソフトウェアに含まれる)または同等のツールを実行します。

shell> snmpwalk <host or host IP> public

SNMP文字列とその最新値のリストが表示されます。リストが表示されない場合は、SNMPコミュニティが標準のpublicではないことが考えられるので、それを確認する必要があります。リストが表示されたら、監視する文字列を探します。たとえば、スイッチのポート3に着信するバイト数を監視する場合、以下の文字列を探します。

interfaces.ifTable.ifEntry.ifOctetsIn.3 = Counter 32: 614794138

次に、interfaces.ifTable.ifEntry.ifInOctets.3のOIDを調べるために、snmpgetコマンドを実行します。

shell> snmpget -On 10.62.1.22 interfaces.ifTable.ifEntry.ifOctetsIn.3

文字列の最後の数値は、監視するポート番号です。このコマンドを実行すると、以下のような文字列が出力されます。

.1.3.6.1.2.1.2.2.1.10.3 = Counter32: 614794138

出力されたOIDの最後の数値もポート番号です。

3COMは、ポート1=ポート101、ポート3=ポート103というように、ポート番号を100単位で使用するようです。一方Ciscoは、ポート3=ポート3というようにそのまま使用します。

監視するアイテムの作成

Zabbixに戻り、アイテムをクリックして、先の手順で作成したSNMPホストを選択します。ホストを作成する際にテンプレートを使用したかどうかによって、ホストに関連付けられているSNMPアイテムのリストが表示される場合と新しいアイテムを入力するボックスだけが表示される場合があります。ここではsnmpwalkとsnmpgetを使用して収集した情報に基づいてアイテムを作成するものと仮定して、新しいアイテムの[名前]フィールドに簡単な説明を英語で入力します。[ホスト]フィールドにはスイッチ/ルータを入力し、[タイプ]フィールドでは[SNMPv1エージェント]を選択します([SNMPv2エージェント]を選択すると正常に動作しなかったのでここでは使用しない)。コミュニティ(通常はpublic)を入力し、[SNMP OID]フィールドに先の手順で取得したOIDを入力します。先頭にピリオドを付けることを忘れないでください(例: .1.3.6.1.2.1.2.2.1.10.3)。

[SNMPポート]に161を入力し、[キー]に有効な値(「SNMP-InOctets-Bps」など)を入力します。必要に応じて[乗数]を選択し、[更新間隔]と[ヒストリの保存期間(日)]では必要に応じてデフォルト以外の値を選択します。[ステータス]に[有効]、[データ型]に[数値]、[保存時の計算]に[差分]を設定します。[差分]以外の値を設定すると、SNMPデバイスから直近の変化量ではなく累積値を取得することになるので、必ず[差分]を設定してください。

以上の内容でアイテムを追加し、ZABBIXの[ホスト]領域に戻ります。ここでSNMPデバイスを[有効]に設定し、必要なSNMPデータについて[最新データ]を選択します。

一般的な例

OIDは数値または文字列のどちらでも指定できます。ただし、文字列のOIDを数値表現に変換する必要がある場合があります。その場合はsnmpgetを使用します。

shell> snmpget -On localhost public enterprises.ucdavis.memory.memTotalSwap.0 Monitoring of SNMP parameters is possible if either -with-net-snmp or -with-ucd-snmp flag was specified while configuring Zabbix sources.

アップタイムの監視

シンプルチェックは、主にエージェントレス監視またはサービスのリモートチェックに使用します。シンプルチェックを行う場合、Zabbixエージェントは必要ありません。シンプルチェックを処理(外部接続の確立など)するのは、Zabbixサーバの役割です。

tcpとtcp_perfを除く全てのシンプルチェックでは、省略可能なパラメータを1つ受け入れます。

• port - ポート番号省略された場合、デフォルトの標準サービスポートを使用します。

シンプルチェックの使用例: ftp,155 http http_perf,8080

サポートされているシンプルチェックのリストを以下に示します。

シンプルチェックにかかる時間がZabbixサーバ設定ファイルで定義されているタイムアウト時間(秒単位)を超えると、シンプルチェックは終了します。

その場合、戻り値は2です。

ZABBIXは、外部ユーティリティfpingを使用してICMP pingを処理します。このユーティリティはZabbixディストリビューションに付属していないので、別途インストールする必要があります。このユーティリティが存在しない場合、正しい権限が設定されていない場合、または設定ファイルのFpingLocationで定義されている場所と違う場所に存在する場合、ICMP ping(icmpping、icmppingsec、icmppingloss)は処理されません。

正しいパーミッションを設定するには、ユーザrootで以下のコマンドを実行します。

shell> chown root:zabbix /usr/sbin/fping shell> chmod 710 /usr/sbin/fping shell> chmod ug+s /usr/sbin/fping

ICMPチェックパラメータのデフォルト値は以下のとおりです。

Zabbixはチェックするアドレスを一時ファイルに書き込み、これがfpingに渡されます。アイテムに異なるパラメータがある場合、1つのファイルに書き込まれるのは同じパラメータのアイテムのみです。

内部チェックを使用すると、Zabbix内部を監視できます。内部チェックは、Zabbixサーバが処理します。

累計チェックを行う場合、監視するホスト上でエージェントを実行する必要はありません。累計情報は、Zabbixサーバが直接データベースに対してクエリーを発行して収集します。

累計チェックのアイテムのキーの記述形式 groupfunc[“Host group”,”Item key”,”item func”,”parameter”] 利用できるグループ関数:

サポートされているアイテム関数:

累計アイテムのキーの例:

ホストグループ「MySQL Servers」の合計ディスク容量

grpsum[“MySQL Servers”,”vfs.fs.size[/,total]”,”last”,”0”]

ホストグループ「MySQL Servers」のプロセッサロードアベレージ

grpavg[“MySQL Servers”,”system.cpu.load[,avg1]”,”last”,”0”]

ホストグループ「MySQL Servers」の直近5分間における1秒あたりの平均クエリ数

grpavg[“MySQL Servers”,”mysql.qps”,”avg”,”300”]

外部チェックは、Zabbixサーバがシェルスクリプトまたはバイナリを実行することによって実行するチェックです。

外部チェックを行う場合、監視するホスト上でエージェントを実行する必要はありません。

アイテムのキーの記述方法: script[parameters]

• script - スクリプトの名前
• parameters - コマンドラインパラメータのリスト

使用するスクリプトにパラメータを渡さない場合: script[]またはscript ← この[]を省略した記述方法はZabbix 1.8.1からサポートされています

Zabbixサーバは、zabbix_server.confの設定パラメータExternalScriptsで定義されているディレクトリにあるコマンドを見つけて実行します。コマンドはZabbixサーバを実行するユーザで実行されるため、アクセス権限や環境変数をラッパースクリプトで処理し、必要に応じて、そのユーザによるコマンドの実行がコマンドに対する権限で許可されるようにする必要があります。指定したディレクトリのコマンドのみを利用できます。

1番目のコマンドラインパラメータとしてホスト名が渡され、その後にparametersで指定されたパラメータが渡されます。

Zabbixは、スクリプトの標準出力を値として使用します。標準エラーや終了コードは無視されます。

外部スクリプトcheck_oracle.shをパラメータ「-h 192.168.1.4」で実行し、ホスト名が「www1.company.com」の場合:

check_oracle.sh[-h 192.168.1.4]

このとき、Zabbixは以下のコマンドを実行します:

check_oracle.sh www1.company.com -h 192.168.1.4.

ZabbixはSSH2サポートで設定する必要があります。

SSHチェックはエージェントレスの監視に使用されます。SSHチェックを行う場合、Zabbixエージェントは必要ありません。

実行する実際のコマンドは、アイテム設定のExecuted scriptフィールドに置いてください。複数のコマンドを実行するには、新しい行にそのコマンドを次々に配置します。

Telnetチェックはエージェントレスの監視に使用されます。TelnetチェックにZabbixエージェントは必要ありません。

実行する実際のコマンドは、アイテム設定のExecuted scriptフィールドに置いてください。複数のコマンドを実行するには、新しい行にそのコマンドを次々に配置します。

バージョン1.8.1までは、プロンプトを促すサポート対象文字は以下の記号で終了できます。

• $
• #
• >

バージョン1.8.2のZabbixでは、以下の文字のサポートが追加されています。

• %

計算アイテムでは、仮想データソースを非常に簡単に作成できます。アイテムの値は、算術式とZabbixデータベースに保存されたデータに基づいて定期的に計算されます。

計算アイテムを使用するには、アイテムタイプ計算を選択します。サポート対象の記号を使用してキー名を作成できます。式フィールド(1.8.1と1.8.2では条件式)に計算定義を入力する必要があります。

以下の関数がサポートされています。

非常に単純な条件式は次のような形式で指定します: func(<key>|<hostname:key>,<parameter1>,<parameter2>,…)

複雑な式は、関数、演算子、カッコを組み合わせて使用できます。トリガー条件式では、サポート対象の全ての関数と演算子を使用できます。構文はわずかに異なりますが、ロジックと演算子の優先順位はほぼ同じです。

ホスト名のサポート対象文字:

a..zA..Z0..9 ._-

キーのサポート対象文字:

a..zA..Z0..9.,_

関数のサポート対象文字:

a..zA..Z0..9_

トリガー条件式とは異なり、計算アイテムの処理は、新しい値の受け入れ時ではなく、アイテムの更新間隔に従って行われます。また、参照アイテムのアイテムキーを変更する場合、古いキーを使用していた全ての式を手動で更新する必要があります。

計算アイテムは、以下の状況ではサポート対象にならない場合があります。

1. 参照アイテムが見つからない
2. 関数を計算するデータがない
3. ゼロ除算
4. 構文エラー

「/」の空きディスク容量のパーセント値を計算します。

last関数を使用します: 100*last(“vfs.fs.size[/,free]”)/last(“vfs.fs.size[/,total]”)

Zabbixは、空きディスク容量と合計ディスク容量の最新の値を取得して、指定の式に従いパーセント値を計算します。

Zabbixで処理される値の10分間の平均を計算します。

avg関数を使用します: avg(“Zabbix Server:zabbix[wcache,values]”,600)

計算アイテムを長期間広範囲に使用すると、Zabbixサーバのパフォーマンスが影響を受ける場合があります。

eth0の合計帯域幅を計算します。

2つの関数を合計します: last(“net.if.in[eth0,bytes]”)+last(“net.if.out[eth0,bytes]”)

受信トラフィックのパーセント値を計算します。

より複雑な式: 100*last(“net.if.in[eth0,bytes]”)/(last(“net.if.in[eth0,bytes]”)+last(“net.if.out[eth0,bytes]”))