以下 objects 与 correlation
API 直接相关。
关联 object 具有以下属性。
属性 | 数据类型 | 描述 |
---|---|---|
correlationid | ID | 关联的ID。 属性行为: - 只读 - 必需 用于 update 操作 |
name | string | 关联的名称。 属性行为: - 必需 用于 create 操作 |
description | string | 关联的描述。 |
status | integer | 关联是否启用。 可能的值: 0 - (默认) 启用; 1 - 禁用。 |
相关操作 object 定义了在执行相关性时将执行的操作。它具有以下属性。
相关性过滤器 object 定义了一组条件,这些条件必须满足才能执行配置的相关性操作。
它具有以下属性。
属性 | 数据类型 | 描述 |
---|---|---|
conditions | array | 用于过滤结果的一组过滤条件。条件将按照它们在公式中的排列顺序进行排序。 属性行为: - 必填 |
evaltype | integer | 过滤条件评估方法。 可能的值: 0 - 与/或; 1 - 与; 2 - 或; 3 - 自定义表达式。 属性行为: - 必填 |
eval_formula | string | 生成的表达式,用于评估过滤条件。该表达式包含引用特定过滤条件的 formulaid ID。对于使用自定义表达式的过滤器,eval_formula 的值等于 formula 的值。属性行为: - 只读 |
formula | string | 用于评估使用自定义表达式的过滤器条件的用户定义表达式。该表达式必须包含引用特定过滤条件的 formulaid ID。表达式中使用的 ID 必须与过滤条件中定义的 ID 完全匹配:不能有未使用或遗漏的条件。属性行为: - 如果 evaltype 设置为 "custom expression",则为必填 |
关联过滤器条件 object 定义了在执行关联操作前必须检查的特定条件。
属性 | 数据类型 | 描述 |
---|---|---|
type | integer | 条件类型。 可选值: 0 - 旧事件标签; 1 - 新事件标签; 2 - 新事件主机组; 3 - 事件标签对; 4 - 旧事件标签值; 5 - 新事件标签值。 属性行为: - 必填 |
tag | string | 事件标签(旧或新)。 属性行为: - 必填 当 type 设置为"旧事件标签"、"新事件标签"、"旧事件标签值"或"新事件标签值"时 |
groupid | ID | 主机组ID。 属性行为: - 必填 当 type 设置为"新事件主机组"时 |
oldtag | string | 旧事件标签。 属性行为: - 必填 当 type 设置为"事件标签对"时 |
newtag | string | 旧事件标签。 属性行为: - 必填 当 type 设置为"事件标签对"时 |
value | string | 事件标签(旧或新)值。 属性行为: - 必填 当 type 设置为"旧事件标签值"或"新事件标签值"时 |
formulaid | string | 用于从自定义表达式引用条件的任意唯一ID。只能包含大写字母。修改过滤器条件时必须由用户定义ID,但在后续请求时会重新生成。 |
operator | integer | 条件运算符。 属性行为: - 必填 当 type 设置为"新事件主机组"、"旧事件标签值"或"新事件标签值"时 |
要更好地理解如何将过滤器与各类表达式结合使用,请参阅 correlation.get和 correlation.create方法 页面上的示例。
每种条件类型支持以下运算符和值。
条件 | 条件名称 | 支持的运算符 | 期望值 |
---|---|---|---|
2 | Host group | =, <> | 主机组 ID。 |
4 | Old event tag value | =, <>, like, not like | string |
5 | New event tag value | =, <>, like, not like | string |