查询事件监控列表
功能介绍
查询事件列表,包括系统事件和自定义事件。
调试
您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。
URI
GET /V1.0/{project_id}/events
- 参数说明
表1 参数说明 名称
类型
是否必选
说明
project_id
String
是
项目ID。
获取方式请参见获取项目ID。
event_type
String
否
事件类型,值为EVENT.SYS或EVENT.CUSTOM。EVENT.SYS表示系统事件,EVENT.CUSTOM表示自定义事件。
event_name
String
否
事件名称,值为系统产生的事件名称或用户自定义上报的事件名称。
from
Integer
否
查询数据起始时间,UNIX时间戳,单位毫秒,例如:1605952700911。
to
Integer
否
查询数据截止时间,UNIX时间戳,单位毫秒。from必须小于to,例如:1606557500911。
start
Integer
否
分页起始值,类型为integer,默认值为0。
limit
Integer
否
单次查询的条数限制,取值范围(0,100],默认值为100,用于限制结果数据条数。
- 样例
GET https://{云监控的endpoint}/V1.0/{project_id}/events
请求消息
无
响应消息
- 响应参数
名称 |
类型 |
是否必选 |
描述 |
---|---|---|---|
events |
Array of Events objects |
否 |
一条或者多条事件数据。 详细参数说明请参见表3。 |
meta_data |
MetaData object |
否 |
查询结果元数据统计个数。 详细参数说明请参见表4。 |
名称 |
类型 |
是否必选 |
描述 |
---|---|---|---|
event_name |
String |
否 |
事件名称。 |
event_type |
String |
否 |
事件类型。 |
event_count |
Integer |
否 |
选择查询的时间范围内,此事件发生的数量。 |
latest_occur_time |
Long |
否 |
此事件最近一次发生的时间。 |
latest_event_source |
String |
否 |
事件来源,如果是系统事件则值为各服务的命名空间,可查看支持监控的服务列表。 如果是自定义事件,则为用户自定义上报定义。 |
- 响应样例
{ "events": [ { "event_name": "rebootServer", "event_type": "EVENT.SYS", "event_count": 5, "latest_occur_time": 1606302400000, "latest_event_source": "SYS.ECS" }, { "event_name": "deleteVolume", "event_type": "EVENT.SYS", "event_count": 6, "latest_occur_time": 1606300359126, "latest_event_source": "SYS.EVS" }, { "event_name": "event_001", "event_type": "EVENT.CUSTOM", "event_count": 4, "latest_occur_time": 1606499035522, "latest_event_source": "TEST.System" } ], "meta_data": { "total": 10 } }
返回值
错误码
请参考返回错误码说明。