文档首页/ 云监控服务 CES/ API参考/ API/ 事件监控/ 事件监控/ 查询某一事件监控详情
更新时间：2025-08-26 GMT+08:00
在线调试
CLI示例
查看PDF
分享

查询某一事件监控详情

功能介绍

根据事件监控名称，查询该事件发生的详细信息。

事件子类参数当前只在华东-上海一、华东-上海二、华北-北京四、华南-广州区域上线，其余区域持续上线中。

调试

您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。

URI

GET /V1.0/{project_id}/event/{event_name}

  • 参数说明
    表1 参数说明

    名称

    类型

    是否必选

    说明

    project_id

    String

    是

    参数解释：

    项目ID，用于明确项目归属，配置后可通过该ID查询项目下资产，可以通过调用API获取，也可以从控制台获取。

    获取方式请参见获取项目ID。

    约束限制：

    不涉及。

    取值范围：

    字符串长度在1 ~64 之间。

    默认取值：

    不涉及。

    event_name

    String

    是

    参数解释：

    事件名称，值为系统产生的事件名称或用户自定义上报的事件名称。

    约束限制：

    不涉及。

    取值范围：

    最小长度为1，最大长度为64。

    默认取值：

    不涉及。

    event_type

    String

    是

    参数解释：

    事件类型。

    约束限制：

    不涉及。

    取值范围：

    值为EVENT.SYS或EVENT.CUSTOM。

    • EVENT.SYS：系统事件。
    • EVENT.CUSTOM：自定义事件。

    默认取值：

    不涉及。

    sub_event_type

    String

    否

    参数解释：

    事件子类。

    约束限制：

    不涉及。

    取值范围：

    枚举类型，当事件类型为系统事件时，参数值为SUB_EVENT.OPS或SUB_EVENT.PLAN。SUB_EVENT.OPS为运维事件，SUB_EVENT.PLAN为计划事件。当事件类型为自定义事件时，参数值为SUB_EVENT.CUSTOM，表示自定义事件。

    默认取值：

    SUB_EVENT.OPS

    event_source

    String

    否

    参数解释：

    事件来源，取值为各云服务的命名空间。云服务的命名空间请参见事件监控支持的事件说明。

    约束限制：

    不涉及。

    取值范围：

    字符长度不能超过32位。

    正则匹配：^((([a-z]|[A-Z]){1}([a-z]|[A-Z]|[0-9]|_)*\.([a-z]|[A-Z]){1}([a-z]|[A-Z]|[0-9]|_)*)|)$

    默认取值：

    不涉及。

    event_level

    String

    否

    参数解释：

    事件的级别，值为Critical、Major、Minor、Info。Critical为紧急，Major为重要，Minor为次要，Info为提示。

    约束限制：

    不涉及。

    取值范围：

    值为Critical、Major、Minor、Info。

    默认取值：

    不涉及。

    event_user

    String

    否

    参数解释：

    上报事件监控数据时用户的名称，也可为projectID。

    约束限制：

    不涉及。

    取值范围：

    字符长度不能超过64位。

    正则匹配：^([a-z]|[A-Z]|[0-9]|_|-|\/| |@|\.|)+$

    默认取值：

    不涉及。

    event_state

    String

    否

    参数解释：

    事件的状态，，值为normal、warning、incident。normal为正常，warning为警告，incident为故障。

    约束限制：

    不涉及。

    取值范围：

    值为normal、warning、incident。

    默认取值：

    不涉及。

    from

    Long

    否

    参数解释：

    查询数据起始时间，UNIX时间戳，单位毫秒。例如：1605952700911。

    约束限制：

    不涉及。

    取值范围：

    不涉及。

    默认取值：

    不涉及。

    to

    Long

    否

    参数解释：

    查询数据截止时间，UNIX时间戳，单位毫秒。

    约束限制：

    其中from必须小于to。

    取值范围：

    不涉及。

    默认取值：

    不涉及。

    start

    Integer

    否

    参数解释：

    分页起始值。

    约束限制：

    不涉及。

    取值范围：

    大于等于0

    正则匹配：^(0|[1-9][0-9]*)$

    默认取值：

    0

    limit

    Integer

    否

    参数解释：

    单次查询的条数限制，取值范围(0,100]，默认值为100，用于限制结果数据条数。

    约束限制：

    不涉及。

    取值范围：

    最小值1，最大值100。

    正则匹配：^([1-9]|[1-9][0-9]|100)$

    默认取值：

    100
  • 样例 
    GET https://{云监控的endpoint}/V1.0/{project_id}/event/{event_name}

请求消息

无

响应消息

  • 响应参数
表2 参数说明

名称

类型

是否必选

描述

event_name

String

否

参数解释：

事件名称，值为系统产生的事件名称，或用户自定义上报的事件名称。

取值范围：

不涉及。

event_type

String

否

参数解释：

事件类型。

取值范围：

值为EVENT.SYS或EVENT.CUSTOM。

  • EVENT.SYS表示系统事件。
  • EVENT.CUSTOM表示自定义事件。

sub_event_type

String

否

参数解释：

事件子类。

取值范围：

枚举类型。

当事件类型为系统事件时，参数值为SUB_EVENT.OPS或SUB_EVENT.PLAN。

当事件类型为自定义事件时，参数值为SUB_EVENT.CUSTOM。

  • SUB_EVENT.OPS：运维事件。
  • SUB_EVENT.PLAN：计划事件。
  • SUB_EVENT.CUSTOM：自定义事件。

event_users

Array of strings

否

参数解释：

上报事件时用户的名称，也可能为projectID。

取值范围：

不涉及。

event_sources

Array of strings

否

参数解释：

事件来源。

如果是系统事件则值为各服务的命名空间，可查看支持监控的服务列表。如果是自定义事件，则为用户自定义上报定义。

取值范围：

不涉及。

event_info

Array of objects

否

参数解释：

一条或者多条事件详细信息。

详细参数说明请参见表3。

meta_data

MetaData object

否

参数解释：

查询结果元数据统计个数。详细参数说明请参见表6。
表3 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

是

参数解释：

事件详情。

详细参数说明请参见表4。

event_id

String

否

参数解释：

事件ID。

取值范围：

不涉及。
表4 detail字段数据结构说明

名称

类型

是否必选

描述

content

String

否

参数解释：

事件内容。

取值范围：

最大长度4096。

group_id

String

否

参数解释：

所属分组。

取值范围：

长度只能为24个字符。

resource_id

String

否

参数解释：

资源ID。

取值范围：

最大长度128。

resource_name

String

否

参数解释：

资源名称。

取值范围：

最大长度128。

event_state

String

否

参数解释：

事件状态。

取值范围：

枚举类型：normal\warning\incident。

  • normal为正常
  • warning为警告
  • incident为故障

event_level

String

否

参数解释：

事件级别。

取值范围：

枚举类型：Critical, Major, Minor, Info。

  • Critical为紧急
  • Major为重要
  • Minor为次要
  • Info为提示

event_user

String

否

参数解释：

事件用户。

取值范围：

最大长度64。

event_type

String

否

参数解释：

事件类型。

取值范围：

枚举类型：EVENT.SYS，EVENT.CUSTOM

  • EVENT.SYS为系统事件。
  • EVENT.CUSTOM为自定义事件。

sub_event_type

String

否

参数解释：

事件子类。

取值范围：

枚举类型。

当事件类型为系统事件时，参数值为SUB_EVENT.OPS或SUB_EVENT.PLAN，默认值为SUB_EVENT.OPS。

当事件类型为自定义事件时，参数值为SUB_EVENT.CUSTOM。

  • SUB_EVENT.OPS：运维事件。
  • SUB_EVENT.PLAN：计划事件。
  • SUB_EVENT.CUSTOM：自定义事件。

dimensions

Array of objects

否

参数解释：

事件的维度，根据维度描述资源信息。

用于指定资源、资源分组的事件告警场景中，支持按维度配置告警规则。

详细参数说明请参见表5。

取值范围：

目前最大支持4个维度
表5 dimensions 字段数据结构说明

名称

类型

是否必选

描述

name

String

否

参数解释：

监控维度名称，例如弹性云服务器的维度为instance_id。各服务维度请参考支持监控的服务列表，可参考维度中key字段。

取值范围：

不涉及。

value

String

否

参数解释：

维度取值，例如弹性云服务器的ID。

取值范围：

长度为[1,256]个字符。
表6 meta_data字段数据结构说明

名称

类型

是否必选

描述

total

Integer

否

参数解释：

总条数。

取值范围：

不涉及。
  • 响应样例 
    {
 "event_name": "rebootServer",
 "event_type": "EVENT.SYS",
 "sub_event_type": "SUB_EVENT.OPS",
 "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_state": "normal",
       "event_level": "Minor",
       "event_user": "",
       "event_type": "EVENT.SYS",
       "sub_event_type": "SUB_EVENT.OPS",
       "dimensions": [
         {
           "name": "instance_id",
           "value": "fddad01f-e3b6-420d-8fdc-a42451de7c34"
         }
       ]
     }
   },
   {
     "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_level": "Minor",
       "event_user": "",
       "event_type": "EVENT.SYS",
       "sub_event_type": "SUB_EVENT.OPS",
       "dimensions": [
         {
           "name": "instance_id",
           "value": "fddad01f-e3b6-420d-8fdc-a42451de7c34"
         }
       ]
     }
   },
   {
     "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",
       "event_level": "Minor",
       "event_user": "",
       "event_type": "EVENT.SYS",
       "sub_event_type": "SUB_EVENT.OPS",
       "dimensions": [
         {
           "name": "instance_id",
           "value": "fddad01f-e3b6-420d-8fdc-a42451de7c34"
         }
       ]
     }
   }
 ],
 "meta_data": {
   "total": 5
 }
}

返回值

  • 正常

    200

  • 异常

    返回值

    说明

    400 Bad Request

    请求错误。

    401 Unauthorized

    未提供认证信息，或认证信息错误。

    403 Forbidden

    请求页面被禁止访问。

    408 Request Timeout

    请求超出了服务器的等待时间。

    429 Too Many Requests

    当前请求过多。

    500 Internal Server Error

    请求未完成，服务异常。

    503 Service Unavailable

    系统暂时不可用，请求受限。

错误码

请参考返回错误码说明。

父主题： 事件监控

相关文档