1 アイテムの作成

概要

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

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

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

設定

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

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

パラメータ	説明
名前	アイテムの名前を設定します。
タイプ	アイテムのタイプです。それぞれのアイテムタイプセクションを参照してください。
キー	アイテムキーです(2048文字まで)。 サポートされているアイテムキーは、それぞれのセクションに記載されています。 キーは、1つのホスト内で一意である必要があります。 キータイプが「Zabbixエージェント」、「Zabbixエージェント(アクティブ)」、「シンプルチェック」の場合、ZabbixエージェントかZabbixサーバーがキーの値をサポートしている必要があります。 正しいキーのフォーマットも参照してください。
データ型	保存前処理を行った後にデータベースに保存されるデータの型。 数値(整数) - 64ビットの符号なし整数 数値(浮動小数) - 64ビットの浮動小数点数。 この型は約15桁の精度を持ち、範囲は約-1.79E+308から1.79E+308です（PostgreSQL 11以前のバージョンを除く）。 科学的記法での値の受け取りもサポートされています。例: 1.23E+7、1e308、1.1E-4。 文字列 - 短いテキストデータ ログ - オプションのログ関連プロパティ（タイムスタンプ、source、severity、logeventid）を持つ長いテキストデータ。 テキスト - 長いテキスト・データ。テキスト・データの制限も参照してください。 ある特定の形式でのみデータを返すアイテムキーの場合、一致する情報タイプが自動的に選択されます。
ホストインターフェース	ホスト・インターフェースを選択します。このフィールドは、ホストレベルでアイテムを編集するときに使用できます。
単位	したがって、単位が 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 日、hh:mm:ss」に変換されます。 たとえば、881764 (秒) の値を受け取った場合、「10 日、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 サービス状態」などです。
ログの時間の形式	ログ タイプのアイテムにのみ使用できます。サポートされているプレースホルダー: * y: 年 (1970-2038) * M: 月 (01-12) * d: 日 (01-31) * h: 時間 (00-23) * m: 分 (00-59) * s: 秒 (00-59) 空白のままにすると、タイムスタンプは解析されません。 たとえば、Zabbix エージェント ログ ファイルの次の行を考えてみましょう: " 23480:20100328:154718.045 Zabbix エージェントが起動しました。Zabbix 1.8.2 (リビジョン 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に置き換えようとします。

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

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

フォームのボタン

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

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

テキストデータの制限

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

単位変換

デフォルトでは、項目の単位を指定すると、乗数の接頭辞が追加されます。
例えば、入力値 '2048' に単位 'B' を指定した場合、'2KB' と表示されます。

単位を変換しないようにするには、!という接頭語を使用します。例えば !B のように。
感嘆符の有無にかかわらず，変換がどのように行われるかを理解するために，次の値と単位の例を参照してください。

1024 !B → 1024 B
       1024 B → 1 KB
       61 !s → 61 s
       61 s → 1m 1s
       0 !uptime → 0 uptime
       0 uptime → 00:00:00
       0 !! → 0 !
       0 ! → 0

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

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

サポート対象外の項目

何らかの理由で値が取得できない項目は、サポート対象外になることがあります。 このような項目は、標準的な 監視間隔で再チェックされます。

サポート対象外のアイテムは、取得不可のステータスで報告されます。