背景
事件通知旨在传递资源变化信息。通过设置事件通知,您还可以为事件配置消息处理中间件,实现事件驱动的自动化运维,取代SDK轮询的方式。系统运维管理 OOS(CloudOps Orchestration Service)(OOS)已经支持事件通知,包括模板执行状态通知和任务执行状态通知。系统事件的使用方式与功能介绍请查看系统事件和使用云产品事件报警功能。
模板执行状态通知
系统运维管理系统在模板执行状态发生变化时发出通知:
当前仅支持在执行状态变为Failed时发出事件通知
云产品动作创建的子执行不发出事件通知
通知格式
{
"ver": "1.0",
"id": "2256A988-0B26-4E2B-820A-8A0580D0B8E5",
"product": "OOS",
"resourceId": "acs:ecs:cn-hangzhou:169070********30:execution/exec-abc1792gcdoonr9an2uk",
"level": "INFO",
"name": "Execution:ExecutionStatusChange",
"userId": "169070********30",
"eventTime": "20190409T121826.922+0800",
"regionId": "cn-hangzhou",
"content": {
"executionId" : "exec-abc1792gcdoonr9an2uk",
"status" : "Success",
"templateId" : "t-89fb84c218e84fd58e14",
"templateVersion" : "v8",
"templateName" : "templateName",
"executedBy" : "admin(1234567)",
"startTime" : "2019-11-11T12:00Z",
"endTime" : "2019-11-11T13:00Z",
"duration" : 360,
"parentExecutionId" : "exec-3816c2a99c9146979da6"
}
}
事件属性
事件通知的顶层字段包含以下固定字段:
字段 | 说明 | 示例值 |
id | 事件ID。 | 9435EAD6-3CF6-4494-8F7A-3A********77 |
eventTime | 事件发生时间,采用UTC+8时区。 | 20181226T220114.058+0800 |
level | 事件级别。 | INFO |
name | 事件名称。 | Execution:StatusChange |
product | 产品名称。取值范围:OOS。 | OOS |
regionId | 阿里云地域ID。取值请参见DescribeRegions。 | cn-hangzhou |
resourceId | 资源的ARN值(Aliyun Resource Name,阿里云全局资源描述符)。 | acs:ecs:cn-hangzhou:1169070********30:execution/exec-abc1792gcdoonr9an2uk |
userId | 云账号ID。 | 169070********30 |
content | 事件详情,包含一个或多个下级参数。详情见content字段解释。 | 无 |
content字段解释:
字段 | 说明 | 示例值 |
executionId | 模板执行ID。 | exec-abc1792gcdoonr9an2uk |
status | 执行状态。 | Success |
templateId | 模板ID。 | t-89fb84c218e84fd58e14 |
templateVersion | 模板版本。 | v8 |
templateName | 模板名称。 | templateName |
executedBy | 执行人。 | admin(1234567) |
startTime | 执行开始事件。 | 2019-11-11T11:00:00Z |
endTime | 执行结束时间。 | 2019-11-11T11:00:02Z |
duration | 执行耗时,单位为秒。 | |
parentExecutionId | 父执行ID。 | exec-3816c2a99c9146979da6 |
任务执行状态通知
系统运维管理系统在模板任务执行状态发生变化时发出通知:
当前仅支持在任务执行状态变为Failed时发出事件通知
云产品动作创建的任务不发出事件通知
通知格式
{
"ver": "1.0",
"id": "2256A988-0B26-4E2B-820A-8A0580D0B8E5",
"product": "OOS",
"resourceId": "acs:ecs:cn-hangzhou:169070********30:taskexecution/task-exec-abc1792gcdoonr9an2uk",
"level": "INFO",
"name": "TaskExecution:StatusChange",
"userId": "169070********30",
"eventTime": "20190409T121826.922+0800",
"regionId": "cn-hangzhou",
"content": {
"taskExecutionId" : "task-exec-abc",
"taskAction" : "ACS::ExecuteApi",
"taskName" : "taskName",
"executionId" : "exec-18864d6b80a448dcbe62",
"status" : "Success",
"templateId" : "t-89fb84c218e84fd58e14",
"templateVersion" : "v8",
"templateName" : "templateName",
"startTime" : "2019-11-11T12:00Z",
"endTime" : "2019-11-11T12:01Z",
"duration" : 60
}
}
事件属性
事件通知的顶层字段包含以下固定字段:
字段 | 说明 | 示例值 |
id | 事件ID。 | 9435EAD6-3CF6-4494-8F7A-3A********77 |
eventTime | 事件发生时间,采用UTC+8时区。 | 20181226T220114.058+0800 |
level | 事件级别。 | INFO |
name | 事件名称。 | TaskExecution:StatusChange |
product | 产品名称。取值范围:OOS。 | OOS |
regionId | 阿里云地域ID。取值请参见DescribeRegions。 | cn-hangzhou |
resourceId | 资源的ARN值(Aliyun Resource Name,阿里云全局资源描述符)。 | acs:ecs:cn-hangzhou:169070********30:taskexecution/task-exec-abc1792gcdoonr9an2uk |
userId | 云账号ID。 | 169070********30 |
content | 事件详情,包含一个或多个下级参数。详情见content字段解释。 | 无 |
content字段解释:
字段 | 说明 | 示例值 |
taskExecutionId | 任务执行ID | task-exec-abc1792gcdoonr9an2uk |
status | 任务执行状态。 | Success |
taskAction | 任务动作 | ACS::ExecuteApi |
taskName | 任务名称 | taskName |
executionId | 执行ID | exec-18864d6b80a448dcbe62 |
templateId | 模板ID。 | t-89fb84c218e84fd58e14 |
templateVersion | 模板版本。 | v8 |
templateName | 模板名称。 | templateName |
executedBy | 执行人。 | admin(1234567) |
startTime | 任务执行开始时间。 | 2019-11-11T11:00:00Z |
endTime | 任务执行结束时间。 | 2019-11-11T11:00:01Z |
duration | 任务执行耗时,单位为秒。 | 60 |