相关性 object

以下 objects 与 correlation API 直接相关。

关联

关联 object 具有以下属性。

属性 数据类型 描述
correlationid ID 关联的ID。

属性行为:
- 只读
- 必需 用于 update 操作
name string 关联的名称。

属性行为:
- 必需 用于 create 操作
description string 关联的描述。
status integer 关联是否启用。

可能的值:
0 - (默认) 启用;
1 - 禁用。

关联操作

相关操作 object 定义了在执行相关性时将执行的操作。它具有以下属性。

属性 数据类型 说明
type integer 操作类型。

可能的值:
0 - 关闭旧事件;
1 - 关闭新事件。

属性行为
- 必填

关联过滤器

相关性过滤器 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 设置为 "old event tag value" 或 "new event tag value",则此项 必填
formulaid string 任意唯一的 ID,用于从自定义表达式中引用该条件。只能包含大写字母。该 ID 在修改过滤条件时由用户定义,但在之后请求条件时将会重新生成。
operator integer 条件运算符。

属性行为:
- 如果将 type 设为 "new event 主机组"、"old event tag value" 或 "new event tag value",则此项必填

::: notetip 为了更好地理解如何将过滤器与各种组件结合使用 表达式类型,请参见以下示例: 检索关联使用自定义表达式过滤器 方法 页面。 仅返回OutputFormat格式要求结果

以下运算符和值受每个条件支持 类型。

条件 条件名称 支持的运算符 预期值
2 Host group =, <> 主机组 ID.
4 Old event tag value =, <>, like, not like string
5 New event tag value =, <>, like, not like string