1 アイテムの作成

概要

Zabbix Webインターフェースでアイテムを作成するには、次の手順を実行します。

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

既存のアイテムを開き、複製 ボタンを押してから別の名前で保存することでも、アイテムを作成できます。

設定

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

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

Parameter Description
Name アイテム名。
ユーザーマクロを使用できます。
Type アイテムのタイプ。各item typeセクションを参照してください。
Key アイテムキー（最大2048文字）。
サポートされているitem keysは、各アイテムタイプのセクションで確認できます。
キーは、1つのホスト内で一意でなければなりません。
キータイプが「Zabbix agent」、「Zabbix agent (active)」、または「Simple check」の場合、キー値はZabbix agentまたはZabbix serverでサポートされている必要があります。
あわせて、正しいkey formatも参照してください。
Type of information 必要に応じて変換を行った後、データベースに保存されるデータの種類です。
Numeric (unsigned) - 64ビット符号なし整数。
整数アイテムで浮動小数点値を受信した場合、小数部は切り捨てられることに注意してください。
Numeric (float) - 64ビット浮動小数点数。
このタイプでは、およそ15桁の精度と、およそ -1.79E+308 から 1.79E+308 までの範囲を扱えます（PostgreSQL 11 and earlier versionsを除く）。
科学表記の値の受信もサポートされています。例: 1.23E+7、1e308、1.1E-4。
Character - 短いテキストデータ。
Log - ログ関連のプロパティ（timestamp、source、severity、logeventid）を任意で含む長いテキストデータ。
Text - 長いテキストデータ。text data limitsも参照してください。
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)。
単位記号と単位変換の詳細およびその他の例については、Item value suffixesを参照してください。
Update interval このアイテムの新しい値を N 秒ごとに取得します。設定可能な更新間隔の最大値は86400秒（1日）です。
Time suffixesを使用できます。例: 30s、1m、2h、1d。
ユーザーマクロを使用できます。
1つのマクロでフィールド全体を埋める必要があります。1つのフィールド内で複数のマクロを使用したり、マクロとテキストを混在させたりすることはできません。
注: 更新間隔を「0」に設定できるのは、0以外の値を持つカスタム間隔が存在する場合のみです。「0」に設定され、かつ0以外の値を持つカスタム間隔（柔軟またはスケジュール）が存在する場合、アイテムはそのカスタム間隔の期間中にポーリングされます。
注: アイテムが有効になった後、または更新間隔を変更した後の最初のアイテムポーリングは、設定値より早く発生する場合があります。
新しいアイテムは、Scheduling または Flexible update interval があり、かつ Update interval が 0 に設定されていない限り、作成後60秒以内にチェックされます。
既存のパッシブアイテムは、Execute now button を押すことで、直ちに値をポーリングできます。
Custom intervals アイテムのチェックに対してカスタムルールを作成できます。
Flexible - Update interval に対する例外（異なる頻度の間隔）を作成します。
Scheduling - カスタムのポーリングスケジュールを作成します。
詳細はCustom intervalsを参照してください。
Interval フィールドではTime suffixesを使用できます。例: 30s、1m、2h、1d。
ユーザーマクロを使用できます。
1つのマクロでフィールド全体を埋める必要があります。1つのフィールド内で複数のマクロを使用したり、マクロとテキストを混在させたりすることはできません。
Timeout アイテムチェックのタイムアウトを設定します（supportedアイテムタイプで使用可能）。タイムアウトオプションを選択します。
Global - プロキシ/グローバルタイムアウトが使用されます（グレー表示された Timeout フィールドに表示されます）。
Override - カスタムタイムアウトが使用されます（Timeout フィールドで設定。許容範囲: 1 - 600s）。Time suffixes（例: 30s、1m）およびユーザーマクロを使用できます。
Timeouts リンクをクリックすると、プロキシのタイムアウト、または（プロキシを使用しない場合は）globalタイムアウトを設定できます。Timeouts リンクは、Administration > General または Administration > Proxies のWebインターフェースセクションに対する権限を持つ Super admin タイプのユーザーにのみ表示される点に注意してください。
History 次のいずれかを選択します。
Do not store - アイテムの履歴は保存されません。依存アイテムのみで履歴を保持する必要がある場合、マスターアイテムに有用です。
この設定は、グローバルhousekeeper settingsでは上書きできません。
Store up to - データベース内に詳細な履歴を保持する期間を指定します（1時間～25年）。古いデータはhousekeeperによって削除されます。秒単位で保存されます。
Time suffixesを使用できます。例: 2h、1d。ユーザーマクロを使用できます。
Store up to の値は、Administration > Housekeeping でグローバルに上書きできます。
グローバル上書き設定が存在する場合、オレンジ色の 情報アイコンが表示されます。その上にマウスカーソルを置くと、たとえば Overridden by global housekeeper settings (1d) のような警告メッセージが表示されます。
データベース内の値履歴のサイズを減らすため、記録された値は可能な限り短い期間だけ保持することを推奨します。長期間の値履歴を保存する代わりに、より長期間のトレンドデータを保存できます。
History and trendsも参照してください。
Trends 次のいずれかを選択します。
Do not store - トレンドは保存されません。
この設定は、グローバルhousekeeper settingsでは上書きできません。
Store up to - 集計済み履歴（1時間ごとの最小値、最大値、平均値、件数）をデータベース内に保持する期間を指定します（1日～25年）。古いデータはhousekeeperによって削除されます。秒単位で保存されます。
Time suffixesを使用できます。例: 24h、1d。ユーザーマクロを使用できます。
Store up to の値は、Administration > Housekeeping でグローバルに上書きできます。
グローバル上書き設定が存在する場合、オレンジ色の 情報アイコンが表示されます。その上にマウスカーソルを置くと、たとえば Overridden by global housekeeper settings (7d) のような警告メッセージが表示されます。
注: トレンドの保持は、数値以外のデータ（character、log、text）では使用できません。
History and trendsも参照してください。
Value mapping このアイテムに値のマッピングを適用します。Value mappingは受信値自体を変更せず、表示のためだけに使用されます。
Numeric(unsigned)、Numeric(float)、Character アイテムで機能します。
たとえば、「Windows service states」です。
Log time format Log タイプのアイテムでのみ使用できます。サポートされるプレースホルダー:
y: 年 (1970-2038)。
M: 月 (01-12)。
d: 日 (01-31)。
h: 時 (00-23)。
m: 分 (00-59)。
s: 秒 (00-59)。
空白のままにすると、タイムスタンプはUnix timeで0に設定され、1970年1月1日を表します。
たとえば、次のZabbix agentログファイルの行を考えてみます。
" 23480:20100328:154718.045 Zabbix agent started. Zabbix 1.8.2 (revision 11211)."
この行は、PID用の6文字分の位置で始まり、その後に日付、時刻、メッセージの残りが続きます。
この行のログ時刻形式は "pppppp:yyyyMMdd:hhmmss" になります。
"p" と ":" はプレースホルダーであり、"yMdhms" 以外であれば任意の文字を使用できる点に注意してください。
Populates host inventory field アイテムの値を格納するホストインベントリフィールドを選択できます。これは、そのホストで自動inventory登録が有効になっている場合に機能します。
Type of information が「Log」に設定されている場合、このフィールドは使用できません。
Description アイテムの説明を入力します。ユーザーマクロを使用できます。
Enabled チェックボックスをオンにするとアイテムが有効になり、処理されます。
アイテムを無効にすると、履歴キャッシュから直ちに削除されます（最後の値を除く。ログ用に保持されます）。
Latest data リンクをクリックすると、そのアイテムの最新データを表示します。
このリンクは、既存のアイテムを編集している場合にのみ使用できます。

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

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

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

アイテムの値の保存前処理

保存前処理タブでは、受け取った値に対して変換するルールを定義することができます。

アイテムのテスト

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

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

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

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

  • Zabbixエージェント
  • SNMPエージェント (v1, v2, v3)
  • IPMIエージェント
  • SSHチェック
  • Telnetチェック
  • JMXエージェント
  • シンプルチェック (icmpping*、vmware.* アイテムを除く)
  • Zabbix内部
  • 計算アイテム
  • 外部チェック
  • データベースモニタ
  • HTTPエージェント
  • スクリプト
  • ブラウザ

アイテムをテストするには、アイテム設定フォームの下部にある Test ボタンをクリックします。 テストできないアイテム（アクティブチェックや、除外されるシンプルチェックなど）では、Test ボタンは無効になります。

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

  • 可能な場合は値が事前入力されます。たとえば、エージェントを必要とするアイテムでは、ホストの選択されたエージェントインターフェースの情報が使用されます。
  • テンプレートのアイテムでは、値を手動で入力する必要があります。
  • プレーンテキストのマクロ値は展開されます。
  • 値（または値の一部）がシークレットマクロまたはVaultマクロであるフィールドは空欄となり、手動で入力する必要があります。 アイテムのいずれかのパラメータにシークレットマクロ値が含まれている場合、次の警告メッセージが表示されます: 「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サーバーでは引き続き完全に処理されることに注意してください。

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

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

フォームのボタン

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

テキストデータの制限

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

データベース 情報の種類
Character Log Text
MySQL 255 文字 65536 バイト 65536 バイト
PostgreSQL 255 文字 65536 文字 65536 文字
SQLite (Zabbixプロキシのみ) 255 文字 65536 文字 65536 文字

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

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

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

アイテムのタイムアウト

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

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

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

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

個々のアイテムごと のカスタムタイムアウトは、他のアイテムのタイムアウトを短く保ったまま、特定のアイテムに対してより長いタイムアウトを指定したい場合に便利です。

タイムアウトの優先順位

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

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

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

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

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

サポートされていないアイテムは、取得不可 ステータスとして報告され、標準の 更新間隔 で再チェックされます。

何らかの理由(接続エラー、アイテムを処理するように設定されたポーラーがないなど)で値を取得できない場合、アイテムはサポートされません。また、ヒストリデータを受け取らないアイテムは、取得不可ステータスのままになります。これは想定された動作です。アイテムは、新しい有効なヒストリデータを受け取った場合にのみ、通常 ステータスに移行します。

障害と同様に、サポートされていないアイテムは、そのアイテムのヒストリデータがもう利用できない場合であっても、新しいデータを受け取った場合にのみ再評価されます。つまり、アイテムとトリガーは、新しいデータを受け取った場合にのみ状態を変更します。ただし、トリガー式に日付と時刻やnodata()関数が含まれている場合、トリガーは30秒ごとに再計算されます (詳細については、トリガーの計算時間を参照してください)。