文档首页> 应用运维管理 AOM> API参考（安卡拉区域）> API> 事件告警> 统计事件告警信息
更新时间：2024-04-15 GMT+08:00
查看PDF

统计事件告警信息

功能介绍

该接口用于分段统计指定条件下的事件、告警。

URI

POST /v2/{project_id}/events/statistic

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

租户从IAM申请到的projectid，一般为32位字符串。
表2 Query参数

参数

是否必选

参数类型

描述

type

否

String

查询类型。type=active_alert代表查询活动告警，type=history_alert代表查询历史告警。不传或者传其他值则返回指定查询条件的所有信息。

枚举值：

  • history_alert

  • active_alert

请求参数

表3 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

从IAM服务获取的用户Token。

Content-Type

是

String

指定类型为application/json。
表4 请求Body参数

参数

是否必选

参数类型

描述

time_range

是

String

查询时间范围。格式：开始时间UTC毫秒.结束时间UTC毫秒.时间范围分钟数。开始和结束时间为-1时，表示最近N分钟，N为时间范围分钟取值。查询时间段，如最近五分钟可以表示为-1.-1.5，固定的时间范围（2017-08-01 08:00:00到2017-08-02 08:00:00）可以表示为1501545600000.1501632000000.1440。

step

否

Long

统计步长。毫秒数，例如一分钟则填写为60000。

search

否

String

模糊查询匹配字段，可以为空。如果值不为空，可以模糊匹配metadata字段中的必选字段的值。

sort

否

sort object

返回列表的排序方式，可以为空。

metadata_relation

否

Array of RelationModel objects

查询条件组合，可以为空。
表5 sort

参数

是否必选

参数类型

描述

order_by

否

Array of strings

排序字段列表。会根据列表中定义顺序对返回列表进行排序。

order

否

String

排序方式枚举值。asc代表正序，desc代表倒叙。

枚举值：

  • asc

  • desc
表6 RelationModel

参数

是否必选

参数类型

描述

key

否

String

指定查询字段的key，对应metadata里面的key 。

value

否

Array of strings

查询条件中指定key的值。

relation

否

String

该条件与其他条件的组合方式。 AND：必须满足所有条件； OR：可以满足其中一个条件； NOT：必须不满足所有条件。

枚举值：

  • AND

  • OR

  • NOT

响应参数

状态码： 200

表7 响应Body参数

参数

参数类型

描述

step

Long

统计步长。毫秒数，例如一分钟则填写为60000。

timestamps

Array of integers

统计结果对应的时间序列。

series

Array of EventSeries objects

事件或者告警不同级别相同时间序列对应的统计结果。
表8 EventSeries

参数

参数类型

描述

event_severity

String

事件或者告警级别枚举类型。

枚举值：

  • Critical

  • Major

  • Minor

  • Info

values

Array of integers

事件或者告警统计结果。

状态码： 400

表9 响应Body参数

参数

参数类型

描述

error_code

String

响应码。

枚举值：

  • AOM.0403

error_msg

String

调用失败响应信息描述。

枚举值：

  • Invalid projectId

error_type

String

调用失败类型。

枚举值：

  • Forbidden

状态码： 401

表10 响应Body参数

参数

参数类型

描述

error_code

String

响应码。

枚举值：

  • AOM.0403

error_msg

String

调用失败响应信息描述。

枚举值：

  • Invalid projectId

error_type

String

调用失败类型。

枚举值：

  • Forbidden

状态码： 403

表11 响应Body参数

参数

参数类型

描述

error_code

String

响应码。

枚举值：

  • AOM.0403

error_msg

String

调用失败响应信息描述。

枚举值：

  • Invalid projectId

error_type

String

调用失败类型。

枚举值：

  • Forbidden

状态码： 500

表12 响应Body参数

参数

参数类型

描述

error_code

String

响应码。

枚举值：

  • AOM.0403

error_msg

String

调用失败响应信息描述。

枚举值：

  • Invalid projectId

error_type

String

调用失败类型。

枚举值：

  • Forbidden

状态码： 503

表13 响应Body参数

参数

参数类型

描述

error_code

String

响应码。

枚举值：

  • AOM.0403

error_msg

String

调用失败响应信息描述。

枚举值：

  • Invalid projectId

error_type

String

调用失败类型。

枚举值：

  • Forbidden

请求示例

以步长step查询当前时间范围（time_range）内的事件、告警统计信息。

POST https://{endpoint}/v2/{project_id}/events/statistic

{
  "time_range" : "-1.-1.5",
  "step" : 60000
}

响应示例

状态码： 200

OK

请求响应成功。

{
  "series" : [ {
    "event_severity" : "Minor",
    "values" : [ 0, 0, 0, 0, 0, 0 ]
  }, {
    "event_severity" : "Info",
    "values" : [ 0, 0, 0, 0, 0, 0 ]
  } ],
  "step" : 60000,
  "timestamps" : [ 1642820700000, 1642820760000, 1642820820000, 1642820880000, 1642820940000, 1642821000000 ]
}

状态码： 400

BadRequest

非法请求。 建议直接修改该请求，不要重试该请求。

{
  "error_code" : "AOM.0400",
  "error_message" : "param error",
  "error_type" : "SC_BAD_REQUEST"
}

状态码： 401

Unauthorized

在客户端提供认证信息后，返回该状态码，表明服务端指出客户端所提供的认证信息不正确或非法。

{
  "error_code" : "AOM.0401",
  "error_message" : "you dont have permission",
  "error_type" : "SC_UNAUTHORIZED"
}

状态码： 403

Forbidden

请求被拒绝访问。返回该状态码，表明请求能够到达服务端，且服务端能够理解用户请求，但是拒绝做更多的事情，因为该请求被设置为拒绝访问，建议直接修改该请求，不要重试该请求。

{
  "error_code" : "AOM.0403",
  "error_message" : "you dont have permission",
  "error_type" : "SC_FORBIDDEN"
}

状态码： 500

InternalServerError

表明服务端能被请求访问到，但是不能理解用户的请求。

{
  "error_code" : "AOM.0500",
  "error_message" : "SC_INTERNAL_SERVER_ERROR",
  "error_type" : "SC_INTERNAL_SERVER_ERROR"
}

状态码： 503

ServiceUnavailable

被请求的服务无效。 建议直接修改该请求，不要重试该请求。

{
  "error_code" : "AOM.0503",
  "error_message" : "SC_NOT_IMPLEMENTED",
  "error_type" : "SC_NOT_IMPLEMENTED"
}

状态码

状态码

描述

200

OK

请求响应成功。

400

BadRequest

非法请求。 建议直接修改该请求，不要重试该请求。

401

Unauthorized

在客户端提供认证信息后，返回该状态码，表明服务端指出客户端所提供的认证信息不正确或非法。

403

Forbidden

请求被拒绝访问。返回该状态码，表明请求能够到达服务端，且服务端能够理解用户请求，但是拒绝做更多的事情，因为该请求被设置为拒绝访问，建议直接修改该请求，不要重试该请求。

500

InternalServerError

表明服务端能被请求访问到，但是不能理解用户的请求。

503

ServiceUnavailable

被请求的服务无效。 建议直接修改该请求，不要重试该请求。

错误码

请参见错误码。

父主题： 事件告警