系统事件代表了云产品资源状态的变更,比如ECS实例发生了异常重启、ECS实例被释放、快照创建完成、将要执行运维等等。运维编排支持创建事件运维任务,在系统事件发生时,执行指定的模板,进行事件运维。事件运维任务会一直执行并监听新事件,直到您取消它。

创建事件运维任务包括如下步骤:

  1. 设置事件匹配规则
  2. 选择模板
  3. 设置模板的执行参数

设置事件匹配规则

字段 是否必填 说明
产品类型 从下拉框选择,只能单选。
事件名称 系统事件的名称,可多选,取值参见云产品事件
地域 事件关联资源所在的阿里云地域,可多选。取值请参见地域和可用区
事件等级 事件等级,可选值严重、警告、信息。
事件详情匹配规则 Json格式,用来匹配系统事件的详情。

事件详情匹配规则

系统事件的事件详情是一个Json,不同的系统事件的详情包含的字段不同。您可以根据详情中的字段对系统事件进行精细的筛选。以ECS的 生命周期状态变化为例,其事件详情(事件消息体中content的值)格式如下:
{
    "resourceId": "i-bp1ecr********5go2go",  
    "resourceType": "ALIYUN::ECS::Instance", 
    "state": "Running"                       
}

此事件详情中的resourceId是发生状态变更的ECS实例Id,state有Pending/Starting/Running/Stopping/Stopped/Delete多个可选值。

事件详情匹配规则也是一个Json,其中的key与事件详情中的key相同,value是您需要匹配出的 值或者值的列表。如果要匹配实例停机的事件,可以如下配置:
{
  "state": "Stopped"
}
如果要匹配实例i-abcde停机或者释放的事件,可以如下配置:
{
  "resourceId": "i-abcde",
  "state": ["Stopped", "Deleted"]
}

在配置事件详情匹配规则时,您可以参考页面显示的事件消息体格式示例(事件消息体中content部分为事件详情)。

选择模板

选择在系统事件发生时需要执行的模板。

设置模板的执行参数

模板参数中可以填入固定值,也可以从事件消息体选择参数。当选择固定参数时,总是使用固定参数执行模板。选择从事件消息体选择参数时,可以配置jq表达式,从事件消息体中提取字段。

从事件消息体中提取字段,使用$开头,加上jq表达式。比如我们要从ECS的生命周期状态变化事件消息体中提取事件详情(content)中的resourceId,应该使用$.content.resourceId。如果要提取地域ID,使用$.regionId

事件消息体中有以下固定字段可以提取:
提取表达式 说明 示例值
$.id 事件ID。 9435EAD6-3CF6-4494-8F7A-3A**77
$.eventTime 事件发生时间,采用UTC+8时区。 20181226T220114.058+0800
$.level 事件级别。取值范围:INFO、WARN、CRITICAL INFO
$.name 事件名称代码。 Instance:StateChange
$.regionId 阿里云地域ID。取值请参见地域和可用区 cn-hangzhou
$.product 产品名称代码 ECS
$.resourceId 资源的ARN值(Aliyun Resource Name,阿里云全局资源描述符)。 acs:ecs:cn-hangzhou:169070**30:instance/i-bp1ecr**5go2go
$.userId 云账号ID。 169070**30
$.content.fieldName 从事件详情中提取fieldName字段的值。
从事件消息体选择参数:

使用固定参数,和普通模板参数设置方法一致。