Sidebar

Zabbix Summit 2022
Register for Zabbix Summit 2022

> Item object

次のオブジェクトは、item API に直接関連しています。

item

Zabbix API を使用して Web アイテムを直接作成、更新、または削除することはできません。

item オブジェクトには次のプロパティがあります。

プロパティ タイプ 説明
itemid string (読取専用) アイテムID
delay
(必須)
string アイテムの更新間隔。 秒またはサフィックス付きの時間単位 (30s、1m、2h、1d) を受け入れます。
オプションで、1 つまたは複数の カスタム間隔 を柔軟な間隔またはスケジューリングとして指定できます。
複数の間隔はセミコロンで区切ります。
ユーザーマクロを使用できます。 1 つのマクロでフィールド全体を埋める必要があります。 フィールド内の複数のマクロまたはテキストと混合されたマクロはサポートされていません。
柔軟な間隔は、スラッシュで区切られた 2 つのマクロとして記述できます (例: {$FLEX_INTERVAL}/{$FLEX_PERIOD})。

Zabbix トラッパー、依存アイテム、および mqtt.get キーを使用した Zabbix エージェント (アクティブ) のオプション。
hostid
(required)
string アイテムが属するホストまたはテンプレートの ID

更新操作の場合、このフィールドは 読取専用 です。
interfaceid
(必須)
string アイテムのホストインターフェースの ID

ホスト アイテムにのみ使用されます。 Zabbix エージェント (アクティブ)、Zabbix インターナル、Zabbix トラッパー、計算、依存、データベース モニター、およびスクリプト アイテムには必要ありません。 HTTP エージェント アイテムのオプションです。
key_
(required)
string アイテムキー
name
(required)
string アイテム名
type
(required)
integer アイテムのタイプ

使用可能な値:
0 - Zabbix エージェント
2 - Zabbix トラッパー
3 - シンプル チェック
5 - Zabbix インターナル
7 - Zabbix エージェント (アクティブ)
9 - Web アイテム
10 - 外部チェック
11 - データベース監視
12 - IPMI エージェント
13 - SSH エージェント
14 - Telnet エージェント
15 - 計算済み
16 - JMX エージェント
17 - SNMP トラップ
18 - 依存アイテム
19 - HTTP エージェント
20 - SNMP エージェント
21 - スクリプト
url
(required)
string URL 文字列。HTTP エージェント アイテム タイプにのみ必要です。 ユーザー マクロ{HOST.IP}、{HOST.CONN}、{HOST.DNS}、{HOST.HOST}、{HOST.NAME}、{ITEM.ID}、{ITEM.KEY} をサポートします。
value_type
(必須)
integer アイテムの情報タイプ

使用可能な値:
0 - 浮動小数点数
1 - キャラクター
2 - ログ
3 - 符号なしの数値
4 - テキスト
allow_traps integer HTTP エージェントアイテムフィールド。 トラッパー アイテム タイプと同様に、値の入力を許可します。

0 - (デフォルト) 着信データの受け入れを許可しません。
1 - 着信データの受け入れを許可します。
authtype integer SSH エージェント アイテムまたは HTTP エージェント アイテムでのみ使用されます。

SSH エージェント認証方法の使用可能な値:
0 - (デフォルト) パスワード
1 - 公開鍵

HTTP エージェント認証方式の使用可能な値:
0 - (デフォルト) なし
1 - Basic
2 - NTLM
3 - Kerberos
description string アイテムの説明
error string (読取専用) アイテムの更新に問題がある場合のエラー テキスト
flags integer (読取専用) アイテムの起源

使用可能な値:
0 - プレーンなアイテム
4 - 発見されたアイテム
follow_redirects integer HTTP エージェントアイテムフィールド。 データのプール中に応答リダイレクトに従うか

0 - リダイレクトに従いません
1 - (デフォルト) リダイレクトに従います
headers object HTTP エージェントアイテムフィールド。 ヘッダー名がキーとして使用され、ヘッダー値が値として使用される HTTP(S) リクエスト ヘッダーを持つオブジェクト。

例:
{ "User-Agent": "Zabbix" }
history string 履歴データを保存する時間の単位。 ユーザー マクロも受け入れます。

デフォルト: 90d
http_proxy string HTTP エージェントアイテムフィールド。 HTTP(S) プロキシ接続文字列。
inventory_link integer アイテムによって入力されるホストインベントリフィールドID

サポートされているホストインベントリフィールドのリストについては、ホスト インベントリ ページ を参照してください。

デフォルト: 0。
ipmi_sensor string IPMI センサー。 IPMI アイテムでのみ使用されます
jmx_endpoint string JMX エージェントのカスタム接続文字列。

デフォルト値:
service:jmx:rmi:///jndi/rmi://{HOST.CONN}:{HOST.PORT}/jmxrmi
lastclock timestamp (読取専用) アイテムが最後に更新された時刻。

デフォルトでは、過去 24 時間以内の値のみが表示されます。 管理 → 一般設定 メニュー セクションの データの保存期間パラメータ値を変更することで、この期間を延長できます。
lastns integer (読取専用) アイテムが最後に更新されたときのナノ秒

デフォルトでは過去 24 時間以内の値のみが表示されます。 管理 → 一般設定 メニュー セクションの データの保存期間パラメータ値を変更することで、この期間を延長できます。
lastvalue string (読取専用)アイテムの最後の値

デフォルトでは過去 24 時間以内の値のみが表示されます。 管理 → 一般設定 メニュー セクションの データの保存期間パラメータ値を変更することで、この期間を延長できます。
logtimefmt string ログ エントリの時刻形式。 ログアイテムでのみ使用されます。
master_itemid integer マスター アイテム ID
最大 3 つの従属アイテムの再帰と 最大29999 の従属アイテムが許可されます

従属アイテムに必要です
output_format integer HTTP エージェントアイテムフィールド。 レスポンスを JSON に変換する必要があります。

0 - (デフォルト) そのまま保存します
1 - JSON に変換します
params string アイテムのタイプに応じた追加パラメータ:
- SSH および Telnet アイテムの実行スクリプト
- データベース監視アイテムの SQL クエリ
- 計算アイテムの式
- スクリプトのスクリプト アイテム
parameters array スクリプトアイテムの追加パラメーター。 'name' および 'value' プロパティを持つオブジェクトの配列。name は一意である必要があります
password string 認証用のパスワード。 簡易チェック、SSH、Telnet、データベース監視、JMX、HTTPエージェントのアイテムで使用
post_type integer HTTP エージェントアイテムフィールド。 posts プロパティに格納される投稿データ本体のタイプ。

0 - (デフォルト) 生データ。
2 - JSON データ。
3 - XML データ。
posts string HTTP エージェントアイテムフィールド。 HTTP(S) リクエストの本文データ。 post_type で使用します。
prevvalue string (読取専用) アイテムの以前の値

デフォルトでは過去 24 時間以内の値のみが表示されます。 管理 → 一般設定 メニュー セクションの データの保存期間パラメータ値を変更することで、この期間を延長できます。
privatekey string 秘密鍵ファイル名
publickey string 公開鍵ファイル名
query_fields array HTTP エージェントアイテムフィールド。 クエリ パラメータ。 'キー':'値'のペアを持つオブジェクトの配列。値は空の文字列にすることができます。
request_method integer HTTP エージェントアイテムフィールド。 リクエスト メソッドのタイプ。

0 - (デフォルト) GET
1 - POST
2 - PUT
3 - HEAD
retrieve_mode integer HTTP エージェントアイテムフィールド。 レスポンスのどの部分を保存するか。

0 - (デフォルト) 本文
1 - ヘッダー
2 - 本文とヘッダーの両方

request_method HEAD の場合、許可される値は 1 のみ
snmp_oid string SNMP OID.
ssl_cert_file string HTTP エージェントアイテムフィールド。 公開 SSL キーファイル パス
ssl_key_file string HTTP エージェントアイテムフィールド。 プライベート SSL キーファイル パス
ssl_key_password string HTTP エージェントアイテムフィールド。 SSL キー ファイルのパスワード
state integer (読取専用) アイテムの状態

使用可能な値:
0 - (デフォルト) 通常
1 - サポートされていません
status integer アイテムのステータス

使用可能な値:
0 - (デフォルト) 有効なアイテム
1 - 無効なアイテム
status_codes string HTTP エージェントアイテムフィールド。 コンマで区切られた必須の HTTP ステータス コードの範囲。 コンマ区切りリストの一部としてユーザー マクロもサポートします。

例: 200,200-{$M},{$M},200-400
templateid string (読取専用) 親テンプレート アイテムの ID。

ヒント: hostid プロパティを使用して、アイテムが属するテンプレートを指定します。
timeout string アイテム データ ポーリング リクエストのタイムアウト。 HTTP エージェントおよびスクリプト アイテムに使用されます。 ユーザー マクロをサポートします。

デフォルト: 3 秒
最大値: 60 秒
trapper_hosts string 許可されたホスト。 トラッパー アイテムまたは HTTP エージェント アイテムで使用されます。
trends string トレンド データを保存する時間の単位。 ユーザー マクロも受け入れます。

デフォルト: 365d
units string 値の単位
username string 認証用のユーザー名。 簡易チェック、SSH、Telnet、データベース監視、JMX、HTTPエージェントのアイテムで使用

SSH、Telnetのアイテムで必須
JMX で使用する場合、パスワードもユーザー名と一緒に指定するか、両方のプロパティを空白のままにする必要があります。
uuid string インポートされたアイテムを既存のアイテムにリンクするために使用されるユニバーサル一意識別子。 テンプレートのアイテムにのみ使用されます。 指定されていない場合は自動生成されます。

更新操作の場合、このフィールドは 読取専用 です。
valuemapid string 関連付けられた値マップID
verify_host integer HTTP エージェントアイテムフィールド。 URL のホスト名がホスト証明書の Common Name フィールドまたは Subject Alternate Name フィールドにあることを検証します。

0 - (デフォルト) 検証しません。
1 - 検証します。
verify_peer integer HTTP エージェントアイテムフィールド。 検証はホスト証明書の認証です。

0 - (デフォルト) 検証しません。
1 - 検証します。

Item tag

item tagオブジェクトには次のプロパティがあります。

プロパティ タイプ 説明
tag
(必須)
string アイテムタグ名
value string アイテムタグ値

アイテムの前処理

アイテム前処理オブジェクトには、次のプロパティがあります。

プロパティ タイプ 説明
type
(必須)
integer 前処理オプションのタイプ。

使用可能な値:
1 - カスタム乗数
2 - 右トリム
3 - 左トリム
4 - トリム
5 - 正規表現マッチング
6 - ブール値から 10 進数へ
7 - 8 進数 から10 進数へ
8 - 16 進数から 10 進数へ
9 - 単純な変更
10 - 1 秒あたりの変更
11 - XML XPath
12 - JSONPath
13 - 範囲内
14 - 正規表現に一致
15 - 正規表現に不一致
16 - JSON のエラーチェック
17 - XML のエラーチェック;
18 - 正規表現を使用したエラーチェック
19 - 変更なしで破棄
20 - ハートビートで変更されていないものを破棄
21 - JavaScript
22 - Prometheus パターン
23 - Prometheus から JSON へ<br >24 - CSV から JSONへ
25 - 置換
26 - サポートされていないチェック
27 - XML から JSONへ
params
(必須)
string 前処理オプションで使用される追加パラメーター。 複数のパラメータはLF (\n) 文字で区切られます。
error_handler
(必須)
integer 前処理ステップが失敗した場合に使用されるアクションタイプ

使用可能な値:
0 - エラー メッセージは Zabbix サーバーによって設定されます。
1 - 値を破棄します。
2 - カスタム値を設定します。
3 - カスタム エラー メッセージを設定します。
error_handler_params
(必須)
string エラー ハンドラーのパラメーター。 error_handler とともに使用されます。

error_handler が 0 または 1 の場合、空にする必要があります。
error_handler が 2 の場合、空にすることができます。
error_handler が 3 の場合、空にすることはできません。

前処理の種類ごとに、次のパラメーターとエラー ハンドラーがサポートされています。

前処理の種類 名前 パラメータ1 パラメータ2 パラメータ3 サポートするエラーハンドラ
1 カスタム乗数 number1, 6 0, 1, 2, 3
2 右トリム list of characters2
3 左トリム list of characters2
4 トリム list of characters2
5 正規表現マッチング pattern3 output2 0, 1, 2, 3
6 ブール値から10進数へ 0, 1, 2, 3
7 8 進数 から10 進数へ 0, 1, 2, 3
8 16 進数 から10 進数へ 0, 1, 2, 3
9 単純な変更 0, 1, 2, 3
10 一秒あたりの変更 0, 1, 2, 3
11 XML XPath path4 0, 1, 2, 3
12 JSONPath path4 0, 1, 2, 3
13 範囲内 min1, 6 max1, 6 0, 1, 2, 3
14 正規表現に一致 pattern3 0, 1, 2, 3
15 正規表現に不一致 pattern3 0, 1, 2, 3
16 JSONのエラーチェック path4 0, 1, 2, 3
17 XMLのエラーチェック path4 0, 1, 2, 3
18 正規表現を使用したエラーチェック pattern3 output2 0, 1, 2, 3
19 変更なしで破棄
20 ハートビートで変更されていないものを破棄 seconds5, 6
21 JavaScript script2
22 Prometheus パターン pattern6, 7 value, label, function output8, 9 0, 1, 2, 3
23 Prometheus から JSONへ pattern6, 7 0, 1, 2, 3
24 CSV から JSONへ character2 character2 0,1 0, 1, 2, 3
25 置換 search string2 replacement2
26 サポートされていないチェック 1, 2, 3
27 XML から JSONへ 0, 1, 2, 3

1 整数または浮動小数点数
2 文字列
3 正規表現
4 JSONPath または XML XPath
5 正の整数 (タイムサフィックスをサポート, 例: 30s, 1m, 2h, 1d)
6 ユーザーマクロ
7 構文に従う Prometheus パターン: <metric name>{<label name>="<label value>", ...} == <value> 各 Prometheus パターン コンポーネント (メトリック、ラベル名、ラベル値、およびメトリック値) は、ユーザー マクロにすることができます。
8 Prometheus は次の構文で出力します: <label name> (ユーザー マクロを使用できます) label が 2 番目のパラメーターとして選択されている場合。
9 集計関数の 1 つ: sum,min,max,avg,count (function が 2 番目のパラメーターとして選択されている場合)