1 アイテムの作成

概要

ZabbixのWebインターフェースでアイテムを作成するには、以下の手順で行います:

  • 設定ホストへ移動
  • ホストの行のアイテムをクリック
  • 画面右上のアイテムの作成をクリック
  • フォーム内のアイテムのパラメーターを入力

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

設定

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

必須入力項目には、赤いアスタリスクが表示されています。

パラメーター 説明
名前 アイテムの名前。
タイプ アイテムのタイプ。それぞれのアイテムタイプセクションを参照してください。
キー アイテムキー(2048文字まで)。
サポートされているアイテムキーは、それぞれのセクションに記載されています。
キーは、1つのホスト内で一意である必要があります。
キータイプが'Zabbixエージェント'、'Zabbixエージェント(アクティブ)'、'シンプルチェック'の場合、ZabbixエージェントかZabbixサーバーがキーの値をサポートしている必要があります。
参照: 正しいキーのフォーマット
データ型 存在する場合、変換を実行した後、データベースに保存されるデータの型。
数値(整数) - 64bitの符号なし整数
数値(浮動小数) - 64bitの浮動小数点数。
この型は約15桁の精度を持ち、範囲は約-1.79E+308から1.79E+308です(PostgreSQL 11以前のバージョンを除く)。
科学的記法での値の受け取りもサポートされています。例: 1.23E+7、1e308、1.1E-4。
文字列 - 短いテキストデータ
ログ - オプションのログ関連プロパティ(timestamp、source、severity、logeventid)を持つ長いテキストデータ。
テキスト - 長いテキストデータ。テキストデータの制限も参照してください。
ある特定の形式でのみデータを返すアイテムキーの場合、一致する情報タイプが自動的に選択されます。
ホストインターフェース ホストインターフェースを選択します。このフィールドは、ホストレベルでアイテムを編集するときに使用できます。
単位 単位記号が設定されている場合、Zabbixは受信した値に後処理を追加し、設定された単位の接尾辞と共に表示します。
デフォルトでは、生データが1000を超える場合、1000で割ってそれに応じて表示されます。例えば、bpsを設定して881764の値を受信すると、881.76kbpsと表示されます。
JEDECメモリ標準は、B(byte)、Bps(byte/秒)単位の1024で割る処理に使用されます。したがって、単位がBまたはBpsに設定されている場合、Zabbixは次のように表示します:
1は1B/1Bpsとして
1024は1KB/1KBpsとして
1536は1.5KB/1.5KBpsとして
次の時間関連の単位が使用されている場合は、特別な処理が使用されます:
unixtime - "yyyy.mm.dd hh:mm:ss" に変換されます。正しく変換するには、受信した値が数値 (符号なし)タイプの情報である必要があります。
uptime - "hh:mm:ss"または"N days, hh:mm:ss"に変換されます。
たとえば、881764(秒)の値を受け取った場合、"10 days, 04:56:04"と表示されます。
s - "yyy mmm ddd hhh mmm sss ms"に変換されます。パラメーターは秒数として扱われます。
たとえば、881764(秒)の値を受け取った場合、"10d 4h 56m"と表示されます。
"1m 15d 5h"や"2h 4m 46s"のように、上位3つの主要単位のみが表示されます。表示する日がない場合、2つのレベルのみが表示されます - "1m 5h"(分、秒、ミリ秒は表示されません)。値が 0.001 未満の場合は、"< 1 ms"に変換されます。
: 単位の前に!が付いている場合、アイテムの値には単位のプレフィックス/処理は適用されません。単位変換を参照してください。
監視間隔 この項目の新しい値をN秒ごとに取得します。最大許容更新間隔は86400秒(1日)です。
時間のサフィックスがサポートされています(例: 30s、1m、2h、1d)。
ユーザーマクロがサポートされています。
1つのマクロでフィールド全体を入力する必要があります。1つのフィールドに複数のマクロを指定したり、テキストと混在するマクロを指定したりすることはできません。
: 更新間隔は、カスタム間隔に0以外の値がある場合のみ'0'に設定できます。'0'に設定され、カスタム間隔(フレキシブルまたはスケジュール)がゼロ以外の値で存在する場合、アイテムはカスタム間隔の期間中にポーリングされます。
: アイテムがアクティブになった後、または更新間隔の変更後の最初のアイテム ポーリングは、構成された値よりも早く発生する可能性があります。
既存のパッシブアイテムは、監視データ取得ボタンを押すことですぐに値をポーリングできます。
監視間隔のカスタマイズ アイテムをチェックするためのカスタム ルールを作成できます:
例外設定 - 監視間隔の例外を作成します(異なる頻度の間隔)
定期設定 - カスタムポーリングスケジュールを作成します。
詳細については監視間隔のカスタマイズを参照してください。
監視間隔では30 秒、1 分、2 時間、1 日などの時間のサフィックスがサポートされています。
ユーザーマクロがサポートされています。
1つのマクロでフィールド全体を入力する必要があります。1つのフィールドに複数のマクロを指定したり、テキストと混在するマクロはサポートされていません。
スケジュールはZabbix 3.0.0以降でサポートされています。
: アクティブチェックの監視間隔のカスタマイズはZabbixエージェント2でのみサポートされています。
ヒストリの保存期間 次のいずれかを選択します:
ヒストリを保存しない - アイテムのヒストリは保存されません。依存アイテムのみがヒストリを保存する必要がある場合、マスターアイテムに便利です。
この設定は、グローバルハウスキーパー設定によって上書きすることはできません。
保存期間 - データベースに詳細なヒストリを保存する期間を指定します(1時間から25年)。古いデータはハウスキーパーによって削除されます。秒単位で保存されます。
時間のサフィックスがサポートされています (例: 2h、1d)。 ユーザーマクロがサポートされています。
保存期間の値は、管理 → 一般 → ハウスキーパーでグローバルに上書きできます。
グローバルな上書き設定が存在する場合は、オレンジ色の情報アイコンが表示されます。マウスをその上に置くと、次で上書き データの保存期間設定(全体設定) (1d) などの警告メッセージが表示されます。
データベース内のヒストリのサイズを小さくするために、記録された値をできるだけ短い期間保持することをお勧めします。値の長いヒストリを保持する代わりに、トレンドのより長いデータを保持できます。
ヒストリとトレンドも参照してください。
トレンドの保存期間 次のいずれかを選択します:
トレンドを保存しない - トレンドは保存されません。
この設定は、グローバルハウスキーパー設定によって上書きすることはできません。
保存期間 - 集計されたヒストリ(時間ごとの最小、最大、平均、カウント)をデータベースに保存する期間を指定します(1日から25年)。古いデータはハウスキーパーによって削除されます。保存は秒単位で行われます。
時間のサフィックスがサポートされています(例: 24h、1d)。 ユーザーマクロがサポートされています。
保存期間の値は、管理 → 一般 → ハウスキーパーでグローバルに上書きできます。
グローバル上書き設定が存在する場合、オレンジ色の情報アイコンが表示されます。マウスをその上に置くと、次で上書き データの保存期間設定(全体設定) (7d)などの警告メッセージが表示されます。
注: トレンドの保持は、数値以外のデータ(文字、ログ、テキスト)では使用できません。
ヒストリとトレンドも参照してください。
値のマッピング このアイテムに値マッピングを適用します。値マッピングは受信した値を変更せず、データの表示のみを目的としています。
これは、数値(符号なし)数値(浮動小数点)、および文字アイテムで機能します。
たとえば、"Windows service states"などです。
ログの時間の形式 ログタイプのアイテムにのみ使用できます。サポートされているプレースホルダー:
* y: 年 (1970-2038)
* M: 月 (01-12)
* d: 日 (01-31)
* h: 時間 (00-23)
* m: 分 (00-59)
* s: 秒 (00-59)
空白のままにすると、タイムスタンプは解析されません。
たとえば、Zabbixエージェントログファイルの次の行を考えてみましょう:
" 23480:20100328:154718.045 Zabbix agent started. Zabbix 1.8.2 (revision 11211)."
これはPIDの6つの文字位置で始まり、日付、時刻、および行の残りの部分で指定します。
この行のログ時刻の形式は、"pppppp:yyyyMMdd:hhmmss"になります。
"p"および":"文字は単なるプレースホルダーであり、"yMdhms"以外の任意の文字にできることに注意してください。
ホストインベントリフィールドの自動設定 アイテムの値を入力するホストインベントリフィールドを選択できます。これは、ホストの自動インベントリ入力が有効になっている場合に機能します。
このフィールドは、情報の種類 が「ログ」に設定されている場合は使用できません。
説明 アイテムの説明を入力します。 ユーザーマクロがサポートされています。
有効 チェックボックスをオンにするとアイテムが有効になり、監視が実行されます。
最新データ リンクをクリックすると、アイテムの最新データが表示されます。
このリンクは、既存のアイテムを編集する場合にのみ使用できます。

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

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

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

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

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

テスト

アイテムテストを実行するには、サーバーとプロキシのシステム時間が同期していることを確認してください。 サーバーの時間が遅れている場合、アイテムテストは"タスクの有効期限切れ"エラーメッセージを返す場合があります。 ただし、サーバーとプロキシで異なるタイムゾーンを設定しても、テストの結果には影響しません。

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

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

アイテムのテストは、以下のパッシブアイテムのタイプに対応しています。

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

アイテムをテストするには、アイテム設定画面の下部にあるテストボタンをクリックします。テストボタンは、テストできないアイテム(アクティブチェックや除外されたシンプルチェックなど)については、無効になります。

アイテムテストフォームには、必要なホストパラメーター(ホストアドレス、ポート、プロキシ名/プロキシなし)、およびアイテム固有の詳細(SNMPv2コミュニティやSNMPv3セキュリティ認証など)のフィールドがあります。これらのフィールドはコンテキストを認識します:

  • 値は、可能な限り事前に入力されています。エージェントが必要なアイテムについては、ホストで選択されたエージェントインターフェースから情報を取得します。
  • テンプレートアイテムの値は、手動で入力する必要があります。
  • プレーンテキストのマクロ値は解決されます。
  • 値(または値の一部)がシークレットまたはVaultマクロであるフィールドは空で、手動で入力する必要があります。アイテムパラメーターにシークレットマクロ値が含まれている場合、次のような警告メッセージが表示されます: "アイテムは秘密な値を持つユーザー定義マクロを含んでいます。これらのマクロの値は手動で入力する必要があります。"
  • フィールドは、アイテムのタイプによって必要ない場合は無効になります (たとえば、ホストアドレスのフィールドとプロキシのフィールドは、計算アイテムで無効になります) 。

アイテムをテストするには、値の取得をクリックします。値の取得に成功すると、フィールドに入力され、現在の値(存在する場合)が前の値フィールドに移動し、同時に前の時間フィールド、すなわち2つの値の時間差(クリック)を計算します。そしてEOLシーケンスを検出し、"\n\r"を検出した場合、CRLFに置き換えようとします。

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

ホストから正常に取得された値は、保存前処理のテストに使用することも可能です。

フォームのボタン

フォームの下部にあるボタンで、いくつかの操作を行うことができます。

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

テキストデータの制限

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

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

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

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

Database 文字数の上限 バイト数の上限
MySQL 65535 65535
Oracle Database 2048 4000
PostgreSQL 65535 制限なし
SQLite (Zabbixプロキシのみ) 65535 制限なし

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

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

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

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