统计事件告警信息
功能介绍
该接口用于分段统计指定条件下的事件、告警。
URI
POST /v2/{project_id}/events/statistic
参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
project_id | 是 | String | 租户从IAM申请到的projectid，一般为32位字符串。 |
参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
type | 否 | String | 查询类型。type=active_alert代表查询活动告警，type=history_alert代表查询历史告警。不传或者传其他值则返回指定查询条件的所有信息。 枚举值：
|
请求参数
参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
X-Auth-Token | 是 | String | 从IAM服务获取的用户Token。 |
Content-Type | 是 | String | 指定类型为application/json。 |
参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
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 | 查询条件组合，可以为空。 |
响应参数
状态码： 200
参数 | 参数类型 | 描述 |
|---|---|---|
step | Long | 统计步长。毫秒数，例如一分钟则填写为60000。 |
timestamps | Array of integers | 统计结果对应的时间序列。 |
series | Array of EventSeries objects | 事件或者告警不同级别相同时间序列对应的统计结果。 |
参数 | 参数类型 | 描述 |
|---|---|---|
event_severity | String | 事件或者告警级别枚举类型。 枚举值：
|
values | Array of integers | 事件或者告警统计结果。 |
状态码： 400
参数 | 参数类型 | 描述 |
|---|---|---|
error_code | String | 响应码。 枚举值：
|
error_msg | String | 调用失败响应信息描述。 枚举值：
|
error_type | String | 调用失败类型。 枚举值：
|
状态码： 401
参数 | 参数类型 | 描述 |
|---|---|---|
error_code | String | 响应码。 枚举值：
|
error_msg | String | 调用失败响应信息描述。 枚举值：
|
error_type | String | 调用失败类型。 枚举值：
|
状态码： 403
参数 | 参数类型 | 描述 |
|---|---|---|
error_code | String | 响应码。 枚举值：
|
error_msg | String | 调用失败响应信息描述。 枚举值：
|
error_type | String | 调用失败类型。 枚举值：
|
状态码： 500
参数 | 参数类型 | 描述 |
|---|---|---|
error_code | String | 响应码。 枚举值：
|
error_msg | String | 调用失败响应信息描述。 枚举值：
|
error_type | String | 调用失败类型。 枚举值：
|
状态码： 503
参数 | 参数类型 | 描述 |
|---|---|---|
error_code | String | 响应码。 枚举值：
|
error_msg | String | 调用失败响应信息描述。 枚举值：
|
error_type | String | 调用失败类型。 枚举值：
|
请求示例
以步长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 被请求的服务无效。 建议直接修改该请求，不要重试该请求。 |
错误码
请参见错误码。
