このページで
LLD ルールプロトタイプオブジェクト
以下のオブジェクトは、discoveryruleprototype API に直接関連しています。
LLDルールプロトタイプ
低レベルディスカバリルールプロトタイプオブジェクトには、以下のプロパティがあります。
| プロパティ | 型 | 説明 |
|---|---|---|
| itemid | ID | LLDルールプロトタイプのID。 プロパティの動作: - 読み取り専用 - 更新操作で 必須 |
| ruleid | ID | 親LLDルール/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 | LLDルールプロトタイプの生成元。 指定可能な値: 3 - 低レベルディスカバリルールプロトタイプ; 7 - ディスカバリされた低レベルディスカバリルールプロトタイプ。 プロパティの動作: - 読み取り専用 |
| 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ルールプロトタイプキー。少なくとも1つの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。 プロパティの動作: - 作成操作で 必須 - 継承されたオブジェクトでは 読み取り専用 |
| 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。 プロパティの動作: - 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 prototype filter object の evaltype が「カスタム式」に設定されている場合は required |
| operator | integer | 条件演算子。 指定可能な値: 8 - (default) 正規表現に一致する; 9 - 正規表現に一致しない; 12 - 存在する; 13 - 存在しない。 |
さまざまな種類の式でフィルターを使用する方法をよりよく理解するには、 discoveryruleprototype.get および discoveryruleprototype.create メソッドの ページにある例を参照してください。
LLDマクロパス
LLDマクロパスには、以下のプロパティがあります。
| プロパティ | Type | 説明 |
|---|---|---|
| lld_macro | string | LLDマクロ。 プロパティの動作: - 必須 |
| path | string | 対応するマクロに割り当てられる値のセレクター。 プロパティの動作: - 必須 |
LLDルールプロトタイプの前処理
LLDルールプロトタイプの前処理オブジェクトには、以下のプロパティがあります。
| Property | Type | Description |
|---|---|---|
| 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 が「カスタム値を設定」または「カスタムエラーメッセージを設定」に設定されている場合は 必須 |
以下のパラメータとエラーハンドラーが、各前処理タイプでサポートされています。
| Preprocessing type | Name | Parameter 1 | Parameter 2 | Parameter 3 | Supported error handlers |
|---|---|---|---|---|---|
| 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からJSON7 | Field name2 | OID prefix2 | 形式: 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: - 必須 |
| 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マクロ。 プロパティの動作: - 必須 |
| value | string | 比較する値。 プロパティの動作: - operator が「正規表現に一致」または「正規表現に一致しない」に設定されている場合は 必須 |
| formulaid | string | カスタム式から条件を参照するために使用される任意の一意なID。使用できるのは大文字のみです。フィルター条件を変更する際は、このIDをユーザーが定義する必要がありますが、その後に条件を要求すると新たに生成されます。 プロパティの動作: - LLDルールプロトタイプのオーバーライドフィルターオブジェクト の evaltype が「カスタム式」に設定されている場合は 必須 |
| operator | integer | 条件演算子。 指定可能な値: 8 - (デフォルト) 正規表現に一致; 9 - 正規表現に一致しない; 12 - 存在する; 13 - 存在しない。 |
LLDルールのプロトタイプ上書き操作
LLDルールのプロトタイプ上書き操作は、プロトタイプオブジェクトに対して実行する条件とアクションの組み合わせです。次のプロパティがあります。
| Property | Type | Description |
|---|---|---|
| operationobject | integer | アクションを実行する検出済みオブジェクトのタイプ。 使用可能な値: 0 - アイテムのプロトタイプ; 1 - トリガーのプロトタイプ; 2 - グラフのプロトタイプ; 3 - ホストのプロトタイプ。 プロパティの動作: - 必須 |
| 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ルールのプロトタイプ上書き操作ステータスです。
以下のプロパティがあります。
| Property | Type | Description |
|---|---|---|
| status | integer | 選択したオブジェクトのステータスを上書きします。 指定可能な値: 0 - 有効で作成; 1 - 無効で作成。 プロパティの動作: - required |
LLDルールのプロトタイプ上書き操作 discover
LLDルールのプロトタイプ上書き操作 discover は、発見済みオブジェクトに設定される discover ステータスです。以下のプロパティがあります。
| Property | Type | Description |
|---|---|---|
| discover | integer | 選択したオブジェクトの discover ステータスを上書きします。 指定可能な値: 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ルールのプロトタイプ上書き操作履歴の値です。以下のプロパティがあります。
| プロパティ | Type | 説明 |
|---|---|---|
| history | string | アイテムプロトタイプの履歴を上書きします。これは履歴データをどのくらいの期間保存するかを示す時間単位です。ユーザーマクロおよびLLDマクロも使用できます。 プロパティの動作: - 必須 |
LLDルールのプロトタイプ上書き操作のトレンド
LLDルールのプロトタイプ上書き操作のトレンド値は、検出されたアイテムに設定されます。 以下のプロパティがあります。
| プロパティ | Type | 説明 |
|---|---|---|
| trends | string | アイテムのプロトタイプのトレンドを上書きします。これは、トレンドデータを保存する期間を表す時間単位です。ユーザーマクロおよびLLDマクロも使用できます。 プロパティの動作: - required |
LLDルールのプロトタイプ上書き操作の深刻度
検出されたトリガーに設定される、LLDルールのプロトタイプ上書き操作の深刻度の値です。以下のプロパティがあります。
| Property | Type | Description |
|---|---|---|
| severity | integer | トリガープロトタイプの深刻度を上書きします。 指定可能な値: 0 - (default) 未分類; 1 - 情報; 2 - 警告; 3 - 平均; 4 - 高; 5 - 障害。 Property behavior: - required |
LLDルールのプロトタイプ上書き操作タグ
LLDルールのプロトタイプ上書き操作タグオブジェクトには、ディスカバリされたオブジェクトに設定されるタグ名と値が含まれます。以下のプロパティがあります。
LLDルールのプロトタイプ上書き操作テンプレート
検出されたホストにリンクされる、LLDルールのプロトタイプ上書き操作テンプレートオブジェクトです。以下のプロパティがあります。
LLDルールのプロトタイプ上書き操作インベントリ
検出されたホストに設定される、LLDルールのプロトタイプ上書き操作インベントリモードの値です。以下のプロパティがあります。