1 アイテムの作成

概要

Zabbixフロントエンドでアイテムを作成するには、以下の手順を実行します。

  • データ収集 > ホスト に移動します
  • ホストの行でアイテムをクリックします
  • 画面右上のアイテムの作成をクリックします
  • フォームにアイテムのパラメータを入力します

既存のアイテムを開き、クローンボタンを押して別名で保存することで、アイテムを作成することもできます。

設定

アイテム タブには、アイテムの一般属性が含まれます。

必須入力フィールドには赤いアスタリスクが付いています。

Parameter Description
Name アイテム名。
ユーザーマクロがサポートされています。
Type アイテムの種類。個別の アイテムタイプ セクションを参照してください。
Key アイテムキー（最大 2048 文字）。
サポートされる アイテムキー は、各アイテムタイプのセクションで確認できます。
キーは単一のホスト内で一意である必要があります。
キーの種類が 'Zabbix agent'、'Zabbix agent (active)'、または 'Simple check' の場合、キー値は Zabbix エージェントまたは Zabbix サーバーでサポートされている必要があります。
関連情報: 正しい キー形式。
Type of information 変換が行われる場合は、その後にデータベースへ保存されるデータの種類。
Numeric (unsigned) - 64 ビット符号なし整数。
整数アイテムで浮動小数点値を受信した場合、小数部分は切り捨てられます。
Numeric (float) - 64 ビット浮動小数点数。
この種類では、およそ 15 桁の精度と、約 -1.79E+308 から 1.79E+308 の範囲が利用できます（PostgreSQL 11 以前のバージョンを除く）。
科学表記での値の受信もサポートされています。例: 1.23E+7、1e308、1.1E-4。
Character - 短いテキストデータ。
Log - タイムスタンプ、送信元、重要度、logeventid などのログ関連プロパティを任意で持つ長いテキストデータ。
Text - 長いテキストデータ。 テキストデータの制限 も参照してください。
Binary - バイナリ値（依存アイテムでのみサポート）。
Binary データ型の値を返すアイテムは、計算アイテムの式やトリガー式ではサポートされません。
特定の 1 つの形式のみでデータを返すアイテムキーについては、対応する情報の種類が自動的に選択されます。
Host interface ホストインターフェースを選択します。このフィールドは、ホストレベルでアイテムを編集している場合に表示されます。
Units 単位記号が設定されている場合、Zabbix は受信したアイテム値に後処理を行い、指定された単位の接尾辞付きで表示します。
特殊な書式を持つサポート済みの単位記号（および受信値 → 表示値の例）は次のとおりです。
B - バイト（1024 → 1 KB）
Bps - 1 秒あたりのバイト数（1024 → 1 KBps）
s - 秒。最大 3 つの最も大きい非ゼロの時間単位で表示されます（881764 → 10d 4h 56m）
uptime - 経過時間を hh:mm:ss または N days, hh:mm:ss 形式で表示します（881764 → 10 days, 04:56:04）
unixtime - Unix タイムスタンプ。yyyy.mm.dd hh:mm:ss 形式で表示されます（881764 → 1970-01-11 04:56:04 AM）。正しく書式設定するには、受信したアイテム値が Numeric (unsigned) である必要があります。
Hz、W などの他の単位では、受信値が 1000 を超えると 1000 で割られ、対応する接頭辞付きで表示されます（5000 → 5 KHz、881764 → 881.76 KW）。
単位記号の前に ! を付けると、単位変換と接頭辞付けは無効になります（1024 !B → 1024 B、61 !s → 61 s）。
単位記号と単位変換の詳細およびその他の例については、アイテム値の接尾辞 を参照してください。
Update interval このアイテムの新しい値を N 秒ごとに取得します。許可される最大更新間隔は 86400 秒（1 日）です。
時間接尾辞 がサポートされています。例: 30s、1m、2h、1d。
ユーザーマクロ がサポートされています。
1 つのマクロでフィールド全体を埋める必要があります。1 つのフィールド内で複数のマクロを使うことや、マクロとテキストを混在させることはサポートされていません。
注: 更新間隔を '0' に設定できるのは、非ゼロ値のカスタム間隔が存在する場合のみです。'0' に設定され、かつ非ゼロ値のカスタム間隔（柔軟またはスケジュール済み）が存在する場合、アイテムはそのカスタム間隔の期間中にポーリングされます。
注: アイテムが有効になった後、または更新間隔を変更した後の最初のポーリングは、設定値より早く実行される場合があります。
新しいアイテムは、スケジューリングまたは柔軟な更新間隔を持ち、かつ Update interval が 0 に設定されていない限り、作成後 60 秒以内にチェックされます。
既存のパッシブアイテムは、Execute now ボタン を押すことで、すぐに値を取得できます。
Custom intervals アイテムのチェック用にカスタムルールを作成できます。
Flexible - Update interval の例外（異なる頻度の間隔）を作成します。
Scheduling - カスタムのポーリングスケジュールを作成します。
詳細は カスタム間隔 を参照してください。
Interval フィールドでは 時間接尾辞 がサポートされています。例: 30s、1m、2h、1d。
ユーザーマクロ がサポートされています。
1 つのマクロでフィールド全体を埋める必要があります。1 つのフィールド内で複数のマクロを使うことや、マクロとテキストを混在させることはサポートされていません。
Timeout アイテムチェックのタイムアウトを設定します（サポートされている アイテムタイプで利用可能）。タイムアウトオプションを選択してください。
Global - プロキシ/グローバルのタイムアウトが使用されます（グレー表示の Timeout フィールドに表示されます）。
Override - カスタムタイムアウトが使用されます（Timeout フィールドで設定。許可範囲: 1 - 600s）。時間接尾辞（例: 30s、1m）および ユーザーマクロ がサポートされています。
Timeouts リンクをクリックすると、プロキシ のタイムアウト、または（プロキシを使用しない場合の）グローバル タイムアウトを設定できます。なお、Timeouts リンクは、Super admin タイプのユーザーで、Administration > General または Administration > Proxies の Webインターフェース セクションに対する権限を持つ場合にのみ表示されます。
History 次のいずれかを選択します。
Do not store - アイテム履歴を保存しません。依存アイテムのみが履歴を保持すればよいマスターアイテムに便利です。
この設定は、グローバルな housekeeper 設定 では上書きできません。
Store up to - データベース内で詳細履歴を保持する期間を指定します（1 時間から 25 年）。古いデータは housekeeper により削除されます。秒単位で保存されます。
時間接尾辞 がサポートされています。例: 2h、1d。ユーザーマクロ がサポートされています。
Store up to の値は、Administration > Housekeeping でグローバルに上書きできます。
グローバルな上書き設定が存在する場合、オレンジ色の 情報アイコンが表示されます。マウスを重ねると、たとえば Overridden by global housekeeper settings (1d) のような警告メッセージが表示されます。
データベース内の値履歴サイズを削減するため、記録された値はできるだけ短い期間だけ保持することを推奨します。長い値履歴を保存する代わりに、トレンドとしてより長期間のデータを保存できます。
History and trends も参照してください。
Trends 次のいずれかを選択します。
Do not store - トレンドを保存しません。
この設定は、グローバルな housekeeper 設定 では上書きできません。
Store up to - 集計済み（1 時間ごとの min、max、avg、count）履歴をデータベース内で保持する期間を指定します（1 日から 25 年）。古いデータは housekeeper により削除されます。秒単位で保存されます。
時間接尾辞 がサポートされています。例: 24h、1d。ユーザーマクロ がサポートされています。
Store up to の値は、Administration > Housekeeping でグローバルに上書きできます。
グローバルな上書き設定が存在する場合、オレンジ色の 情報アイコンが表示されます。マウスを重ねると、たとえば Overridden by global housekeeper settings (7d) のような警告メッセージが表示されます。
注: 数値以外のデータ（character、log、text）ではトレンドの保持は利用できません。
History and trends も参照してください。
Value mapping このアイテムに値マッピングを適用します。値マッピング は受信値を変更せず、表示用のみです。
Numeric(unsigned)、Numeric(float)、Character アイテムで動作します。
例: "Windows service states"。
Log time format Log タイプのアイテムでのみ利用できます。サポートされるプレースホルダーは次のとおりです。
y: Year (1970-2038)。
M: Month (01-12)。
d: Day (01-31)。
h: Hour (00-23)。
m: Minute (00-59)。
s: Second (00-59)。
空欄のままにすると、タイムスタンプは Unix time の 0 に設定され、1970 年 1 月 1 日を表します。
たとえば、Zabbix エージェントのログファイルには次の行があります。
" 23480:20100328:154718.045 Zabbix agent started. Zabbix 1.8.2 (revision 11211)."
この行は、PID 用の 6 文字位置に続いて、日付、時刻、残りのメッセージで始まります。
この行のログ時刻形式は "pppppp:yyyyMMdd:hhmmss" になります。
"p" と ":" の文字はプレースホルダーであり、"yMdhms" 以外の任意の文字にできます。
Populates host inventory field アイテムの値を反映させるホストインベントリのフィールドを選択できます。これは、ホストで自動 インベントリ 収集が有効になっている場合に機能します。
このフィールドは、Type of information が 'Log' に設定されている場合は利用できません。
Description アイテムの説明を入力します。ユーザーマクロ がサポートされています。
Enabled チェックボックスをオンにするとアイテムが有効になり、処理されるようになります。
アイテムを無効にすると、履歴キャッシュから直ちに削除されます（ただし、ログ用に保持される最後の値は除きます）。
Latest data リンクをクリックすると、このアイテムの最新データを表示できます。
このリンクは、既存のアイテムを編集している場合にのみ利用できます。

アイテムタイプ固有のフィールドは、対応するページ に記載されています。

ホストレベルで既存の テンプレート レベルのアイテムを編集する場合、いくつかのフィールドは読み取り専用になります。 フォームヘッダーのリンクを使用してテンプレートレベルへ移動し、そこで編集できます。テンプレートレベルでの変更は、そのテンプレートがリンクされているすべてのホストのアイテムに反映されることに注意してください。

Tags タブでは、アイテムレベルの タグ を定義できます。

アイテム値の事前処理

事前処理タブでは、受信した値に対する変換ルールを定義できます。

アイテムのテスト

アイテムのテストを実行するには、サーバーとプロキシのシステム時刻がsynchronizedされていることを確認してください。 サーバー時刻が遅れている場合、アイテムのテストで "The task has been expired." というエラーメッセージが返されることがあります。 ただし、サーバーとプロキシで異なるタイムゾーンを設定していても、テスト結果には影響しません。

アイテムをテストして、設定が正しければ実際の値を取得できます。 アイテムが保存される前でもテストできます。

テストは、ホストおよびテンプレートのアイテム、アイテムプロトタイプ、ローレベルディスカバリルールで利用できます。 アクティブアイテムはテストできません。

アイテムのテストは、次のパッシブアイテムタイプで利用できます。

  • Zabbix エージェント
  • SNMP エージェント (v1, v2, v3)
  • IPMI エージェント
  • SSH チェック
  • Telnet チェック
  • JMX エージェント
  • 単純チェック (icmpping*、vmware.* アイテムを除く)
  • Zabbix internal
  • 計算アイテム
  • 外部チェック
  • データベースモニター
  • HTTP エージェント
  • Script
  • Browser

アイテムをテストするには、アイテム設定フォーム下部の Test ボタンをクリックします。 Test ボタンは、テストできないアイテム（アクティブチェック、除外された単純チェックなど）では無効になることに注意してください。

アイテムのテストフォームには、必要なホストパラメータ（ホストアドレス、ポート、サーバー/プロキシでテストする（プロキシ名））と、アイテム固有の詳細（SNMPv2 コミュニティや SNMPv3 セキュリティ認証情報など）を入力するフィールドがあります。 これらのフィールドはコンテキストに応じて動作します。

  • 可能な場合、値はあらかじめ入力されます。つまり、エージェントを必要とするアイテムでは、ホストの選択されたエージェントインターフェースから情報を取得します。
  • テンプレートアイテムでは、値を手動で入力する必要があります。
  • プレーンテキストのマクロ値は解決されます。
  • 値（または値の一部）が secret または Vault マクロであるフィールドは空になり、手動で入力する必要があります。 アイテムパラメータに secret マクロ値が含まれている場合、次の警告メッセージが表示されます: "Item contains user-defined macros with secret values. Values of these macros should be entered manually."
  • アイテムタイプのコンテキストで不要なフィールドは無効になります（例: 計算アイテムではホストアドレスフィールドとプロキシフィールドが無効になります）

アイテムをテストするには、Get value をクリックします。 値の取得に成功すると、Value フィールドに値が入力され、現在の値（存在する場合）は Previous value フィールドに移動します。同時に Prev. time フィールドが計算されます。つまり、2つの値（クリック）の時間差を計算し、取得した値に "\n\r" が含まれている場合は EOL シーケンスを検出して CRLF に切り替えようとします。

前処理をテストするには、Get value and test をクリックします。

ホストから取得した値とテスト結果は、Webインターフェースに送信される際に最大 512KB に切り詰められます。 結果が切り詰められた場合は、警告アイコンが表示されます。 警告の説明はマウスオーバーで表示されます。 512KB を超えるデータも、Zabbix サーバー側では引き続き完全に処理されることに注意してください。

設定が正しくない場合は、考えられる原因を説明するエラーメッセージが表示されます。

ホストから正常に取得した値は、前処理ステップのテストにも使用できます。

フォームのボタン

フォームの下部にあるボタンで、いくつかの操作を行うことができます。
アイテムの追加。このボタンは新規のアイテムの時のみ使用できます。
アイテムのプロパティの更新。
現在のアイテムプロパティをベースにして別のアイテムを作成。
アイテムの値を取得。アイテムのタイプがパッシブなものだけ対応しています。(詳細参照)
注意 値の取得時には設定キャッシュは更新されません。つまり直近のアイテムの設定変更が反映されません。
値を取得できるかのテスト実行。
アイテムのヒストリとトレンドを削除。
アイテムの削除。
アイテムのプロパティ変更をキャンセル。

テキストデータの制限

テキストデータの制限は、データベースのバックエンドによって異なります。
テキスト値は、データベースに保存される前に、データベースの値型の制限に合わせて切り詰められます。

Database Type of information
Character Log Text
MySQL 255文字 65536バイト 65536バイト
PostgreSQL 255文字 65536文字 65536文字
SQLite (only Zabbix proxy) 255文字 65536文字 65536文字

カスタムスクリプトの制限

使用可能なカスタムスクリプトの長さは、使用するデータベースによって異なります。

データベース 文字数の上限 バイト数の上限
MySQL 65535 65535
PostgreSQL 65535 制限なし
SQLite (Zabbixプロキシのみ) 65535 制限なし

アイテムのタイムアウト

アイテムのタイムアウトは、Zabbix がチェックを失敗として中止するまでにどれだけ待機するかを指定します。

タイムアウトに達すると、データ取得が完了していなくてもチェックは中止されます。データが部分的に受信された場合、アイテムはサポートされていない状態になり、エラーメッセージがログに記録されます（たとえば、SNMP チェックで複数の OID のうち 1 つに対してのみデータ収集が成功した場合など）。

多くのアイテムタイプでは、柔軟なアイテムタイムアウトを設定できます。

  • 単一アイテムごと
  • アイテムタイプごと（プロキシレベル）
  • アイテムタイプごと（グローバルレベル）

単一アイテムごとのカスタムタイムアウトは、特定のアイテムに対してより長いタイムアウトを指定しつつ、他のアイテムのタイムアウトを低く保ちたい場合に便利です。

タイムアウトの優先順位

  1. 単一アイテムのタイムアウトは、他のすべてのタイムアウトより優先されます。
  2. プロキシレベルのタイムアウトは、グローバルタイムアウトより優先されます。

柔軟なタイムアウトが設定されているチェックでは、Zabbix サーバー または プロキシ の設定にあるタイムアウトは影響しません。

柔軟なタイムアウトのサポート

柔軟なアイテムのタイムアウトは、以下のアイテムタイプでサポートされています。

サポートされていないアイテム

サポートされていないアイテムは サポートされていません のステータスとして報告され、標準の 更新間隔 で再確認されます。

アイテムは、何らかの理由で値を取得できない場合（例: 接続エラー、アイテムを処理するように設定されたポーラーがない場合）にサポートされていない状態になります。 さらに、履歴データを受信しないアイテムは サポートされていません のステータスのままになります。 これは想定された動作です。アイテムが 正常 ステータスに移行するのは、新しい有効な履歴データを受信した場合のみです。

障害と同様に、サポートされていないアイテムは、新しいデータを受信したときにのみ再評価されます。たとえそのアイテムに利用可能な履歴データがもう存在しなくても同様です。 言い換えると、アイテムとトリガーは、新しいデータを受信したときにのみ状態を変更します。 ただし、トリガー式に date and time および/または nodata() 関数が含まれている場合、トリガーは 30 秒ごとに再計算されます（詳細は トリガーの計算時間 を参照してください）。