5.7 事件监控
5.7.1 上报事件
功能介绍
事件监控为您提供上报自定义事件的接口，方便您将业务产生的异常事件或重要变更 事件采集上报到云监控服务。
调试
您可以在API Explorer中调试该接口。
URI
POST /V1.0/{project_id}/events
● 参数说明
表5-122 参数说明
名称 是否必选 说明
project_id 是 项目ID。
获取方式请参见获取项目ID。
● 样例
POST https://{云监控的endpoint}/V1.0/{project_id}/events
请求消息
● 请求参数
表5-123 参数说明
名称 参数类型 是否必
选
说明
数组元素 Arrays of
objects 是 事件列表。
表5-124 数组元素
名称 是否必选 参数类型 说明
event_name 是 String 事件名称。
必须以字母开头，只能包含0-9/a-z/A-Z/_，长度最短为1，最大为 64。
event_sourc
e 否 String 事件来源。
格式为service.item，根据实际情况 自定义配置。
service和item必须是字符串，必须 以字母开头，只能包含0-9/a-z/A-Z/_，service.item总长度最短为3，
最大为32。
time 是 long 事件发生时间。UNIX时间戳，单位
毫秒。
说明
因为客户端到服务器端有延时，因此插 入数据的时间戳应该在[当前时间-1小时 +20秒，当前时间+10分钟-20秒]区间 内，保证到达服务器时不会因为传输时 延造成数据不能插入数据库。
例如，当前时间为2020.01.30
12:00:30，则插入时间的时间戳应该在 [2020.01.30 11:00:50, 2020.01.30 12:10:10]区间内。对应的Unix时间戳是 [1580353250, 1580357410]。
名称 是否必选 参数类型 说明 detail 是 Arrays of
objects 事件详情。
详细参数请参见表5-125。
表5-125 detail 字段数据结构说明
名称 是否必选 参数类型 说明
content 否 String 事件内容，最大长度4096。
group_id 否 String 所属分组。
资源分组对应的ID，必须是已存在 的分组ID。
分组ID查询方法：
1. 登录管理控制台。
2. 单击“云监控服务”。
3. 单击页面左侧的“资源分组”。
在名称/ID列获取具体资源分组 ID。
resource_id 否 String 资源ID，支持字母、数字_ -：，最 大长度128。
例如，6a69bf28-ee62-49f3-9785-845dacd799ec。
资源ID的查询方法：
1. 登录管理控制台。
2. 单击“计算 > 弹性云服务器”。
在资源概览页可获取具体资源 ID。
resource_na
me 否 String 资源名称，支持字母 中文 数字_
-. ，最大长度128。
event_state 否 String 事件状态。
枚举类型：normal\warning
\incident event_level 否 String 事件级别。
枚举类型：Critical, Major, Minor, Info
event_user 否 String 事件用户。
支持字母 数字_ -/空格 ，最大长度 64。
● 请求样例
[{ "event_name":"systemInvaded",
"event_source":"financial.System", "time":1522121194000,
"detail":{
"content":"The financial system was invaded", "group_id":"rg15221211517051YWWkEnVd", "resource_id":"1234567890sjgggad", "resource_name":"ecs001",
"event_state":"normal", "event_level":"Major", "event_user":"xiaokong"
} },{
"event_name":"systemInvaded", "event_source":"financial.System", "time":1522121194020,
"detail":{
"content":"The financial system was invaded", "group_id":"rg15221211517051YWWkEnVd", "resource_id":"1234567890sjgggad", "resource_name":"ecs001",
"event_state":"normal",
objects 事件列表。
表5-127 响应参数
名称 是否必选 参数类型 说明
event_id 是 String 事件ID。
event_nam
"event_id":"evdgiqwgedkkcvhdjcdu346", "event_name":"systemInvaded"
}, {
"event_id":"evdgiqwgedkkcvhdjcdu347", "event_name":"systemParalysis"
} ]
返回值
● 正常 201
● 异常
返回值 说明
400 Bad Request 请求错误。
401 Unauthorized 未提供认证信息，或认证信息错误。
403 Forbidden 请求页面被禁止访问。
408 Request Timeout 请求超出了服务器的等待时间。
429 Too Many
Requests 当前请求过多。
500 Internal Server
Error 请求未完成，服务异常。
503 Service
Unavailable 系统暂时不可用，请求受限。
错误码
请参考返回错误码说明。