查询告警历史
功能介绍
查询告警历史列表。
调试
您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。
URI
GET /V1.0/{project_id}/alarm-histories
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
project_id |
是 |
String |
参数解释: 项目ID。用于明确项目归属,配置后可通过该ID查询项目下资产,可以通过调用API获取,也可以从控制台获取。获取方式请参见“获取项目ID”。 约束限制: 不涉及。 取值范围: 长度为[1,64]个字符。 默认取值: 不涉及。 |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
group_id |
否 |
String |
参数解释: 当前资源所在分组信息 约束限制: 不涉及。 取值范围: 以rg开头,后跟22位由字母或数字组成的字符串,字符长度为24 默认取值: 不涉及 |
alarm_id |
否 |
String |
参数解释: 告警规则ID 约束限制: 不涉及 取值范围: 以al开头,后跟22位由字母或数字组成的字符串,字符长度为24 默认取值: 不涉及 |
alarm_name |
否 |
String |
参数解释: 告警规则名称 约束限制: 不涉及 取值范围: 只能包含0-9/a-z/A-Z/_/-或汉字,长度[1, 128]个字符 默认取值: 不涉及 |
alarm_status |
否 |
String |
参数解释: 告警状态。 约束限制: 不涉及 取值范围: 枚举值:
默认取值: 不涉及 |
alarm_level |
否 |
Integer |
参数解释: 告警历史的告警级别,值为1,2,3,4 约束限制: 不涉及 取值范围: 枚举值:
默认取值: 不涉及 |
namespace |
否 |
String |
参数解释: 查询服务的命名空间,各服务命名空间请参考“服务命名空间” 约束限制: 不涉及 取值范围: 格式为service.item;service和item必须是字符串,必须以字母开头,只能包含0-9/a-z/A-Z/_。字符串的长度必须在 3 到 32个字符之间 默认取值: 不涉及 |
from |
否 |
String |
参数解释: 通过时间筛选traces的起始时间(包括传入时间),为timestamp 约束限制: 不涉及 取值范围: 长度为[1,13]个字符 默认取值: 不涉及 |
to |
否 |
String |
参数解释: 通过时间筛选traces的终止时间(包括传入时间),为timestamp 约束限制: 不涉及 取值范围: 长度为[1,13]个字符 默认取值: 不涉及 |
start |
否 |
String |
参数解释: 分页查询时查询的起始位置,表示从第几条数据开始 约束限制: 不涉及。 取值范围: 大于等于0的整数 默认取值: 0 |
limit |
否 |
String |
参数解释: 本次查询的最大条目数 约束限制: 不涉及。 取值范围: 取值范围[1,100] 默认取值: 100 |
请求参数
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
Content-Type |
否 |
String |
参数解释: 发送的实体的MIME类型。 约束限制: 不涉及。 取值范围: 长度为[1,64]个字符。 默认取值: 默认使用 application/json; charset=UTF-8,如果API是对象、镜像上传等接口,媒体类型可按照流类型的不同进行确定。 |
X-Auth-Token |
否 |
String |
参数解释: 用户Token。 约束限制: 不涉及。 取值范围: 长度为[1,16384]个字符。 默认取值: 不涉及。 |
响应参数
状态码:200
参数 |
参数类型 |
描述 |
---|---|---|
alarm_histories |
Array of AlarmHistoryInfoResp objects |
参数解释: 一条或者多条告警历史详细信息 |
meta_data |
MetaDataForAlarmHistoryResp object |
参数解释 查询告警历史返回的总条数。 |
参数 |
参数类型 |
描述 |
---|---|---|
alarm_id |
String |
参数解释: 告警规则的ID,如:al1603131199286dzxpqK3Ez。 取值范围: 字符串长度为24 |
alarm_name |
String |
参数解释: 告警规则的名称,如:alarm-test01 取值范围: 字符串长度在 1 到 128 之间 |
alarm_description |
String |
参数解释: 告警规则的描述 取值范围: 字符串长度在 0 到 256 之间 |
metric |
MetricInfoResp object |
参数解释: 指标信息 |
condition |
ConditionResp object |
参数解释: 告警规则设置的告警策略。 |
alarm_level |
Integer |
参数解释: 告警记录的告警级别。 取值范围: 枚举值:
|
alarm_type |
String |
参数解释: 告警规则类型 取值范围: 枚举值:
|
alarm_enabled |
Boolean |
参数解释: 告警规则是否被启用 取值范围: 值为true或者false
|
alarm_action_enabled |
Boolean |
参数解释: 是否发送通知 取值范围: 值为true或者false
|
alarm_actions |
Array of AlarmActionsResp objects |
参数解释: 告警触发的动作。 结构如下: { "type": "notification", "notificationList": ["urn:smn:southchina:68438a86d98e427e907e0097b7e35d47:sd"] } type取值: notification:通知。 autoscaling:弹性伸缩。 notificationList:告警状态发生变化时,被通知对象的列表。 |
ok_actions |
Array of AlarmActionsResp objects |
参数解释: 告警恢复触发的动作。 结构如下: { "type": "notification", "notificationList": ["urn:smn:southchina:68438a86d98e427e907e0097b7e35d47:sd"] } type取值: notification:通知。 notificationList:告警状态发生变化时,被通知对象的列表。 |
insufficientdata_actions |
Array of AlarmActionsResp objects |
参数解释: 数据不足触发的动作。 结构如下: { "type": "notification", "notificationList": ["urn:smn:southchina:68438a86d98e427e907e0097b7e35d47:sd"] } type取值: 数据不足触发告警通知类型,取值为notification。 notificationList:数据不足触发告警通知时,被通知对象的ID列表。 |
update_time |
Long |
参数解释: 告警状态变更的时间,UNIX时间戳,单位毫秒,如:1603131199000 取值范围: 不涉及 |
enterprise_project_id |
String |
参数解释: 企业项目ID 取值范围: 只能包含小写字母、数字、“-”、“_”,可以自定义企业项目ID,长度为36个字符。也可以为0(代表默认企业项目ID),all_granted_eps(代表所有企业项目ID) |
trigger_time |
Long |
参数解释: 计算出该条告警历史的时间,UNIX时间戳,单位毫秒,如:1603131199469 取值范围: 不涉及 |
alarm_status |
String |
参数解释: 告警历史的状态 取值范围: 枚举值:
|
datapoints |
Array of DataPointForAlarmHistoryResp objects |
参数解释: 计算出该条告警历史的资源监控数据的一组数据上报时间和监控数值 |
additional_info |
AdditionalInfoResp object |
参数解释 告警历史额外字段,仅针对事件监控告警场景所产生的告警历史信息。 |
notification_manner |
String |
参数解释 通知方式 取值范围: 枚举值:
|
参数 |
参数类型 |
描述 |
---|---|---|
namespace |
String |
服务指标命名空间,格式为service.item;service和item必须是字符串,必须以字母开头,只能包含0-9/a-z/A-Z/_,字符总长度最短为3,最大为32。说明: 当alarm_type为(EVENT.SYS| EVENT.CUSTOM)时允许为空;如:弹性云服务器的命名空间为SYS.ECS,文档数据库的命名空间为SYS.DDS,各服务的命名空间可查看:“服务命名空间”。 |
metric_name |
String |
资源的监控指标名称,必须以字母开头,只能包含0-9/a-z/A-Z/_/-,字符长度最短为1,最大为96;如:弹性云服务器中的监控指标cpu_util,表示弹性服务器的CPU使用率;文档数据库中的指标mongo001_command_ps,表示command执行频率;各服务的指标名称可查看:“服务指标名称”。 |
dimensions |
Array of MetricsDimension objects |
参数解释 指标维度,目前最大可添加4个维度。 |
参数 |
参数类型 |
描述 |
---|---|---|
name |
String |
参数解释 资源维度,如:弹性云服务器,则维度为instance_id;目前最大支持4个维度,各服务资源的指标维度名称可查看:“服务指标维度”。 约束限制 不涉及 取值范围 由字母开头,后面可以包含字母、数字、_或-,长度为[1,32]个字符 默认取值 不涉及 |
value |
String |
参数解释 资源维度值,为资源的实例ID,如:4270ff17-aba3-4138-89fa-820594c39755。 约束限制 不涉及 取值范围 长度为[1,256]个字符 默认取值 不涉及 |
参数 |
参数类型 |
描述 |
---|---|---|
comparison_operator |
String |
参数解释: 告警阈值的比较条件。 取值范围: 只能是>、=、<、>=、<=、!=。 |
count |
Integer |
参数解释: 触发告警的连续发生次数。 取值范围: 取值范围[1, 5]。告警类型为事件告警时,取值范围为[1, 100]。 |
filter |
String |
参数解释: 数据聚合的方式。 取值范围: 支持 average、variance、min、max、sum。
|
period |
Integer |
参数解释: 指标周期,单位是秒。如想了解各个云服务的指标原始周期可以参考“支持服务列表” 取值范围: 枚举值。
|
unit |
String |
参数解释: 数据的单位。 取值范围: 长度为[0,32]个字符。 |
value |
Number |
参数解释: 告警阈值。具体阈值取值请参见附录中各服务监控指标中取值范围,如支持监控的服务列表中ECS的CPU使用率cpu_util取值范围可配置80。 取值范围: 最小值为-1.7976931348623157e+108,最大值为1.7976931348623157e+108。 |
suppress_duration |
Integer |
参数解释: 告警抑制时间,单位为秒,对应页面上创建告警规则时告警策略最后一个字段,该字段主要为解决告警频繁的问题。 取值范围: 枚举值,只能为0、300、600、900、1800、3600、10800、21600、43200、86400。
|
参数 |
参数类型 |
描述 |
---|---|---|
type |
String |
参数解释: 告警通知类型。 取值范围: 取值如下: notification:SMN通知; autoscaling:AS通知。 |
notificationList |
Array of strings |
参数解释: 告警状态发生变化时,被通知对象的列表。 |
参数 |
参数类型 |
描述 |
---|---|---|
time |
Long |
参数解释 计算出该条告警历史的资源监控数据上报时间,UNIX时间戳,单位毫秒,如:1603131028000。 取值范围: 不涉及 |
value |
Double |
参数解释 计算出该条告警历史的资源监控数据在该时间点的监控数值,如:7.019。 取值范围: 具体阈值取值请参见附录中各服务监控指标中取值范围,如支持监控的服务列表中ECS的CPU使用率cpu_util取值范围可配置80。最小值为0,最大值为1.7976931348623157e+108。 |
参数 |
参数类型 |
描述 |
---|---|---|
resource_id |
String |
参数解释 该条告警历史对应的资源ID;如:22d98f6c-16d2-4c2d-b424-50e79d82838f。 取值范围: 字符串长度最大为128。 |
resource_name |
String |
参数解释 该条告警历史对应的资源名称;如:ECS-Test01。 取值范围: 字符串长度最大为128。 |
event_id |
String |
参数解释 该条告警历史对应的事件监控ID,资源所产生的事件;如:ev16031292300990kKN8p17J。 取值范围: 字符串长度为24。 |
状态码:400
参数 |
参数类型 |
描述 |
---|---|---|
- |
String |
请求错误。 |
状态码:401
参数 |
参数类型 |
描述 |
---|---|---|
- |
String |
未提供认证信息,或认证信息错误。 |
状态码:403
参数 |
参数类型 |
描述 |
---|---|---|
- |
String |
请求页面被禁止访问。 |
状态码:408
参数 |
参数类型 |
描述 |
---|---|---|
- |
String |
请求超出了服务器的等待时间。 |
状态码:429
参数 |
参数类型 |
描述 |
---|---|---|
- |
String |
前请求过多。 |
状态码:500
参数 |
参数类型 |
描述 |
---|---|---|
- |
String |
请求未完成,服务异常。 |
状态码:503
参数 |
参数类型 |
描述 |
---|---|---|
- |
String |
系统暂时不可用,请求受限。 |
请求示例
/V1.0/{project_id}/alarm-histories?limit=10&start=0&from=1602494921346&to=1603099721346&alarm_name=alarm-test01
响应示例
状态码:200
OK
{ "alarm_histories" : [ { "alarm_id" : "al1604473987569z6n6nkpm1", "alarm_name" : "TC_CES_FunctionBaseline_Alarm_008", "alarm_description" : "", "metric" : { "namespace" : "SYS.VPC", "dimensions" : [ { "name" : "bandwidth_id", "value" : "79a9cc0c-f626-4f15-bf99-a1f184107f88" } ], "metric_name" : "downstream_bandwidth" }, "condition" : { "period" : 1, "filter" : "average", "comparison_operator" : ">=", "value" : 0, "count" : 3 }, "alarm_level" : 2, "alarm_type" : "", "alarm_enabled" : false, "alarm_action_enabled" : false, "alarm_actions" : [ ], "ok_actions" : [ ], "insufficientdata_actions" : [ ], "update_time" : 1604473988000, "enterprise_project_id" : "0", "trigger_time" : 1604473987607, "alarm_status" : "alarm", "datapoints" : [ { "time" : 1604473860000, "value" : 0 }, { "time" : 1604473800000, "value" : 0 }, { "time" : 1604473740000, "value" : 0 } ], "additional_info" : { "resource_id" : "", "resource_name" : "", "event_id" : "" } }, { "alarm_id" : "al1604473978613MvlvlbVZD", "alarm_name" : "alarm_merge", "alarm_description" : "", "metric" : { "namespace" : "AGT.ECS", "dimensions" : [ { "name" : "instance_id", "value" : "22d98f6c-16d2-4c2d-b424-50e79d82838f" } ], "metric_name" : "load_average5", "resource_group_id" : "rg160447397837330303XQbK", "resource_group_name" : "group1" }, "condition" : { "period" : 1, "filter" : "average", "comparison_operator" : ">=", "value" : 0, "count" : 3, "unit" : "%", "suppress_duration" : 600 }, "alarm_level" : 2, "alarm_type" : "RESOURCE_GROUP", "alarm_enabled" : false, "alarm_action_enabled" : false, "alarm_actions" : [ ], "ok_actions" : [ ], "insufficientdata_actions" : [ ], "update_time" : 1604473979000, "enterprise_project_id" : "0", "trigger_time" : 1604473979070, "alarm_status" : "insufficient_data", "datapoints" : [ ], "additional_info" : { "resource_id" : "", "resource_name" : "", "event_id" : "" } } ], "meta_data" : { "total" : 2 } }
状态码
状态码 |
描述 |
---|---|
200 |
OK |
400 |
Bad Request |
401 |
Unauthorized |
403 |
Forbidden |
408 |
Request Timeout |
429 |
Too Many Requests |
500 |
Internal Server Error |
503 |
Service Unavailable |
错误码
请参见错误码。