パラメータ	説明
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'に設定され、かつゼロ以外の値を持つカスタム間隔（柔軟またはスケジュール）が存在する場合、アイテムはそのカスタム間隔の期間中にポーリングされます。注: アイテムが有効になった後、または更新間隔の変更後の最初のアイテムポーリングは、設定値より早く発生する場合があります。新しいアイテムは、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リンクをクリックすると、proxyのタイムアウト、または（プロキシを使用しない場合は）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タブでは、アイテムレベルのタグを定義できます。

アイテム値の前処理

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 アイテムの作成

概要

設定