UpdateIntegration
修改集成相关信息
服务地址：
华东1 金融云
输入参数
只看必填
IntegrationId告警集成ID
IntegrationName告警集成名称
IntegrationProductType集成产品类型：
Description告警集成描述信息
AutoRecover告警事件是否自动恢复：
请选择布尔值
RecoverTime告警事件自动恢复时间
DuplicateKey去重的字段
State告警集成是否启用：
请选择布尔值
Stat最近1小时总数及异常数
Liveness告警集成活跃度
FieldRedefineRules事件映射
ExtendedFieldRedefineRules事件映射
InitiativeRecoverField告警事件恢复字段
InitiativeRecoverValue告警事件恢复字段值
插件下载了解更多
VS Code 插件
安装插件之前，确保已安装 VS Code安装插件之前，确保已安装 VS Code
Alibaba Cloud Developer ToolkitbetaAlibaba Cloud OpenAPI
Alibaba Cloud Developer Toolkit is a collection of extensions that can help access Alibaba Cloud services in Visual Studio Code.
安 装
JetBrains 插件
安装插件之前，确保已安装 JetBrains IDE安装插件之前，确保已安装 JetBrains IDE
Alibaba Cloud Developer ToolkitbetaAlibaba Cloud OpenAPI
The Alibaba Cloud Developer Toolkit for JetBrains makes it easier to access Alibaba Cloud services.
安 装

请求参数

字段名称字段详情
IntegrationIdinteger<int64>

告警集成 ID。

注意 该字段类型为 Long，在序列化/反序列化的过程中可能导致精度丢失，请注意数值不得大于 9007199254740991。
示例值:1234参考取值来源:
    ListIntegration
    CreateIntegration
IntegrationNamestring

告警集成名称。

示例值:云监控集成参考取值来源:
    CreateIntegration
    ListIntegration
IntegrationProductTypestring

集成产品类型：展开详情

示例值:CLOUD_MONITOR参考取值来源:
    CreateIntegration
Descriptionstring

告警集成描述信息。

示例值:测试
AutoRecoverboolean

告警事件是否自动恢复：展开详情

示例值:true
RecoverTimeinteger<int64>

告警事件自动恢复时间，默认时间为 300 秒。

注意 该字段类型为 Long，在序列化/反序列化的过程中可能导致精度丢失，请注意数值不得大于 9007199254740991。
示例值:300
DuplicateKeystring

去重的字段。

示例值:LABEL.dimensions::LABEL.ruleId
Stateboolean

告警集成是否启用：展开详情

示例值:true
Statstring

最近 1 小时总数及异常数。

示例值:[0,0]
Livenessstring

告警集成活跃度。

示例值:ready
FieldRedefineRulesstring

事件映射，将源字段映射到目标字段。展开详情

示例值:[ { "redefineType":"EXTRACT", "matchExpression":null, "fieldName":"alertname", "expression":null, "mappingRuleList":[ ], "name":"告警名称", "integrationId":1234, "jsonPath":"$.alertName", "id":10001, "fieldType":"LABEL" }, { "redefineType":"MAP", "matchExpression":null, "fieldName":"severity", "expression":null, "mappingRuleList":[ { "mappingValue":"critical", "mappingName":"P1", "mappingType":"MAP", "originValue":"CRITICAL" }, { "mappingValue":"error", "mappingName":"P2", "mappingType":"MAP", "originValue":"WARN" }, { "mappingValue":"warning", "mappingName":"P3", "mappingType":"MAP", "originValue":"INFO" } ], "name":"告警等级", "integrationId":1234, "jsonPath":"$.triggerLevel", "id":10002, "fieldType":"LABEL" }, { "redefineType":"EXTRACT", "matchExpression":null, "fieldName":"message", "expression":"{{$labels.namespace}} / {{$labels.dimensions}} 发生 {{ $labels.alertname }}, 当前值 {{$value}}。", "mappingRuleList":[ ], "name":"告警描述", "integrationId":1234, "jsonPath":null, "id":10003, "fieldType":"ANNOTATION" }, { "redefineType":"EXTRACT", "matchExpression":null, "fieldName":"value", "expression":null, "mappingRuleList":[ ], "name":"告警样本值", "integrationId":1234, "jsonPath":"$.curValue", "id":10004, "fieldType":"ANNOTATION" }, { "redefineType":"EXTRACT", "matchExpression":null, "fieldName":"source", "expression":null, "mappingRuleList":[ ], "name":"来源", "integrationId":1234, "jsonPath":null, "id":10007, "fieldType":"LABEL" }, { "redefineType":"ADD", "matchExpression":null, "fieldName":"generatorUrl", "expression":"https://cloudmonitor.console.aliyun.com/index.htm#/alarmInfo/name={{$labels.ruleId}}&searchValue=&searchType=name&searchProduct=/history/all/searchKey:{{$labels.ruleId}},startTime:{{sub $startsAt 300000}},endTime:{{$endsAt}}", "mappingRuleList":[ ], "name":"事件地址", "integrationId":1234, "jsonPath":"https://cloudmonitor.console.aliyun.com/index.htm#/alarmInfo/name={{$labels.ruleId}}&searchValue=&searchType=name&searchProduct=/history/all/searchKey:{{$labels.ruleId}},startTime:{{sub $startsAt 300000}},endTime:{{$endsAt}}", "id":10012, "fieldType":"GENERATE_URL" } ]
ExtendedFieldRedefineRulesstring

事件映射，将源字段映射到目标字段，拓展字段增加映射。更多信息，请参见下方补充说明。

示例值:[ { "redefineType":"EXTRACT", "matchExpression":null, "fieldName":"dimensions", "expression":null, "mappingRuleList":[ ], "name":"dimensions", "integrationId":1234, "jsonPath":"$.dimensions", "id":10013, "fieldType":"LABEL" }, { "redefineType":"EXTRACT", "matchExpression":null, "fieldName":"expression", "expression":null, "mappingRuleList":[ ], "name":"expression", "integrationId":1234, "jsonPath":"$.expression", "id":10014, "fieldType":"LABEL" } ]
InitiativeRecoverFieldstring

告警事件恢复字段。系统收到恢复事件后会根据恢复事件中的字段查询告警事件进行恢复。展开详情

示例值:$.status
InitiativeRecoverValuestring

告警事件恢复字段值。系统收到恢复事件后会根据恢复事件中的字段查询告警事件进行恢复。展开详情

示例值:ok

请求说明

FieldRedefineRules 和 ExtendedFieldRedefineRules 参数说明

完整示例如下：

[
    {
        "redefineType":"EXTRACT",
        "matchExpression":null,
        "fieldName":"alertname",
        "expression":null,
        "mappingRuleList":[

        ],
        "name":"告警名称",
        "integrationId":1234,
        "jsonPath":"$.alertName",
        "id":10001,
        "fieldType":"LABEL"
    },
    {
        "redefineType":"MAP",
        "matchExpression":null,
        "fieldName":"severity",
        "expression":null,
        "mappingRuleList":[
            {
                "mappingValue":"critical",
                "mappingName":"P1",
                "mappingType":"MAP",
                "originValue":"CRITICAL"
            },
            {
                "mappingValue":"error",
                "mappingName":"P2",
                "mappingType":"MAP",
                "originValue":"WARN"
            },
            {
                "mappingValue":"warning",
                "mappingName":"P3",
                "mappingType":"MAP",
                "originValue":"INFO"
            }
        ],
        "name":"告警等级",
        "integrationId":1234,
        "jsonPath":"$.triggerLevel",
        "id":10002,
        "fieldType":"LABEL"
    },
    {
        "redefineType":"EXTRACT",
        "matchExpression":null,
        "fieldName":"message",
        "expression":"{{$labels.namespace}} / {{$labels.dimensions}} 发生 {{ $labels.alertname }}, 当前值 {{$value}}。",
        "mappingRuleList":[

        ],
        "name":"告警描述",
        "integrationId":1234,
        "jsonPath":null,
        "id":10003,
        "fieldType":"ANNOTATION"
    },
    {
        "redefineType":"EXTRACT",
        "matchExpression":null,
        "fieldName":"value",
        "expression":null,
        "mappingRuleList":[

        ],
        "name":"告警样本值",
        "integrationId":1234,
        "jsonPath":"$.curValue",
        "id":10004,
        "fieldType":"ANNOTATION"
    },
    {
        "redefineType":"EXTRACT",
        "matchExpression":null,
        "fieldName":"imageUrl",
        "expression":null,
        "mappingRuleList":[

        ],
        "name":"告警图片",
        "integrationId":1234,
        "jsonPath":null,
        "id":10005,
        "fieldType":"ANNOTATION"
    },
    {
        "redefineType":"EXTRACT",
        "matchExpression":null,
        "fieldName":"check",
        "expression":null,
        "mappingRuleList":[

        ],
        "name":"检查项",
        "integrationId":1234,
        "jsonPath":null,
        "id":10006,
        "fieldType":"LABEL"
    },
    {
        "redefineType":"EXTRACT",
        "matchExpression":null,
        "fieldName":"source",
        "expression":null,
        "mappingRuleList":[

        ],
        "name":"来源",
        "integrationId":1234,
        "jsonPath":null,
        "id":10007,
        "fieldType":"LABEL"
    },
    {
        "redefineType":"EXTRACT",
        "matchExpression":null,
        "fieldName":"class",
        "expression":null,
        "mappingRuleList":[

        ],
        "name":"分类",
        "integrationId":1234,
        "jsonPath":null,
        "id":10008,
        "fieldType":"LABEL"
    },
    {
        "redefineType":"EXTRACT",
        "matchExpression":null,
        "fieldName":"service",
        "expression":null,
        "mappingRuleList":[

        ],
        "name":"服务",
        "integrationId":1234,
        "jsonPath":null,
        "id":10009,
        "fieldType":"LABEL"
    },
    {
        "redefineType":"EXTRACT",
        "matchExpression":null,
        "fieldName":"startat",
        "expression":null,
        "mappingRuleList":[

        ],
        "name":"开始时间",
        "integrationId":1234,
        "jsonPath":null,
        "id":10010,
        "fieldType":"START_AT"
    },
    {
        "redefineType":"EXTRACT",
        "matchExpression":null,
        "fieldName":"endat",
        "expression":null,
        "mappingRuleList":[

        ],
        "name":"结束时间",
        "integrationId":1234,
        "jsonPath":null,
        "id":10011,
        "fieldType":"END_AT"
    },
    {
        "redefineType":"ADD",
        "matchExpression":null,
        "fieldName":"generatorUrl",
        "expression":"https://cloudmonitor.console.aliyun.com/index.htm#/alarmInfo/name={{$labels.ruleId}}&searchValue=&searchType=name&searchProduct=/history/all/searchKey:{{$labels.ruleId}},startTime:{{sub $startsAt 300000}},endTime:{{$endsAt}}",
        "mappingRuleList":[

        ],
        "name":"事件地址",
        "integrationId":1234,
        "jsonPath":"https://cloudmonitor.console.aliyun.com/index.htm#/alarmInfo/name={{$labels.ruleId}}&searchValue=&searchType=name&searchProduct=/history/all/searchKey:{{$labels.ruleId}},startTime:{{sub $startsAt 300000}},endTime:{{$endsAt}}",
        "id":10012,
        "fieldType":"GENERATE_URL"
    }
]

字段说明：

字段说明
RedefineType- MAP：通过映射表进行字段映射，如告警等级映射。
- EXTRACT：通过 jsonPath 从 JSON 中解析一个字段映射到目标字段。
- ADD：添加一个内容映射到目标字段。
- CONDITION：条件映射。当满足条件时，通过 jsonPath 从 JSON 中解析一个字段映射到目标字段。
- CONCAT：串联映射。将多个字段以指定的串联符合拼接在一起后映射到模板字段。
MatchExpression- 如果 RedefineType 设置为 CONCAT，MatchExpression 的值即为传递串联的分隔符。
- 如果 RedefineType 设置为 CONDITION，MatchExpression 的值即为传递条件规则的 JSON 字符串。
FieldType- LABEL：告警元数据，一组标签唯一标识一个事件，标签相同的事件为同一个事件，重复上报会进行合并，常见的标签如 “alertname: 告警名称 ”。
- ANNOTATION：注释是告警事件的附加描述，注释不属于元数据。常见的注释有 “message: 告警内容”。
- GENERATE_URL：事件 URL 地址。
- START_AT：告警事件开始时间。
- END_AT：告警事件结束时间。
Expression条件映射样式，作为转义字符串值存入 Expression。
MappingRuleList字段重定义规则。
Name名称。
FieldName字段名称。
JsonPath源字段名称。
IntegrationId集成 ID。
Id映射字段存储表主键 ID。

返回参数

字段名称字段详情
RequestIdstring

请求 ID。

示例值:34ED024E-9E31-434A-9E4E-D9D15C3****
Integrationobject

集成信息。

变更历史