5.7 事件监控
5.7.3 查询某一事件监控详情
功能介绍
根据事件监控名称，查询该事件发生的详细信息。
调试
您可以在API Explorer中调试该接口。
URI
GET /V1.0/{project_id}/event/{event_name}
● 参数说明
表5-132 参数说明
名称 是否必选 说明
project_id 是 项目ID。
获取方式请参见获取项目ID。
名称 是否必选 说明 event_name String 是
事件名称。
event_type String 是
事件类型，值为EVENT.SYS或
EVENT.CUSTOM。EVENT.SYS表示系统事件，
EVENT.CUSTOM表示自定义事件。
event_source String 否
事件名称，值为系统产生的事件名称，或用户 自定义上报的事件名称。
event_level String 否
事件的级别，值为Critical、Major、Minor、
Info。Critical为紧急，Major为重要，Minor为 次要，Info为提示。
event_user String 否
上报事件监控数据时用户的名称，也可为 projectID。
event_state String 否
事件的状态，值为normal、warning、
incident。normal为正常，warning为警告，
incident为故障。
from Integer 否
查询数据起始时间，UNIX时间戳，单位毫秒。
例如：1605952700911。
to Integer 否
查询数据截止时间，UNIX时间戳，单位毫秒。
其中from必须小于to。
start Integer 否
分页起始值，类型为integer，默认值为0。
limit Integer 否
单次查询的条数限制，取值范围(0,100]，默认 值为100，用于限制结果数据条数。
● 样例
GET https://{云监控的endpoint}/V1.0/{project_id}/event/{event_name}
请求消息
无
响应消息
● 响应参数
表5-133 参数说明
名称 类型 是否必选 描述
event_name string 否 事件名称，值为系统产生的事件名 称，或用户自定义上报的事件名称。
event_type string 否 事件类型，值为EVENT.SYS或
EVENT.CUSTOM。EVENT.SYS表示系 统事件，EVENT.CUSTOM表示自定 义事件。
event_users Array of
strings 否 上报事件时用户的名称，也可能为 projectID。
event_sources Array of
strings 否 事件来源。如果是系统事件则值为各 服务的命名空间，可查看支持监控的 服务列表。如果是自定义事件，则为 用户自定义上报定义。
event_info Array of
objects 否 一条或者多条事件详细信息。
meta_data MetaData
object 否 查询结果元数据统计个数。
表5-134 event_info 字段数据结构说明
名称 类型 是否必选 描述
event_name string 是 事件名称。必须以字母开头，只能包 含0-9/a-z/A-Z/_，长度最短为1，最 大为64。
event_source string 否 事件来源，格式为service.item。
service和item必须是字符串，必须以 字母开头，只能包含0-9/a-z/A-Z/_，
总长度最短为3，最大为32。
time long 是 事件发生时间。UNIX时间戳，单位毫
秒。 说明：因为客户端到服务器端有 延时，因此插入数据的时间戳应该在 [当前时间-1小时+20秒,当前时间+10 分钟-20秒]区间内，保证到达服务器 时不会因为传输时延造成数据不能插 入数据库。
detail Detail
object 是 事件详情。
名称 类型 是否必选 描述 event_id string 否 事件ID。
表5-135 detail 字段数据结构说明
名称 类型 是否必
选
描述
content string 否 事件内容，最大长度4096。
group_id string 否 所属分组。 资源分组对应的ID，必须传存 在的分组ID。
resource_id string 否 资源ID，最大长度128。
resource_nam
e string 否 资源名称，最大长度128。
event_state string 否 事件状态。
枚举类型：normal\warning\incident event_level string 否 事件级别。
枚举类型：Critical, Major, Minor, Info event_user string 否 事件用户，最大长度64。
表5-136 meta_data 字段数据结构说明
名称 类型 是否必选 描述
total Integer 否 总条数。
● 响应样例
{ "event_name": "rebootServer", "event_type": "EVENT.SYS", "event_users": [
""
], "event_sources": [ "SYS.ECS"
], "event_info": [
{ "event_id": "ev1606302402256R6doP5YeZ", "event_name": "rebootServer",
"event_source": "SYS.ECS", "time": 1606302400000, "detail": {
"content": "{\"resourceSpecCode\":\"kc1.4xlarge.2.linux\",\"enterpriseProjectId\":
\"6efb843e-391a-46a8-afc8-7fe51c9dd575\"}", "group_id": "",
"resource_id": "ef8dad27-0488-4de7-bb43-1a0df9806d90",
"resource_name": "CES-POROS-0001",
{ "event_id": "ev1606296088071wGoAOxVYa", "event_name": "rebootServer",
"event_source": "SYS.ECS", "time": 1606296086000, "detail": {
"content": "{\"resourceSpecCode\":\"kc1.4xlarge.2.linux\",\"enterpriseProjectId\":
\"6efb843e-391a-46a8-afc8-7fe51c9dd575\"}", "group_id": "",
"resource_id": "ef8dad27-0488-4de7-bb43-1a0df9806d90", "resource_name": "CES-POROS-0001",
"event_state": "normal",
{ "event_id": "ev1604654426090g7g37E6Yb", "event_name": "rebootServer",
"event_source": "SYS.ECS", "time": 1604654425000, "detail": {
"content": "{\"resourceSpecCode\":\"c6.4xlarge.2.linux\",\"enterpriseProjectId\":\"129559eb-f795-4b5f-9e46-cbd43a462362\"}",
"group_id": "",
"resource_id": "0bfa63ee-31f5-40a9-b992-50992c80c58a", "resource_name": "ndrv2-pod-ops-0001",
"event_state": "normal",
"meta_data": { "total": 5
400 Bad Request 请求错误。
401 Unauthorized 未提供认证信息，或认证信息错误。
403 Forbidden 请求页面被禁止访问。
408 Request Timeout 请求超出了服务器的等待时间。
429 Too Many
Requests 当前请求过多。
返回值 说明 500 Internal Server
Error 请求未完成，服务异常。
503 Service
Unavailable 系统暂时不可用，请求受限。
错误码
请参考返回错误码说明。