LLD ruleオブジェクト
次のオブジェクトは、discoveryruleAPIに直接関連しています。
LLDルール
低レベルディスカバリルールオブジェクトには、以下のプロパティがあります。
| Property | Type | Description |
|---|---|---|
| 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 agent" (0)、"Simple check" (3)、"Zabbix internal" (5)、"External check" (10)、"Database monitor" (11)、"IPMI agent" (12)、"SSH agent" (13)、"TELNET agent" (14)、"JMX agent" (16)、"HTTP agent" (19)、"SNMP agent" (20)、"Script" (21)、"Browser" (22) に設定されている場合、または type が "Zabbix agent (active)" (7) に設定され、かつ key_ に "mqtt.get" が含まれない場合に 必須 |
| hostid | ID | LLDルールが属するホストのID。 プロパティの動作: - 定数 - 作成操作で 必須 |
| flags | integer | ディスカバリルールの生成元。 指定可能な値: 1 - 低レベルディスカバリルール; 5 - プロトタイプから変換された低レベルディスカバリルール。 プロパティの動作: - 読み取り専用 |
| interfaceid | ID | LLDルールのホストインターフェースのID。 プロパティの動作: - LLDルールがホストに属し、 type が "Zabbix agent"、"IPMI agent"、"JMX agent"、または "SNMP agent" に設定されている場合に 必須- LLDルールがホストに属し、 type が "Simple check"、"External check"、"SSH agent"、"TELNET agent"、または "HTTP agent" に設定されている場合に サポート |
| key_ | string | LLDルールキー。 プロパティの動作: - 作成操作で 必須 - 継承されたオブジェクトでは 読み取り専用 |
| name | string | LLDルール名。 プロパティの動作: - 作成操作で 必須 - 継承されたオブジェクトでは 読み取り専用 |
| type | integer | LLDルールのタイプ。 指定可能な値: 0 - Zabbix agent; 2 - Zabbix trapper; 3 - Simple check; 5 - Zabbix internal; 7 - Zabbix agent (active); 10 - External check; 11 - Database monitor; 12 - IPMI agent; 13 - SSH agent; 14 - TELNET agent; 16 - JMX agent; 18 - Dependent item; 19 - HTTP agent; 20 - SNMP agent; 21 - Script; 22 - Browser; 23 - Nested。このタイプは、ルールの親がテンプレート（ディスカバリ時にホストプロトタイプへリンクされることを想定）またはディスカバリされたホスト（ルートにLLDルールを持つ）の場合にのみ許可されます。 プロパティの動作: - 作成操作で 必須 - 継承されたオブジェクトでは 読み取り専用 |
| url | string | URL文字列。 {HOST.IP}、{HOST.CONN}、{HOST.DNS}、{HOST.HOST}、{HOST.NAME}、{HOST.PORT}、{ITEM.ID}、{ITEM.KEY} およびユーザーマクロをサポートします。 プロパティの動作: - type が "HTTP agent" に設定されている場合に 必須- 継承されたオブジェクトでは 読み取り専用 |
| allow_traps | integer | trapperアイテムと同様に値を設定できるようにします。 指定可能な値: 0 - (デフォルト) 受信データの受け入れを許可しない; 1 - 受信データの受け入れを許可する。 プロパティの動作: - type が "HTTP agent" に設定されている場合に サポート |
| authtype | integer | 認証方式。type が "SSH agent" に設定されている場合の指定可能な値:0 - (デフォルト) パスワード; 1 - 公開鍵。 type が "HTTP agent" に設定されている場合の指定可能な値:0 - (デフォルト) なし; 1 - basic; 2 - NTLM; 3 - Kerberos; 4 - Digest。 プロパティの動作: - type が "SSH agent" または "HTTP agent" に設定されている場合に サポート- 継承されたオブジェクトでは 読み取り専用（ type が "HTTP agent" に設定されている場合） |
| description | string | LLDルールの説明。 |
| error | string | LLDルールの値の更新に問題がある場合のエラーテキスト。 プロパティの動作: - 読み取り専用 |
| follow_redirects | integer | データ取得時にレスポンスのリダイレクトに従うかどうか。 指定可能な値: 0 - リダイレクトに従わない; 1 - (デフォルト) リダイレクトに従う。 プロパティの動作: - type が "HTTP agent" に設定されている場合に サポート- 継承されたオブジェクトでは 読み取り専用 |
| headers | array | HTTPリクエスト実行時に送信されるヘッダーの配列。 プロパティの動作: - type が "HTTP agent" に設定されている場合に サポート- 継承されたオブジェクトでは 読み取り専用 |
| http_proxy | string | HTTP(S)プロキシ接続文字列。 プロパティの動作: - type が "HTTP agent" に設定されている場合に サポート- 継承されたオブジェクトでは 読み取り専用 |
| ipmi_sensor | string | IPMIセンサー。 プロパティの動作: - type が "IPMI agent" に設定され、かつ key_ が "ipmi.get" に設定されていない場合に 必須- type が "IPMI agent" に設定されている場合に サポート- 継承されたオブジェクトでは 読み取り専用 |
| jmx_endpoint | string | JMXエージェントのカスタム接続文字列。 デフォルト: service:jmx:rmi:///jndi/rmi://{HOST.CONN}:{HOST.PORT}/jmxrmi プロパティの動作: - type が "JMX agent" に設定されている場合に サポート |
| lifetime | string | ディスカバリされなくなったアイテムが削除されるまでの期間。秒、サフィックス付きの時間単位、またはユーザーマクロを受け付けます。 デフォルト: 7d。 |
| lifetime_type | integer | 失われたLLDリソースを削除するシナリオ。 指定可能な値: 0 - (デフォルト) lifetimeのしきい値に達した後に削除; 1 - 削除しない; 2 - 即時削除。 |
| enabled_lifetime | string | ディスカバリされなくなったアイテムが無効化されるまでの期間。秒、サフィックス付きの時間単位、またはユーザーマクロを受け付けます。 デフォルト: 0。 |
| enabled_lifetime_type | integer | 失われたLLDリソースを無効化するシナリオ。 指定可能な値: 0 - lifetimeのしきい値に達した後に無効化; 1 - 無効化しない; 2 - (デフォルト) 即時無効化。 |
| master_itemid | ID | マスターアイテムのID。 ディスカバリルールを別のディスカバリルールのマスターアイテムにすることはできません。 プロパティの動作: - type が "Dependent item" に設定されている場合に 必須- 継承されたオブジェクトでは 読み取り専用 |
| output_format | integer | レスポンスをJSONに変換するかどうか。 指定可能な値: 0 - (デフォルト) 生データのまま保存; 1 - JSONに変換。 プロパティの動作: - type が "HTTP agent" に設定されている場合に サポート- 継承されたオブジェクトでは 読み取り専用 |
| params | string | LLDルールのタイプに応じた追加パラメータ: - SSHおよびTelnet LLDルール用の実行スクリプト; - データベースモニタLLDルール用のSQLクエリ; - 計算LLDルール用の式; - ScriptおよびBrowser LLDルール用のスクリプト。 プロパティの動作: - type が "Database monitor"、"SSH agent"、"TELNET agent"、"Script"、または "Browser" に設定されている場合に 必須- 継承されたオブジェクトでは 読み取り専用（ type が "Script" または "Browser" に設定されている場合） |
| parameters | object/array | type が "Script" または "Browser" に設定されている場合の追加パラメータ。name と value プロパティを持つオブジェクトの配列で、name は一意でなければなりません。プロパティの動作: - type が "Script" または "Browser" に設定されている場合に サポート- 継承されたオブジェクトでは 読み取り専用 |
| password | string | 認証用パスワード。 プロパティの動作: - type が "JMX agent" に設定され、かつ username が設定されている場合に 必須- type が "Simple check"、"Database monitor"、"SSH agent"、"TELNET agent"、または "HTTP agent" に設定されている場合に サポート- 継承されたオブジェクトでは 読み取り専用（ type が "HTTP agent" に設定されている場合） |
| post_type | integer | posts プロパティに格納されるPOSTデータ本文のタイプ。指定可能な値: 0 - (デフォルト) 生データ; 2 - JSONデータ; 3 - XMLデータ。 プロパティの動作: - type が "HTTP agent" に設定されている場合に サポート- 継承されたオブジェクトでは 読み取り専用 |
| posts | string | HTTP(S)リクエスト本文データ。 プロパティの動作: - type が "HTTP agent" に設定され、かつ post_type が "JSON data" または "XML data" に設定されている場合に 必須- type が "HTTP agent" に設定され、かつ post_type が "Raw data" に設定されている場合に サポート- 継承されたオブジェクトでは 読み取り専用 |
| privatekey | string | 秘密鍵ファイル名。 プロパティの動作: - type が "SSH agent" に設定され、かつ authtype が "public key" に設定されている場合に 必須 |
| publickey | string | 公開鍵ファイル名。 プロパティの動作: - type が "SSH agent" に設定され、かつ authtype が "public key" に設定されている場合に 必須 |
| query_fields | array | HTTPリクエスト実行時に送信されるクエリフィールドの配列。 プロパティの動作: - type が "HTTP agent" に設定されている場合に サポート- 継承されたオブジェクトでは 読み取り専用 |
| request_method | integer | リクエストメソッドのタイプ。 指定可能な値: 0 - (デフォルト) GET; 1 - POST; 2 - PUT; 3 - HEAD。 プロパティの動作: - type が "HTTP agent" に設定されている場合に サポート- 継承されたオブジェクトでは 読み取り専用 |
| retrieve_mode | integer | レスポンスのどの部分を保存するか。request_method が "GET"、"POST"、または "PUT" に設定されている場合の指定可能な値:0 - (デフォルト) 本文; 1 - ヘッダー; 2 - 本文とヘッダーの両方を保存。 request_method が "HEAD" に設定されている場合の指定可能な値:1 - ヘッダー。 プロパティの動作: - type が "HTTP agent" に設定されている場合に サポート- 継承されたオブジェクトでは 読み取り専用 |
| snmp_oid | string | SNMP OID。 プロパティの動作: - type が "SNMP agent" に設定されている場合に 必須- 継承されたオブジェクトでは 読み取り専用 |
| ssl_cert_file | string | 公開SSL鍵ファイルのパス。 プロパティの動作: - type が "HTTP agent" に設定されている場合に サポート- 継承されたオブジェクトでは 読み取り専用 |
| ssl_key_file | string | 秘密SSL鍵ファイルのパス。 プロパティの動作: - type が "HTTP agent" に設定されている場合に サポート- 継承されたオブジェクトでは 読み取り専用 |
| ssl_key_password | string | SSL鍵ファイルのパスワード。 プロパティの動作: - type が "HTTP agent" に設定されている場合に サポート- 継承されたオブジェクトでは 読み取り専用 |
| state | integer | LLDルールの状態。 指定可能な値: 0 - (デフォルト) 正常; 1 - サポートされていない。 プロパティの動作: - 読み取り専用 |
| status | integer | LLDルールのステータス。 指定可能な値: 0 - (デフォルト) 有効なLLDルール; 1 - 無効なLLDルール。 |
| status_codes | string | 必要なHTTPステータスコードの範囲。カンマ区切りで指定します。カンマ区切りリストの一部としてユーザーマクロもサポートします。 例: 200,200-{$M},{$M},200-400 プロパティの動作: - type が "HTTP agent" に設定されている場合に サポート- 継承されたオブジェクトでは 読み取り専用 |
| templateid | ID | 親テンプレートLLDルールのID。 プロパティの動作: - 読み取り専用 |
| timeout | string | アイテムデータ取得リクエストのタイムアウト。 秒、またはサフィックス付きの時間単位（例: 30s、1m）を受け付けます。ユーザーマクロも受け付けます。 指定可能な値の範囲: 1-600s。 デフォルト: "" - プロキシ/グローバル設定を使用。 プロパティの動作: - type が "Zabbix agent" (0)、"Simple check" (3) で key_ が "vmware." および "icmpping" で始まらない場合、"Zabbix agent (active)" (7)、"External check" (10)、"Database monitor" (11)、"SSH agent" (13)、"TELNET agent" (14)、"HTTP agent" (19)、"SNMP agent" (20) で snmp_oid が "walk[" または "get[" で始まる場合、"Script" (21)、"Browser" (22) に設定されている場合に サポート- 継承されたオブジェクトでは 読み取り専用 |
| trapper_hosts | string | 許可されたホスト。 プロパティの動作: - type が "Zabbix trapper" に設定されている場合、または type が "HTTP agent" に設定され、かつ allow_traps が "Allow to accept incoming data" に設定されている場合に サポート |
| username | string | 認証用ユーザー名。 プロパティの動作: - type が "SSH agent"、"TELNET agent" に設定されている場合、または type が "JMX agent" に設定され、かつ password が設定されている場合に 必須- type が "Simple check"、"Database monitor"、または "HTTP agent" に設定されている場合に サポート- 継承されたオブジェクトでは 読み取り専用（ type が "HTTP agent" に設定されている場合） |
| uuid | string | 既存のLLDルールにインポートしたLLDルールをリンクするために使用される汎用一意識別子。指定しない場合は自動生成されます。 プロパティの動作: - LLDルールがテンプレートに属する場合に サポート |
| verify_host | integer | 接続先のホスト名がホスト証明書内の名前と一致することを検証するかどうか。 指定可能な値: 0 - (デフォルト) 検証しない; 1 - 検証する。 プロパティの動作: - type が "HTTP agent" に設定されている場合に サポート- 継承されたオブジェクトでは 読み取り専用 |
| verify_peer | integer | ホストの証明書が正当であることを検証するかどうか。 指定可能な値: 0 - (デフォルト) 検証しない; 1 - 検証する。 プロパティの動作: - type が "HTTP agent" に設定されている場合に サポート- 継承されたオブジェクトでは 読み取り専用 |
HTTPヘッダー
ヘッダーオブジェクトには、以下のプロパティがあります。
HTTPクエリフィールド
クエリフィールドオブジェクトは、URLパラメータを指定するために使用される名前と値を定義します。 このオブジェクトには、以下のプロパティがあります。
LLDルールフィルター
LLDルールフィルターオブジェクトは、検出されたオブジェクトをフィルタリングするために使用できる一連の条件を定義します。次のプロパティがあります。
| Property | Type | Description |
|---|---|---|
| conditions | object/array | 結果のフィルタリングに使用するフィルター条件のセット。条件は、formula内で配置された順序でソートされます。 Property behavior: - 必須 |
| evaltype | integer | フィルター条件の評価方法。 指定可能な値: 0 - And/Or; 1 - And; 2 - Or; 3 - カスタム式。 Property behavior: - 必須 |
| eval_formula | string | フィルター条件の評価に使用される生成済みの式。この式には、各フィルター条件をそのformulaidで参照するIDが含まれます。カスタム式を使用するフィルターでは、eval_formulaの値はformulaの値と同じです。Property behavior: - 読み取り専用 |
| formula | string | カスタム式を使用するフィルターの条件評価に使用する、ユーザー定義の式。この式には、各フィルター条件をそのformulaidで参照するIDが含まれている必要があります。式で使用するIDは、フィルター条件で定義されたものと完全に一致している必要があります。どの条件も未使用または省略されたままにすることはできません。Property behavior: - evaltypeが"custom expression"に設定されている場合は必須 |
LLDルールのフィルター条件
LLDルールのフィルター条件オブジェクトは、LLDマクロの値に対して実行する個別のチェックを定義します。以下のプロパティがあります。
| プロパティ | Type | 説明 |
|---|---|---|
| macro | string | チェックを実行する対象のLLDマクロ。 Property behavior: - required |
| value | string | 比較対象の値。 Property behavior: - operator が「正規表現に一致」または「正規表現に一致しない」に設定されている場合は required |
| formulaid | string | カスタム式から条件を参照するために使用される任意の一意なID。使用できるのは大文字のみです。フィルター条件を変更する際には、このIDはユーザーが定義する必要がありますが、その後に条件を要求すると新たに生成されます。 Property behavior: - LLD rule filter object の evaltype が「カスタム式」に設定されている場合は required |
| operator | integer | 条件演算子。 指定可能な値: 8 - (default) 正規表現に一致; 9 - 正規表現に一致しない; 12 - 存在する; 13 - 存在しない。 |
さまざまな種類の式でフィルターを使用する方法をよりよく理解するには、discoveryrule.get および discoveryrule.create メソッドのページにある例を参照してください。
LLDマクロパス
LLDマクロパスには、以下のプロパティがあります。
| プロパティ | Type | 説明 |
|---|---|---|
| lld_macro | string | LLDマクロ。 プロパティの動作: - 必須 |
| path | string | 対応するマクロに割り当てられる値のセレクター。 プロパティの動作: - 必須 |
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 が "Regular expression" (5)、"XML XPath" (11)、"JSONPath" (12)、"Matches regular expression" (14)、"Does not match regular expression" (15)、"Check for error in JSON" (16)、"Check for error in XML" (17)、"Discard unchanged with heartbeat" (20)、"JavaScript" (21)、"Prometheus to JSON" (23)、"CSV to JSON" (24)、"Replace" (25)、"SNMP walk value" (28)、"SNMP walk to JSON" (29)、または "SNMP get value" (30) に設定されている場合は 必須 |
| error_handler | integer | 前処理ステップの失敗時に使用されるアクションタイプ。 指定可能な値: 0 - エラーメッセージはZabbixサーバーによって設定される; 1 - 値を破棄; 2 - カスタム値を設定; 3 - カスタムエラーメッセージを設定。 プロパティの動作: - type が "Regular expression" (5)、"XML XPath" (11)、"JSONPath" (12)、"Matches regular expression" (14)、"Does not match regular expression" (15)、"Check for error in JSON" (16)、"Check for error in XML" (17)、"Prometheus to JSON" (23)、"CSV to JSON" (24)、"XML to JSON" (27)、"SNMP walk value" (28)、"SNMP walk to JSON" (29)、または "SNMP get value" (30) に設定されている場合は 必須 |
| error_handler_params | string | エラーハンドラーパラメータ。 プロパティの動作: - error_handler が "Set custom value" または "Set custom error message" に設定されている場合は 必須 |
以下のパラメータおよびエラーハンドラーが、各前処理タイプでサポートされています。
| 前処理タイプ | 名前 | パラメータ 1 | パラメータ 2 | パラメータ 3 | サポートされるエラーハンドラー |
|---|---|---|---|---|---|
| 5 | Regular expression | pattern1 | output2 | 0, 1, 2, 3 | |
| 11 | XML XPath | path3 | 0, 1, 2, 3 | ||
| 12 | JSONPath | path3 | 0, 1, 2, 3 | ||
| 14 | Matches regular expression | pattern1 | 0, 1, 2, 3 | ||
| 15 | Does not match regular expression | pattern1 | 0, 1, 2, 3 | ||
| 16 | Check for error in JSON | path3 | 0, 1, 2, 3 | ||
| 17 | Check for error in 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からJSON7 | フィールド名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 改行文字で区切られた複数の "Field name,OID prefix,Format records" レコードをサポートします。
LLDルールのオーバーライド
LLDルールのオーバーライドオブジェクトは、異なるプロトタイプオブジェクトのプロパティを上書きするために使用される一連のルール（フィルター、条件、操作）を定義します。次のプロパティがあります。
| Property | Type | Description |
|---|---|---|
| name | string | 一意のオーバーライド名。 プロパティの動作: - 必須 |
| step | integer | オーバーライドの一意の順序番号。 プロパティの動作: - 必須 |
| stop | integer | 一致した場合、後続のオーバーライドの処理を停止します。 指定可能な値: 0 - (デフォルト) オーバーライドの処理を停止しない; 1 - フィルターに一致した場合、オーバーライドの処理を停止する。 |
| filter | object | オーバーライドフィルター。 |
| operations | object/array | オーバーライド操作。 |
LLDルールのオーバーライドフィルター
LLDルールのオーバーライドフィルターオブジェクトは、一連の条件を定義します。これらの条件が検出されたオブジェクトに一致した場合、オーバーライドが適用されます。以下のプロパティがあります。
| Property | Type | Description |
|---|---|---|
| conditions | object/array | 検出されたオブジェクトとの一致に使用するオーバーライドフィルター条件のセット。条件は、formula内での配置順に並べ替えられます。 Property behavior: - required |
| evaltype | integer | オーバーライドフィルター条件の評価方法。 使用可能な値: 0 - And/Or; 1 - And; 2 - Or; 3 - カスタム式。 Property behavior: - required |
| eval_formula | string | オーバーライドフィルター条件の評価に使用される生成済みの式。この式には、各オーバーライドフィルター条件をそのformulaidで参照するIDが含まれます。カスタム式を使用するフィルターでは、eval_formulaの値はformulaの値と同じです。Property behavior: - read-only |
| formula | string | カスタム式を使用するオーバーライドフィルターの条件評価に使用する、ユーザー定義の式。この式には、各オーバーライドフィルター条件をそのformulaidで参照するIDを含める必要があります。式で使用するIDは、オーバーライドフィルター条件で定義されたものと完全に一致していなければなりません。未使用または省略された条件があってはなりません。Property behavior: - evaltypeが"custom expression"に設定されている場合は required |
LLDルールのオーバーライドフィルター条件
LLDルールのオーバーライドフィルター条件オブジェクトは、LLDマクロの値に対して実行する個別のチェックを定義します。以下のプロパティがあります。
| プロパティ | Type | 説明 |
|---|---|---|
| macro | string | チェックを実行する対象のLLDマクロ。 プロパティの動作: - 必須 |
| value | string | 比較する値。 プロパティの動作: - operator が「正規表現に一致」または「正規表現に一致しない」に設定されている場合は 必須 |
| formulaid | string | カスタム式から条件を参照するために使用される任意の一意なID。使用できるのは大文字のみです。フィルター条件を変更する際は、このIDをユーザーが定義する必要がありますが、その後に条件をリクエストすると新たに生成されます。 プロパティの動作: - LLDルールのオーバーライドフィルターオブジェクト の evaltype が「カスタム式」に設定されている場合は 必須 |
| operator | integer | 条件演算子。 指定可能な値: 8 - (デフォルト) 正規表現に一致; 9 - 正規表現に一致しない; 12 - 存在する; 13 - 存在しない。 |
LLDルールのオーバーライド操作
LLDルールのオーバーライド操作は、プロトタイプオブジェクトに対して実行する条件とアクションの組み合わせです。 以下のプロパティがあります。
| プロパティ | Type | 説明 |
|---|---|---|
| operationobject | integer | アクションを実行する検出済みオブジェクトのタイプ。 使用可能な値: 0 - アイテムのプロトタイプ; 1 - トリガーのプロトタイプ; 2 - グラフのプロトタイプ; 3 - ホストのプロトタイプ; 4 - ディスカバリのプロトタイプ。 プロパティの動作: - 必須 |
| operator | integer | オーバーライド条件のoperator。 使用可能な値: 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ルールのオーバーライド操作 discover
LLDルールのオーバーライド操作 discover は、検出された オブジェクトに設定される discover ステータスです。以下のプロパティがあります。
| Property | Type | Description |
|---|---|---|
| discover | integer | 選択したオブジェクトの discover ステータスをオーバーライドします。 指定可能な値: 0 - はい。オブジェクトの検出を継続します。 1 - いいえ。新しいオブジェクトは検出されず、既存のオブジェクトは失われたものとしてマークされます。 Property behavior: - required |
LLDルールの上書き操作期間
LLDルールの上書き操作期間は、検出されたアイテムに設定される更新間隔の値です。 以下のプロパティがあります。
| プロパティ | Type | 説明 |
|---|---|---|
| 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}プロパティの動作: - required |
LLDルールのオーバーライド操作履歴
検出されたアイテムに設定されるLLDルールのオーバーライド操作履歴の値です。以下のプロパティがあります。
| プロパティ | Type | 説明 |
|---|---|---|
| history | string | 履歴データをどのくらいの期間保存するかを示す時間単位であるアイテムプロトタイプの履歴をオーバーライドします。ユーザーマクロおよびLLDマクロも使用できます。 プロパティの動作: - 必須 |
LLDルールのオーバーライド操作のトレンド
LLDルールのオーバーライド操作のトレンド値は、ディスカバリされたアイテムに設定されます。 以下のプロパティがあります。
| Property | Type | Description |
|---|---|---|
| trends | string | アイテムプロトタイプのトレンドをオーバーライドします。これは、トレンドデータをどのくらいの期間保存するかを示す時間単位です。ユーザーマクロおよびLLDマクロも使用できます。 Property behavior: - required |
LLDルールのオーバーライド操作の深刻度
検出されたトリガーに設定される、LLDルールのオーバーライド操作の深刻度の値です。以下のプロパティがあります。
| Property | Type | Description |
|---|---|---|
| severity | integer | トリガープロトタイプの深刻度をオーバーライドします。 指定可能な値: 0 - (デフォルト) 未分類; 1 - 情報; 2 - 警告; 3 - 軽度の障害; 4 - 重度の障害; 5 - 致命的な障害。 プロパティの動作: - 必須 |
LLDルールのオーバーライド操作タグ
LLDルールのオーバーライド操作タグオブジェクトには、検出されたオブジェクトに設定されるタグ名と値が含まれます。次のプロパティがあります。
LLDルールの上書き操作テンプレート
検出されたホストにリンクされる、LLDルールの上書き操作テンプレートオブジェクトです。以下のプロパティがあります。
LLDルールのオーバーライド操作インベントリ
検出されたホストに設定される、LLDルールのオーバーライド操作インベントリモードの値です。以下のプロパティがあります。