LLD ruleオブジェクト

次のオブジェクトは、discoveryruleAPIに直接関連しています。

LLDルール

ローレベルディスカバリルールオブジェクトには、次のプロパティがあります。

Property Type Description
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 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 検出されなくなったアイテムが削除されるまでの期間。秒数(例: 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 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ヘッダー

ヘッダーオブジェクトには、以下のプロパティがあります。

プロパティ 型 説明
name string HTTPヘッダー名。

プロパティの動作:
- 必須
value string ヘッダー値。

プロパティの動作:
- 必須

HTTPクエリフィールド

クエリフィールドオブジェクトは、URLパラメータを指定するために使用される名前と値を定義します。 このオブジェクトには、以下のプロパティがあります。

プロパティ 型 説明
name string パラメータの名前。

プロパティの動作:
- 必須
value string パラメータの値。

プロパティの動作:
- 必須

Telemetry query

The telemetry query object has the following properties.

Property Type Description
signal_type integer Signal type that the LLD rule queries.

Possible values:
0 - Traces;
1 - Metrics;
2 - Logs.

Property behavior:
- required
metric_point_type integer Metric point type that the LLD rule queries.

Possible values:
0 - Sum;
1 - Gauge;
2 - Histogram;
3 - Exponential histogram.

Property behavior:
- required if signal_type is set to "Metrics"
columns array Array of telemetry data columns that the LLD rule queries. Can be empty.

Property behavior:
- required
aggregated_columns array Array of telemetry data aggregated columns that the LLD rule queries, and how it calculates a value from column records.

Property behavior:
- required
filter object Telemetry query filter for column records in the query.

Property behavior:
- required
Telemetry data columns

The telemetry data columns object has the following properties.

Property Type Description
column string Name of the telemetry data column that the LLD rule queries.
See supported telemetry data columns.

For multiple single-value columns, each column value must be unique. For multiple columns that hold key-value pairs, each column and attribute_key pair must be unique.
attribute_key string Name of the key that the LLD rule queries, within the column that holds key-value pairs.

For multiple columns that hold key-value pairs, each column and attribute_key pair must be unique.

Property behavior:
- required if column is set to a column that holds key-value pairs
Telemetry data aggregated columns

The telemetry data aggregated columns object has the following properties.

Property Type Description
column string Name of the telemetry data column that the LLD rule queries.
See supported telemetry data columns.

For multiple columns, each column value must be unique.

This property is not supported if function is set to "Count".

Property behavior:
- required if function is set to "Min", "Max", "Average", "Sum", or "Percentile"
function integer Function that the LLD rule applies to the column records.

Possible values:
1 - Min;
2 - Max;
3 - Average;
4 - Count;
5 - Sum;
8 - Percentile.

Property behavior:
- required
parameters array Percentile that the LLD rule calculates from the column records.

Possible value: a number from 0 to 100, given as a string.

Property behavior:
- required if function is set to "Percentile"
alias string Unique name for the calculated value, used to identify it in the LLD rule value.

Each alias value must be unique and cannot be clock.

Property behavior:
- required
Telemetry data filter

The telemetry data filter object has the following properties.

Property Type Description
conditions array Telemetry data filter conditions a record in a telemetry data column must meet.

Property behavior:
- required
evaltype integer Filter condition evaluation method.

Possible values:
0 - And/Or;
1 - And;
2 - Or;
3 - Custom expression.

Property behavior:
- required
eval_formula string Generated expression that will be used for evaluating filter conditions. The expression contains IDs that reference specific filter conditions by its formulaid. The value of eval_formula is equal to the value of formula for filters with a custom expression.

Property behavior:
- read-only
formula string User-defined expression to be used for evaluating conditions of filters with a custom expression. The expression must contain IDs that reference specific filter conditions by its formulaid. The IDs used in the expression must exactly match the ones defined in the filter conditions: no condition can remain unused or omitted.

Property behavior:
- required if evaltype is set to "Custom expression"
Telemetry data filter conditions

The telemetry data filter conditions object has the following properties.

Property Type Description
column string Name of the telemetry data column that the filter condition applies to.
See supported telemetry data columns.

Property behavior:
- required
attribute_key string Name of the key that the condition applies to, within the column that holds key-value pairs.

Property behavior:
- required if column is set to a column that holds key-value pairs
operator integer Filter condition operator.

Possible values for single-value columns:
0 - Equals;
1 - Does not equal;
2 - Contains;
3 - Does not contain.

Possible values for columns that hold key-value pairs:
0 - Equals;
1 - Does not equal;
12 - Exists.

Property behavior:
- required
value string Value to compare with.

Property behavior:
- required if operator is set to "Equals", "Does not equal", "Contains" or "Does not contain"
formulaid string Arbitrary unique ID that is used to reference the condition from a custom expression. Can only contain capital-case letters. The ID must be defined by the user when modifying filter conditions, but will be generated anew when requesting them afterward.

Property behavior:
- required if evaltype of Telemetry query filter object is set to "Custom expression"

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ルールのオーバーライド操作ステータスです。 以下のプロパティがあります。

プロパティ Type 説明
status integer 選択したオブジェクトのステータスをオーバーライドします。

指定可能な値:
0 - 有効で作成;
1 - 無効で作成。

プロパティの動作:
- 必須
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ルールのオーバーライド操作テンプレートオブジェクトです。
以下のプロパティがあります。

プロパティ Type 説明
templateid ID ホストプロトタイプのリンク済みテンプレートのテンプレートをオーバーライドします。

プロパティの動作:
- 必須
LLDルールのオーバーライド操作インベントリ

検出されたホストに設定される、LLDルールのオーバーライド操作インベントリモードの値です。
以下のプロパティがあります。

Property Type Description
inventory_mode integer ホストプロトタイプのインベントリモードをオーバーライドします。

指定可能な値:
-1 - 無効;
0 - (デフォルト) 手動;
1 - 自動。

Property behavior:
- required