LLD ruleオブジェクト
次のオブジェクトは、discoveryruleAPIに直接関連しています。
LLDルール
低レベルディスカバリールールオブジェクトには、以下のプロパティがあります。
| プロパティ | 型 | 説明 |
|---|---|---|
| itemid | ID | LLDルールのID。 プロパティの動作: - 読み取り専用 - 更新操作時は必須 |
| delay | string | LLDルールの更新間隔。 秒または単位付きの時間(例:30s、1m、2h、1d)、およびオプションで1つ以上のカスタム間隔をセミコロンで区切って指定できます。カスタム間隔は柔軟間隔とスケジューリング間隔の混在が可能です。 ユーザーマクロが使用可能です。使用する場合、値は単一のマクロでなければなりません。複数のマクロやテキストと混在したマクロはサポートされません。柔軟間隔はスラッシュで区切った2つのマクロとして記述できます(例: {$FLEX_INTERVAL}/{$FLEX_PERIOD})。例: 1h;wd1-5h9-18;{$Macro1}/1-7,00:00-24:00;0/6-7,12:00-24:00;{$Macro2}/{$Macro3}プロパティの動作: - typeが"Zabbixエージェント"(0)、"シンプルチェック"(3)、"Zabbix内部"(5)、"外部チェック"(10)、"データベース監視"(11)、"IPMIエージェント"(12)、"SSHエージェント"(13)、"TELNETエージェント"(14)、"JMXエージェント"(16)、"HTTPエージェント"(19)、"SNMPエージェント"(20)、"スクリプト"(21)、"ブラウザ"(22)の場合、またはtypeが"Zabbixエージェント(アクティブ)"(7)でkey_に"mqtt.get"が含まれていない場合は必須 |
| hostid | ID | LLDルールが属するホストのID。 プロパティの動作: - 定数 - 作成操作時は必須 |
| flags | integer | ディスカバリールールの由来。 可能な値: 1 - 低レベルディスカバリールール; 5 - プロトタイプから変換された低レベルディスカバリールール。 プロパティの動作: - 読み取り専用 |
| interfaceid | ID | LLDルールのホストインターフェースのID。 プロパティの動作: - LLDルールがホストに属し、 typeが"Zabbixエージェント"、"IPMIエージェント"、"JMXエージェント"、"SNMPエージェント"の場合は必須- LLDルールがホストに属し、 typeが"シンプルチェック"、"外部チェック"、"SSHエージェント"、"TELNETエージェント"、"HTTPエージェント"の場合はサポート |
| key_ | string | LLDルールのキー。 プロパティの動作: - 作成操作時は必須 - 継承オブジェクトの場合は読み取り専用 |
| name | string | LLDルールの名前。 プロパティの動作: - 作成操作時は必須 - 継承オブジェクトの場合は読み取り専用 |
| type | integer | LLDルールのタイプ。 可能な値: 0 - Zabbixエージェント; 2 - Zabbixトラッパー; 3 - シンプルチェック; 5 - Zabbix内部; 7 - Zabbixエージェント(アクティブ); 10 - 外部チェック; 11 - データベース監視; 12 - IPMIエージェント; 13 - SSHエージェント; 14 - TELNETエージェント; 16 - JMXエージェント; 18 - 依存アイテム; 19 - HTTPエージェント; 20 - SNMPエージェント; 21 - スクリプト; 22 - ブラウザ; 23 - ネスト。親がテンプレート(ディスカバリ時にホストプロトタイプにリンクされると想定)またはディスカバリ済みホスト(ルートにLLDルールを持つ)の場合のみ許可されます。 プロパティの動作: - 作成操作時は必須 - 継承オブジェクトの場合は読み取り専用 |
| url | string | URL文字列。 ユーザーマクロ、{HOST.IP}、{HOST.CONN}、{HOST.DNS}、{HOST.HOST}、{HOST.NAME}、{HOST.PORT}、{ITEM.ID}、{ITEM.KEY}をサポート。 プロパティの動作: - typeが"HTTPエージェント"の場合は必須- 継承オブジェクトの場合は読み取り専用 |
| allow_traps | integer | トラッパーアイテムと同様に値の受信を許可するかどうか。 可能な値: 0 - (デフォルト) 受信データの受け入れを許可しない; 1 - 受信データの受け入れを許可する。 プロパティの動作: - typeが"HTTPエージェント"の場合はサポート |
| authtype | integer | 認証方式。typeが"SSHエージェント"の場合の可能な値:0 - (デフォルト) パスワード; 1 - 公開鍵。 typeが"HTTPエージェント"の場合の可能な値:0 - (デフォルト) なし; 1 - ベーシック; 2 - NTLM; 3 - Kerberos; 4 - ダイジェスト。 プロパティの動作: - typeが"SSHエージェント"または"HTTPエージェント"の場合はサポート- 継承オブジェクトの場合は読み取り専用( typeが"HTTPエージェント"の場合) |
| description | string | LLDルールの説明。 |
| error | string | LLDルール値の更新時に問題があった場合のエラーテキスト。 プロパティの動作: - 読み取り専用 |
| follow_redirects | integer | データ取得時にレスポンスのリダイレクトを追従するかどうか。 可能な値: 0 - リダイレクトを追従しない; 1 - (デフォルト) リダイレクトを追従する。 プロパティの動作: - typeが"HTTPエージェント"の場合はサポート- 継承オブジェクトの場合は読み取り専用 |
| headers | array | HTTPリクエスト実行時に送信されるヘッダーの配列。 プロパティの動作: - typeが"HTTPエージェント"の場合はサポート- 継承オブジェクトの場合は読み取り専用 |
| http_proxy | string | HTTP(S)プロキシ接続文字列。 プロパティの動作: - typeが"HTTPエージェント"の場合はサポート- 継承オブジェクトの場合は読み取り専用 |
| ipmi_sensor | string | IPMIセンサー。 プロパティの動作: - typeが"IPMIエージェント"でkey_が"ipmi.get"でない場合は必須- typeが"IPMIエージェント"の場合はサポート- 継承オブジェクトの場合は読み取り専用 |
| jmx_endpoint | string | JMXエージェントのカスタム接続文字列。 デフォルト:service:jmx:rmi:///jndi/rmi://{HOST.CONN}:{HOST.PORT}/jmxrmi プロパティの動作: - typeが"JMXエージェント"の場合はサポート |
| lifetime | string | ディスカバリされなくなったアイテムが削除されるまでの期間。秒、単位付きの時間、またはユーザーマクロを指定可能。 デフォルト: 7d。 |
| lifetime_type | integer | 失われたLLDリソースを削除するシナリオ。 可能な値: 0 - (デフォルト) 有効期間しきい値到達後に削除; 1 - 削除しない; 2 - 即時削除。 |
| enabled_lifetime | string | ディスカバリされなくなったアイテムが無効化されるまでの期間。秒、単位付きの時間、またはユーザーマクロを指定可能。 デフォルト: 0。 |
| enabled_lifetime_type | integer | 失われたLLDリソースを無効化するシナリオ。 可能な値: 0 - 有効期間しきい値到達後に無効化; 1 - 無効化しない; 2 - (デフォルト) 即時無効化。 |
| master_itemid | ID | マスターアイテムのID。 ディスカバリールールは他のディスカバリールールのマスターアイテムにはなれません。 プロパティの動作: - typeが"依存アイテム"の場合は必須- 継承オブジェクトの場合は読み取り専用 |
| output_format | integer | レスポンスをJSONに変換するかどうか。 可能な値: 0 - (デフォルト) 生データを保存; 1 - JSONに変換。 プロパティの動作: - typeが"HTTPエージェント"の場合はサポート- 継承オブジェクトの場合は読み取り専用 |
| params | string | LLDルールのタイプに応じた追加パラメータ: - SSHおよびTelnet LLDルールの場合は実行スクリプト; - データベース監視LLDルールの場合はSQLクエリ; - 計算LLDルールの場合は式; - スクリプトおよびブラウザLLDルールの場合はスクリプト。 プロパティの動作: - typeが"データベース監視"、"SSHエージェント"、"TELNETエージェント"、"スクリプト"、"ブラウザ"の場合は必須- 継承オブジェクトの場合は読み取り専用( typeが"スクリプト"または"ブラウザ"の場合) |
| parameters | object/array | typeが"スクリプト"または"ブラウザ"の場合の追加パラメータ。nameとvalueプロパティを持つオブジェクトの配列で、nameは一意でなければなりません。プロパティの動作: - typeが"スクリプト"または"ブラウザ"の場合はサポート- 継承オブジェクトの場合は読み取り専用 |
| password | string | 認証用パスワード。 プロパティの動作: - typeが"JMXエージェント"でusernameが設定されている場合は必須- typeが"シンプルチェック"、"データベース監視"、"SSHエージェント"、"TELNETエージェント"、"HTTPエージェント"の場合はサポート- 継承オブジェクトの場合は読み取り専用( typeが"HTTPエージェント"の場合) |
| post_type | integer | postsプロパティに格納されるPOSTデータボディのタイプ。可能な値: 0 - (デフォルト) 生データ; 2 - JSONデータ; 3 - XMLデータ。 プロパティの動作: - typeが"HTTPエージェント"の場合はサポート- 継承オブジェクトの場合は読み取り専用 |
| posts | string | HTTP(S)リクエストボディデータ。 プロパティの動作: - typeが"HTTPエージェント"でpost_typeが"JSONデータ"または"XMLデータ"の場合は必須- typeが"HTTPエージェント"でpost_typeが"生データ"の場合はサポート- 継承オブジェクトの場合は読み取り専用 |
| privatekey | string | 秘密鍵ファイル名。 プロパティの動作: - typeが"SSHエージェント"でauthtypeが"公開鍵"の場合は必須 |
| publickey | string | 公開鍵ファイル名。 プロパティの動作: - typeが"SSHエージェント"でauthtypeが"公開鍵"の場合は必須 |
| query_fields | array | HTTPリクエスト実行時に送信されるクエリフィールドの配列。 プロパティの動作: - typeが"HTTPエージェント"の場合はサポート- 継承オブジェクトの場合は読み取り専用 |
| request_method | integer | リクエストメソッドのタイプ。 可能な値: 0 - (デフォルト) GET; 1 - POST; 2 - PUT; 3 - HEAD。 プロパティの動作: - typeが"HTTPエージェント"の場合はサポート- 継承オブジェクトの場合は読み取り専用 |
| retrieve_mode | integer | レスポンスのどの部分を保存するか。request_methodが"GET"、"POST"、"PUT"の場合の可能な値:0 - (デフォルト) ボディ; 1 - ヘッダー; 2 - ボディとヘッダーの両方を保存。 request_methodが"HEAD"の場合の可能な値:1 - ヘッダー。 プロパティの動作: - typeが"HTTPエージェント"の場合はサポート- 継承オブジェクトの場合は読み取り専用 |
| snmp_oid | string | SNMP OID。 プロパティの動作: - typeが"SNMPエージェント"の場合は必須- 継承オブジェクトの場合は読み取り専用 |
| ssl_cert_file | string | 公開SSLキーのファイルパス。 プロパティの動作: - typeが"HTTPエージェント"の場合はサポート- 継承オブジェクトの場合は読み取り専用 |
| ssl_key_file | string | 秘密SSLキーのファイルパス。 プロパティの動作: - typeが"HTTPエージェント"の場合はサポート- 継承オブジェクトの場合は読み取り専用 |
| ssl_key_password | string | SSLキーのパスワード。 プロパティの動作: - typeが"HTTPエージェント"の場合はサポート- 継承オブジェクトの場合は読み取り専用 |
| state | integer | LLDルールの状態。 可能な値: 0 - (デフォルト) 正常; 1 - サポートされていない。 プロパティの動作: - 読み取り専用 |
| status | integer | LLDルールのステータス。 可能な値: 0 - (デフォルト) 有効なLLDルール; 1 - 無効なLLDルール。 |
| status_codes | string | カンマ区切りの必要なHTTPステータスコードの範囲。カンマ区切りリストの一部としてユーザーマクロもサポート。 例:200,200-{$M},{$M},200-400 プロパティの動作: - typeが"HTTPエージェント"の場合はサポート- 継承オブジェクトの場合は読み取り専用 |
| templateid | ID | 親テンプレートLLDルールのID。 プロパティの動作: - 読み取り専用 |
| timeout | string | アイテムデータ取得リクエストのタイムアウト。 秒または単位付きの時間(例:30s、1m)を指定可能。ユーザーマクロも使用可能。 可能な値の範囲:1-600s。 デフォルト:"" - プロキシ/グローバル設定を使用。 プロパティの動作: - typeが"Zabbixエージェント"(0)、"シンプルチェック"(3)でkey_が"vmware."または"icmpping"で始まらない場合、"Zabbixエージェント(アクティブ)"(7)、"外部チェック"(10)、"データベース監視"(11)、"SSHエージェント"(13)、"TELNETエージェント"(14)、"HTTPエージェント"(19)、"SNMPエージェント"(20)でsnmp_oidが"walk["または"get["で始まる場合、"スクリプト"(21)、"ブラウザ"(22)の場合はサポート- 継承オブジェクトの場合は読み取り専用 |
| trapper_hosts | string | 許可されたホスト。 プロパティの動作: - typeが"Zabbixトラッパー"、またはtypeが"HTTPエージェント"でallow_trapsが"受信データの受け入れを許可する"の場合はサポート |
| username | string | 認証用ユーザー名。 プロパティの動作: - typeが"SSHエージェント"、"TELNETエージェント"、またはtypeが"JMXエージェント"でpasswordが設定されている場合は必須- typeが"シンプルチェック"、"データベース監視"、"HTTPエージェント"の場合はサポート- 継承オブジェクトの場合は読み取り専用( typeが"HTTPエージェント"の場合) |
| uuid | string | インポートされたLLDルールを既存のものにリンクするためのユニバーサル一意識別子。指定しない場合は自動生成。 プロパティの動作: - LLDルールがテンプレートに属する場合はサポート |
| verify_host | integer | 接続先のホスト名が証明書のものと一致するか検証するかどうか。 可能な値: 0 - (デフォルト) 検証しない; 1 - 検証する。 プロパティの動作: - typeが"HTTPエージェント"の場合はサポート- 継承オブジェクトの場合は読み取り専用 |
| verify_peer | integer | ホストの証明書が正当かどうか検証するかどうか。 可能な値: 0 - (デフォルト) 検証しない; 1 - 検証する。 プロパティの動作: - typeが"HTTPエージェント"の場合はサポート- 継承オブジェクトの場合は読み取り専用 |
HTTP header
ヘッダーオブジェクトには以下のプロパティがあります。
HTTP query field
クエリフィールドオブジェクトは、URL パラメータを指定するために使用される名前と値を定義します。 以下のプロパティがあります。
LLDルールフィルター
LLDルールフィルターオブジェクトは、検出されたオブジェクトをフィルタリングするために使用できる条件のセットを定義します。 以下のプロパティがあります:
| プロパティ | タイプ | 説明 |
|---|---|---|
| conditions | object/array | 結果をフィルタリングするために使用するフィルター条件のセット。条件は式内での配置順にソートされます。 プロパティの動作: - 必須 |
| evaltype | integer | フィルター条件の評価方法。 可能な値: 0 - And/Or; 1 - And; 2 - Or; 3 - カスタム式。 プロパティの動作: - 必須 |
| eval_formula | string | フィルター条件を評価するために使用される生成された式。式には、formulaidで特定のフィルター条件を参照するIDが含まれます。eval_formulaの値は、カスタム式のフィルターのformulaの値と等しくなります。プロパティの動作: - 読み取り専用 |
| formula | string | カスタム式のフィルター条件を評価するために使用されるユーザー定義の式。式には、formulaidで特定のフィルター条件を参照するIDが含まれている必要があります。式で使用されるIDは、フィルター条件で定義されたものと完全に一致している必要があります: 未使用または省略された条件はありません。プロパティの動作: - evaltypeが「カスタム式」に設定されている場合は必須 |
LLDルールフィルター条件
LLDルールフィルター条件オブジェクトは、LLDマクロの値に対して実行する個別のチェックを定義します。 以下のプロパティがあります:
| プロパティ | タイプ | 説明 |
|---|---|---|
| macro | string | チェックを実行するLLDマクロ。 プロパティの動作: - 必須 |
| value | string | 比較する値。 プロパティの動作: - operatorが「正規表現に一致」または「正規表現に一致しない」に設定されている場合は必須 |
| formulaid | string | カスタム式から条件を参照するために使用される任意の一意なID。大文字のみ使用可能。フィルター条件を変更する際はユーザーがIDを定義する必要がありますが、その後条件を取得する際には新たに生成されます。 プロパティの動作: - LLDルールフィルターオブジェクトの evaltypeが「カスタム式」に設定されている場合は必須 |
| operator | integer | 条件演算子。 指定可能な値: 8 - (デフォルト) 正規表現に一致; 9 - 正規表現に一致しない; 12 - 存在する; 13 - 存在しない。 |
さまざまなタイプの式でフィルターを使用する方法をよりよく理解するには、discoveryrule.getおよびdiscoveryrule.createメソッドページの例を参照してください。
LLDマクロパス
LLDマクロパスには以下のプロパティがあります。
LLDルールのプリプロセス
LLDルールのプリプロセスオブジェクトには、以下のプロパティがあります。
| プロパティ | 型 | 説明 |
|---|---|---|
| type | integer | プリプロセスオプションのタイプ。 設定可能な値: 5 - 正規表現; 11 - XML XPath; 12 - JSONPath; 14 - 正規表現に一致; 15 - 正規表現に一致しない; 16 - JSONのエラーをチェック; 17 - XMLのエラーをチェック; 20 - ハートビート付きで変更なしを破棄; 21 - JavaScript; 23 - PrometheusからJSONへ; 24 - CSVからJSONへ; 25 - 置換; 27 - XMLからJSONへ; 28 - SNMP walk値; 29 - SNMP walkからJSONへ; 30 - SNMP get値。 プロパティの動作: - 必須 |
| params | string | プリプロセスオプションで使用される追加パラメータ。複数のパラメータは改行(\n)で区切ります。 プロパティの動作: - typeが"正規表現"(5)、"XML XPath"(11)、"JSONPath"(12)、"正規表現に一致"(14)、"正規表現に一致しない"(15)、"JSONのエラーをチェック"(16)、"XMLのエラーをチェック"(17)、"ハートビート付きで変更なしを破棄"(20)、"JavaScript"(21)、"PrometheusからJSONへ"(23)、"CSVからJSONへ"(24)、"置換"(25)、"SNMP walk値"(28)、"SNMP walkからJSONへ"(29)、または"SNMP get値"(30)に設定されている場合は必須 |
| error_handler | integer | プリプロセスステップが失敗した場合に使用されるアクションタイプ。 設定可能な値: 0 - Zabbixサーバーによるエラーメッセージの設定; 1 - 値を破棄; 2 - カスタム値を設定; 3 - カスタムエラーメッセージを設定。 プロパティの動作: - typeが"正規表現"(5)、"XML XPath"(11)、"JSONPath"(12)、"正規表現に一致"(14)、"正規表現に一致しない"(15)、"JSONのエラーをチェック"(16)、"XMLのエラーをチェック"(17)、"PrometheusからJSONへ"(23)、"CSVからJSONへ"(24)、"XMLからJSONへ"(27)、"SNMP walk値"(28)、"SNMP walkからJSONへ"(29)、または"SNMP get値"(30)に設定されている場合は必須 |
| error_handler_params | string | エラーハンドラのパラメータ。 プロパティの動作: - error_handlerが"カスタム値を設定"または"カスタムエラーメッセージを設定"に設定されている場合は必須 |
各プリプロセスタイプでサポートされるパラメータとエラーハンドラは以下の通りです。
| プリプロセスタイプ | 名前 | パラメータ1 | パラメータ2 | パラメータ3 | サポートされるエラーハンドラ |
|---|---|---|---|---|---|
| 5 | 正規表現 | pattern1 | output2 | 0, 1, 2, 3 | |
| 11 | XML XPath | path3 | 0, 1, 2, 3 | ||
| 12 | JSONPath | path3 | 0, 1, 2, 3 | ||
| 14 | 正規表現に一致 | pattern1 | 0, 1, 2, 3 | ||
| 15 | 正規表現に一致しない | pattern1 | 0, 1, 2, 3 | ||
| 16 | JSONのエラーをチェック | path3 | 0, 1, 2, 3 | ||
| 17 | XMLのエラーをチェック | path3 | 0, 1, 2, 3 | ||
| 20 | ハートビート付きで変更なしを破棄 | seconds4,\ 5 | |||
| 21 | JavaScript | script2 | |||
| 23 | PrometheusからJSONへ | pattern5,\ 6 | 0, 1, 2, 3 | ||
| 24 | CSVからJSONへ | character2 | character2 | 0,1 | 0, 1, 2, 3 |
| 25 | 置換 | search string2 | replacement2 | ||
| 27 | XMLからJSONへ | 0, 1, 2, 3 | |||
| 28 | SNMP walk値 | OID2 | フォーマット: 0 - 変更なし 1 - Hex-STRINGからUTF-8 2 - Hex-STRINGからMAC 3 - BITSから整数 |
0, 1, 2, 3 | |
| 29 | SNMP walkからJSONへ7 | フィールド名2 | OIDプレフィックス2 | フォーマット: 0 - 変更なし 1 - Hex-STRINGからUTF-8 2 - Hex-STRINGからMAC 3 - BITSから整数 |
0, 1, 2, 3 |
| 30 | SNMP get値 | フォーマット: 1 - Hex-STRINGからUTF-8 2 - Hex-STRINGからMAC 3 - BITSから整数 |
0, 1, 2, 3 | ||
1 正規表現
2 文字列
3 JSONPathまたはXML XPath
4 正の整数(時間のサフィックスをサポート、例: 30s, 1m, 2h, 1d)
5 ユーザーマクロ
6 Prometheusパターンは、<metric name>{<label name>="<label value>", ...} == <value>の構文に従います。
各Prometheusパターン要素(メトリック、ラベル名、ラベル値、メトリック値)はユーザーマクロにできます。
7 複数の"フィールド名,OIDプレフィックス,フォーマット"レコードを改行で区切って指定できます。
LLDルールのオーバーライド
LLDルールのオーバーライドオブジェクトは、さまざまなプロトタイプオブジェクトのプロパティをオーバーライドするために使用されるルール(フィルター、条件、操作)のセットを定義します。 以下のプロパティがあります:
| プロパティ | タイプ | 説明 |
|---|---|---|
| name | string | 一意のオーバーライド名。 プロパティの動作: - 必須 |
| step | integer | オーバーライドの一意の順序番号。 プロパティの動作: - 必須 |
| stop | integer | 一致した場合、次のオーバーライドの処理を停止するかどうか。 可能な値: 0 - (デフォルト) オーバーライドの処理を停止しない; 1 - フィルターが一致した場合、オーバーライドの処理を停止する。 |
| filter | object | オーバーライドフィルター。 |
| operations | object/array | オーバーライド操作。 |
LLDルールのオーバーライドフィルター
LLDルールのオーバーライドフィルターオブジェクトは、検出されたオブジェクトに一致した場合にオーバーライドが適用される条件のセットを定義します。 以下のプロパティがあります:
| プロパティ | タイプ | 説明 |
|---|---|---|
| conditions | object/array | 検出されたオブジェクトに一致させるために使用するオーバーライドフィルター条件のセット。条件は式内での配置順に並べ替えられます。 プロパティの動作: - 必須 |
| evaltype | integer | オーバーライドフィルター条件の評価方法。 可能な値: 0 - And/Or; 1 - And; 2 - Or; 3 - カスタム式。 プロパティの動作: - 必須 |
| eval_formula | string | オーバーライドフィルター条件の評価に使用される生成された式。式には、formulaidで特定のオーバーライドフィルター条件を参照するIDが含まれます。eval_formulaの値は、カスタム式のフィルターのformulaの値と等しくなります。プロパティの動作: - 読み取り専用 |
| formula | string | カスタム式のオーバーライドフィルター条件の評価に使用するユーザー定義の式。式には、formulaidで特定のオーバーライドフィルター条件を参照するIDが含まれている必要があります。式で使用されるIDは、オーバーライドフィルター条件で定義されたものと完全に一致している必要があります: いかなる条件も未使用または省略されてはなりません。プロパティの動作: - evaltypeが「カスタム式」に設定されている場合は必須 |
LLDルールのオーバーライドフィルター条件
LLDルールのオーバーライドフィルター条件オブジェクトは、LLDマクロの値に対して個別のチェックを実行するためのものです。 以下のプロパティがあります:
| プロパティ | タイプ | 説明 |
|---|---|---|
| macro | string | チェックを実行するLLDマクロ。 プロパティの動作: - 必須 |
| value | string | 比較する値。 プロパティの動作: - operatorが「正規表現に一致」または「正規表現に一致しない」に設定されている場合は必須 |
| formulaid | string | カスタム式から条件を参照するために使用される任意の一意のID。大文字のみ使用可能。フィルター条件を変更する際はユーザーがIDを定義する必要がありますが、その後リクエストする際には新たに生成されます。 プロパティの動作: - LLDルールのオーバーライドフィルターオブジェクトの evaltypeが「カスタム式」に設定されている場合は必須 |
| operator | integer | 条件演算子。 可能な値: 8 - (デフォルト) 正規表現に一致; 9 - 正規表現に一致しない; 12 - 存在する; 13 - 存在しない。 |
LLDルールのオーバーライド操作
LLDルールのオーバーライド操作は、プロトタイプオブジェクトに対して実行する条件とアクションの組み合わせです。 以下のプロパティを持ちます:
| プロパティ | タイプ | 説明 |
|---|---|---|
| operationobject | integer | アクションを実行する検出オブジェクトのタイプ。 可能な値: 0 - アイテムプロトタイプ; 1 - トリガープロトタイプ; 2 - グラフプロトタイプ; 3 - ホストプロトタイプ; 4 - ディスカバリプロトタイプ。 プロパティの動作: - 必須 |
| operator | integer | オーバーライド条件の演算子。 可能な値: 0 - (デフォルト) 等しい; 1 - 等しくない; 2 - 含む; 3 - 含まない; 8 - マッチする; 9 - マッチしない。 |
| value | string | 選択したオブジェクトに応じて、アイテム、トリガー、グラフ、またはホストプロトタイプ名にマッチするパターン。 |
| opstatus | object | アイテム、トリガー、ホストプロトタイプオブジェクトのオーバーライド操作ステータスオブジェクト。 |
| opdiscover | object | オーバーライド操作の検出ステータスオブジェクト(すべてのオブジェクトタイプ)。 |
| opperiod | object | アイテムプロトタイプオブジェクトのオーバーライド操作期間(更新間隔)オブジェクト。 |
| ophistory | object | アイテムプロトタイプオブジェクトのオーバーライド操作履歴オブジェクト。 |
| optrends | object | アイテムプロトタイプオブジェクトのオーバーライド操作トレンドオブジェクト。 |
| opseverity | object | トリガープロトタイプオブジェクトのオーバーライド操作重大度オブジェクト。 |
| optag | object/array | トリガーおよびホストプロトタイプオブジェクトのオーバーライド操作タグオブジェクト。 |
| optemplate | object/array | ホストプロトタイプオブジェクトのオーバーライド操作テンプレートオブジェクト。 |
| opinventory | object | ホストプロトタイプオブジェクトのオーバーライド操作インベントリオブジェクト。 |
LLDルールのオーバーライド操作ステータス
LLDルールのオーバーライド操作ステータスは、検出されたオブジェクトに設定されます。 以下のプロパティがあります:
LLDルールのオーバーライド操作のディスカバー
LLDルールのオーバーライド操作で、検出されたオブジェクトに設定されるディスカバーステータスです。 以下のプロパティがあります。
| プロパティ | タイプ | 説明 |
|---|---|---|
| discover | integer | 選択したオブジェクトのディスカバーステータスをオーバーライドします。 可能な値: 0 - はい、オブジェクトのディスカバリーを継続する; 1 - いいえ、新しいオブジェクトはディスカバリーされず、既存のオブジェクトはロストとしてマークされる。 プロパティの動作: - 必須 |
LLDルールのオーバーライド操作期間
LLDルールのオーバーライド操作期間は、検出されたアイテムに設定される更新間隔値です。 以下のプロパティがあります。
| プロパティ | タイプ | 説明 |
|---|---|---|
| delay | string | アイテムプロトタイプの更新間隔を上書きします。 秒またはサフィックス付きの時間単位(例:30s、1m、2h、1d)、およびオプションで1つ以上のカスタム間隔をセミコロンで区切って指定できます。カスタム間隔は、柔軟な間隔とスケジューリング間隔を混在させることができます。 ユーザーマクロまたはLLDマクロを使用できます。使用する場合、値は単一のマクロでなければなりません。複数のマクロやテキストと混在したマクロはサポートされていません。柔軟な間隔は、スラッシュで区切った2つのマクロとして記述できます(例: {$FLEX_INTERVAL}/{$FLEX_PERIOD})。例: 1h;wd1-5h9-18;{$Macro1}/1-7,00:00-24:00;0/6-7,12:00-24:00;{$Macro2}/{$Macro3}プロパティの動作: - 必須 |
LLDルールのオーバーライド操作履歴
検出されたアイテムに設定されるLLDルールのオーバーライド操作履歴値です。 以下のプロパティがあります:
| プロパティ | タイプ | 説明 |
|---|---|---|
| history | string | アイテムプロトタイプの履歴をオーバーライドします。これは履歴データを保存する期間の時間単位です。ユーザーマクロやLLDマクロも受け付けます。 プロパティの動作: - 必須 |
LLDルールのオーバーライド操作のトレンド
LLDルールのオーバーライド操作のトレンド値は、ディスカバリされたアイテムに設定されます。 以下のプロパティがあります。
| プロパティ | タイプ | 説明 |
|---|---|---|
| trends | string | トレンドデータを保存する期間の単位であるアイテムプロトタイプのトレンドをオーバーライドします。ユーザーマクロおよびLLDマクロも使用できます。 プロパティの動作: - 必須 |
LLDルールのオーバーライド操作の深刻度
LLDルールのオーバーライド操作の深刻度の値は、検出されたトリガーに設定されます。 以下のプロパティがあります:
| プロパティ | タイプ | 説明 |
|---|---|---|
| severity | integer | トリガープロトタイプの深刻度をオーバーライドします。 可能な値: 0 - (デフォルト) 未分類; 1 - 情報; 2 - 警告; 3 - 軽度障害; 4 - 重度障害; 5 - 致命的障害。 プロパティの動作: - 必須 |
LLDルールのオーバーライド操作タグ
LLDルールのオーバーライド操作タグオブジェクトには、検出されたオブジェクトに設定されるタグ名と値が含まれます。 以下のプロパティがあります。
LLDルールのオーバーライド操作テンプレート
検出されたホストにリンクされているLLDルールのオーバーライド操作テンプレートオブジェクトです。 以下のプロパティがあります。
LLDルールのオーバーライド操作インベントリ
検出されたホストに設定されるLLDルールのオーバーライド操作インベントリモード値。 以下のプロパティがあります: