Documentation
Table of Contents
> Item prototypeオブジェクト
次のオブジェクトは、itemprototypeAPIに直接関連しています。
Item prototype
item prototype オブジェクトには次のプロパティがあります。
| プロパティ | タイプ | 説明 |
|---|---|---|
| itemid | string | (読取専用) アイテムプロトタイプID |
| delay (必須) |
string | アイテムプロトタイプの更新間隔。 秒またはサフィックス付きの時間単位 (30s、1m、2h、1d) を受け入れます。 オプションで、1 つまたは複数の カスタム間隔 を柔軟な間隔またはスケジューリングとして指定できます。 複数の間隔はセミコロンで区切ります。 ユーザーマクロを使用できます。 1 つのマクロでフィールド全体を埋める必要があります。 フィールド内の複数のマクロまたはテキストと混合されたマクロはサポートされていません。 柔軟な間隔は、スラッシュで区切られた 2 つのマクロとして記述できます (例: {$FLEX_INTERVAL}/{$FLEX_PERIOD})。Zabbix トラッパー、依存アイテム、および mqtt.get キーを使用した Zabbix エージェント (アクティブ) のオプション。 |
| hostid (required) |
string | アイテムプロトタイプが属するホストまたはテンプレートの ID 更新操作の場合、このフィールドは 読取専用 です。 |
| ruleid (required) |
string | アイテムが属する LLD ルールの ID。 更新操作の場合、このフィールドは 読取専用 です。 |
| interfaceid (必須) |
string | アイテムプロトタイプのホストインターフェースの ID ホスト アイテムプロトタイプにのみ使用されます。 Zabbix エージェント (アクティブ)、Zabbix インターナル、Zabbix トラッパー、計算、依存、データベース モニター、およびスクリプト アイテムには必要ありません。 HTTP エージェント アイテムのオプションです。 |
| key_ (required) |
string | アイテムプロトタイプキー |
| name (required) |
string | アイテムプロトタイプ名 |
| type (required) |
integer | |
| url (required) |
string | URL 文字列。HTTP エージェント アイテムプロトタイプ タイプにのみ必要です。 LLDマクロとユーザー マクロ{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 | アイテムプロトタイプの説明 |
| follow_redirects | integer | HTTP エージェント アイテム プロトタイプ フィールド。 データのプール中に応答リダイレクトに従うか 0 - リダイレクトに従いません 1 - (デフォルト) リダイレクトに従います |
| headers | object | HTTP エージェント アイテム プロトタイプ フィールド。 ヘッダー名がキーとして使用され、ヘッダー値が値として使用される、HTTP(S) 要求ヘッダーを持つオブジェクト。 例: { "User-Agent": "Zabbix" } |
| history | string | 履歴データを保存する時間の単位。 ユーザー マクロとLLDマクロを受け入れます。 デフォルト: 90d |
| http_proxy | string | HTTP エージェント アイテム プロトタイプ フィールド。 HTTP(S) プロキシ接続文字列。 |
| ipmi_sensor | string | IPMI センサー。 IPMI アイテムプロトタイプでのみ使用されます |
| jmx_endpoint | string | JMX エージェントのカスタム接続文字列。 デフォルト値: service:jmx:rmi:///jndi/rmi://{HOST.CONN}:{HOST.PORT}/jmxrmi |
| 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 で使用します。 |
| 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 キー ファイルのパスワード |
| status | integer | アイテムプロトタイプのステータス 使用可能な値: 0 - (デフォルト) 有効なアイテムプロトタイプ 1 - 無効なアイテムプロトタイプ 3 - サポートされていないアイテムプロトタイプ |
| status_codes | string | HTTP エージェントアイテムプロトタイプフィールド。 コンマで区切られた必須の HTTP ステータス コードの範囲。 コンマ区切りリストの一部としてユーザー マクロとLLDマクロもサポートします。 例: 200,200-{$M},{$M},200-400 |
| templateid | string | (読取専用) 親テンプレート アイテムプロトタイプの ID |
| timeout | string | アイテム データ ポーリング リクエストのタイムアウト。 HTTP エージェントおよびスクリプト アイテムプロトタイプに使用されます。 ユーザー マクロとLLDマクロをサポートします。 デフォルト: 3 秒 最大値: 60 秒 |
| trapper_hosts | string | 許可されたホスト。 トラッパー アイテムプロトタイプまたは HTTP エージェント アイテムプロトタイプで使用されます。 |
| trends | string | トレンド データを保存する時間の単位。 ユーザー マクロとLLDマクロも受け入れます。 デフォルト: 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 - 検証します。 |
| discover | integer | アイテムプロトタイプのディスカバリステータス。 使用可能な値: 0 - (デフォルト) 新しいアイテムが発見されます。 1 - 新しいアイテムは発見されず、既存のアイテムは紛失としてマークされます。 |
Item prototype tag
item prototype 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 ユーザーマクロ LLDマクロ
7 構文に従う Prometheus パターン: <metric name>{<label name>="<label value>", ...} == <value> 各 Prometheus パターン コンポーネント (メトリック、ラベル名、ラベル値、およびメトリック値) は、ユーザー マクロかLLDマクロにすることができます。
8 Prometheus は次の構文で出力します: <label name> (ユーザー マクロまたはLLDマクロを使用できます) label が 2 番目のパラメーターとして選択されている場合。
9 集計関数の 1 つ: sum,min,max,avg,count (function が 2 番目のパラメーターとして選択されている場合)