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' に設定できます。'0' に設定され、かつ 0 以外の値を持つカスタム間隔（柔軟またはスケジュール）が存在する場合、そのカスタム間隔の期間中にアイテムがポーリングされます。注: アイテムが有効になった直後、または更新間隔を変更した直後の最初のポーリングは、設定値より早く実行される場合があります。新しいアイテムは、Scheduling または Flexible の更新間隔を持ち、かつ 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) のような警告メッセージが表示されます。データベース内の値履歴サイズを抑えるため、記録値はできるだけ短い期間だけ保持することを推奨します。長い値履歴を保存する代わりに、より長期間のトレンドを保存できます。詳細は履歴とトレンドも参照してください。
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）ではトレンドの保持は利用できません。詳細は履歴とトレンドも参照してください。
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 エージェントのログファイルの次の行を考えます。 " 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 タブでは、アイテムレベルのタグを定義できます。

アイテム値の前処理

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

アイテムのテスト

アイテムのテストを実行するには、サーバーとプロキシのシステム時刻が同期されていることを確認してください。サーバー時刻が遅れている場合、アイテムのテストで "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 フィールドに移されます。同時に、2つの値（クリック）間の時間差である Prev. time フィールドが計算され、取得した値に "\n\r" が検出された場合はEOLシーケンスの検出が試みられ、CRLFに切り替えられます。

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

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

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

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

フォームのボタン

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


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

テキストデータの制限

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

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

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

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

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

アイテムのタイムアウト

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

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

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

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

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

タイムアウトの優先順位

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

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

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

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

Zabbixエージェント（パッシブチェックとアクティブチェックの両方）
SNMPエージェント（レガシーSNMPチェック¹を除く）
シンプルチェック（icmpping* および VMware アイテム²を除く）
SSHエージェント
Telnetエージェント
外部チェック
データベースモニタ
スクリプト
HTTPエージェント
ブラウザ

¹ レガシーSNMPチェック（単一OIDポーリング）では、サーバーまたはプロキシのタイムアウト設定が適用されます。
² icmpping* アイテムでは、タイムアウト値はアイテムキー内で直接指定されます。VMware監視アイテムでは、サーバーまたはプロキシの設定にある専用の VMwareTimeout パラメータが使用されます。

未サポートのアイテム

未サポートのアイテムは、Not supported ステータスとして報告され、標準の Update interval で引き続き再チェックされます。

何らかの理由で値を取得できない場合、アイテムは未サポートになります（例: 接続エラー、そのアイテムを処理するためのポーラーが設定されていない）。さらに、ヒストリカルデータを受信しないアイテムは、Not supported ステータスのままになります。これは想定された動作であり、アイテムが Normal ステータスに遷移するのは、新しい有効なヒストリカルデータを受信した場合のみです。

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

What’s next?

1 アイテムキーのフォーマット

Docs

1 アイテムの作成

概要

設定