背景
事件通知旨在傳遞資源變化信息。通過設置事件通知,您還可以為事件配置消息處理中間件,實現事件驅動的自動化運維,取代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 |