LLD ruleオブジェクト
次のオブジェクトは、discoveryruleAPIに直接関連しています。
LLDルール
ローレベルディスカバリルールオブジェクトには、次のプロパティがあります。
| プロパティ | タイプ | 説明 |
|---|---|---|
| itemid | ID | LLDルールのID。 プロパティの動作: - 読み取り専用 - 更新操作では必須 |
| delay | string | LLDルールの更新間隔。 秒数(例: 1、60、300)、時間のサフィックス付きの値(例: 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 | トラッパーアイテムと同様に値を格納できるようにします。 指定可能な値: 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 | 検出されなくなったアイテムが削除されるまでの期間。秒数(例: 3600)、時間のサフィックス付きの値(例: 3600s、180m、24h、1d)、またはユーザーマクロを受け入れます。デフォルト: 7d。 |
| lifetime_type | integer | 失われたLLDリソースを削除するシナリオ。 指定可能な値: 0 - (デフォルト) 存続期間のしきい値に達した後に削除; 1 - 削除しない; 2 - 直ちに削除。 |
| enabled_lifetime | string | 検出されなくなったアイテムが無効になるまでの期間。秒数(例: 1、60、300)、時間のサフィックス付きの値(例: 30s、1m、2h、1d)、またはユーザーマクロを受け入れます。デフォルト: 0。 |
| enabled_lifetime_type | integer | 失われたLLDリソースを無効にするシナリオ。 指定可能な値: 0 - 存続期間のしきい値に達した後に無効化; 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ルールの計算式; - スクリプトおよびブラウザーの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 | アイテムデータのポーリングリクエストのタイムアウト。 秒数(例: 1、60、300)、時間のサフィックス付きの値(例: 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」に設定されている場合はサポート。プロパティが省略されている場合、 {$TRAPPER.ALLOWED_HOSTS}ユーザーマクロ(デフォルト値)が自動的に設定されます。デフォルトでは、{$TRAPPER.ALLOWED_HOSTS}は127.0.0.1,::1です。プロパティに空の文字列が設定されている場合、すべてのホストからの受信接続が拒否されます。 |
| 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ルールがテンプレートに属している場合はサポート |
| verify_host | integer | 接続先のホスト名がホストの証明書に記載された名前と一致することを検証するかどうか。 指定可能な値: 0 - (デフォルト) 検証しない; 1 - 検証する。 プロパティの動作: - typeが「HTTP agent」に設定されている場合はサポート- 継承されたオブジェクトでは読み取り専用 |
| verify_peer | integer | ホストの証明書が正当なものであることを検証するかどうか。 指定可能な値: 0 - (デフォルト) 検証しない; 1 - 検証する。 プロパティの動作: - typeが「HTTP agent」に設定されている場合はサポート- 継承されたオブジェクトでは読み取り専用 |
HTTPヘッダー
ヘッダーオブジェクトには、以下のプロパティがあります。
HTTPクエリフィールド
クエリフィールドオブジェクトは、URLパラメータを指定するために使用される名前と値を定義します。 このオブジェクトには、以下のプロパティがあります。
LLDルールフィルター
LLDルールフィルターオブジェクトは、検出されたオブジェクトをフィルタリングするために使用できる一連の条件を定義します。 以下のプロパティがあります。
| プロパティ | Type | 説明 |
|---|---|---|
| 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マクロ。 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 が「正規表現」(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 | 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ルールのオーバーライドフィルターオブジェクトは、検出されたオブジェクトに一致した場合にオーバーライドを適用する一連の条件を定義します。 このオブジェクトには、以下のプロパティがあります。
| プロパティ | 型 | 説明 |
|---|---|---|
| conditions | object/array | 検出されたオブジェクトとの一致に使用するオーバーライドフィルター条件のセット。条件は、formula内での配置順に並べ替えられます。 プロパティの動作: - 必須 |
| evaltype | integer | オーバーライドフィルター条件の評価方法。 指定可能な値: 0 - And/Or; 1 - And; 2 - Or; 3 - カスタム式。 プロパティの動作: - 必須 |
| eval_formula | string | オーバーライドフィルター条件の評価に使用される生成済みの式。この式には、各オーバーライドフィルター条件をそのformulaidで参照するIDが含まれます。eval_formulaの値は、カスタム式を使用するフィルターではformulaの値と同じです。プロパティの動作: - 読み取り専用 |
| formula | string | カスタム式を使用するオーバーライドフィルターの条件評価に使用する、ユーザー定義の式。この式には、各オーバーライドフィルター条件をそのformulaidで参照するIDを含める必要があります。式で使用するIDは、オーバーライドフィルター条件で定義されたものと完全に一致していなければなりません。未使用または省略された条件があってはなりません。プロパティの動作: - 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ルールのオーバーライド操作は、プロトタイプオブジェクトに対して実行する条件とアクションの組み合わせです。 以下のプロパティがあります。
| プロパティ | 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 は、検出されたオブジェクトに設定される検出ステータスです。
以下のプロパティがあります:
| Property | Type | Description |
|---|---|---|
| discover | integer | 選択したオブジェクトの検出ステータスをオーバーライドします。 指定可能な値: 0 - はい、オブジェクトの検出を継続します; 1 - いいえ、新しいオブジェクトは検出されず、既存のオブジェクトは失われたものとしてマークされます。 Property behavior: - required |
LLDルールのオーバーライド操作期間
LLDルールのオーバーライド操作期間は、検出されたアイテムに設定される更新間隔の値です。 以下のプロパティがあります。
| Property | Type | Description |
|---|---|---|
| delay | string | アイテムのプロトタイプの更新間隔をオーバーライドします。 秒数(例: 1、60、300)、時間のサフィックス付きの値(例: 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マクロも使用できます。 プロパティの動作: - required |
LLDルールのオーバーライド操作の深刻度
検出されたトリガーに設定されるLLDルールのオーバーライド操作の深刻度の値です。
以下のプロパティがあります。
| Property | Type | Description |
|---|---|---|
| severity | integer | トリガープロトタイプの深刻度をオーバーライドします。 指定可能な値: 0 - (デフォルト) 未分類; 1 - 情報; 2 - 警告; 3 - 軽度の障害; 4 - 重度の障害; 5 - 致命的な障害. Property behavior: - required |
LLDルールのオーバーライド操作タグ
LLDルールのオーバーライド操作タグオブジェクトには、検出されたオブジェクトに設定されるタグ名と値が含まれます。 次のプロパティがあります。
| Property | Type | Description |
|---|---|---|
| tag | string | 新しいタグ名。ユーザーマクロおよびLLDマクロも使用できます。 Property behavior: - required |
| value | string | 新しいタグ値。ユーザーマクロおよびLLDマクロも使用できます。 |
LLDルールのオーバーライド操作テンプレート
検出されたホストにリンクされたLLDルールのオーバーライド操作テンプレートオブジェクトです。
以下のプロパティがあります。
LLDルールのオーバーライド操作インベントリ
検出されたホストに設定される、LLDルールのオーバーライド操作インベントリモードの値です。
以下のプロパティがあります。
| Property | Type | Description |
|---|---|---|
| inventory_mode | integer | ホストプロトタイプのインベントリモードをオーバーライドします。 指定可能な値: -1 - 無効; 0 - (デフォルト) 手動; 1 - 自動。 Property behavior: - required |