文档首页/ 应用运维管理 AOM/ API参考/ API/ 告警/ 查询告警规则模板列表(Beta)
更新时间:2024-12-10 GMT+08:00
分享

查询告警规则模板列表(Beta)

功能介绍

该接口用于查询告警规则模板列表。(该接口在邀测中,受限开放,如有需求可以通过提交工单提申请开放此接口。)

调用方法

请参见如何调用API

URI

GET /v4/{project_id}/alarm-rules-template

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

租户从IAM申请到的projectid,一般为32位字符串。

表2 Query参数

参数

是否必选

参数类型

描述

id

String

告警规则模板id。

type

String

告警规则模板类型。

  • 当type的值为“promql”时 返回CCE默认模板。

  • 当type为其他值或不填时,返回全量模板。

请求参数

表3 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

从IAM服务获取的用户Token。

Content-Type

String

指定类型为application/json。

Enterprise-Project-Id

String

企业项目id。

  • 查询单个企业项目下实例,填写企业项目id。

  • 查询所有企业项目下实例,填写“all_granted_eps”。

响应参数

状态码: 200

表4 响应Body参数

参数

参数类型

描述

alarm_rule_templates

Array of AlarmRuleTemplateBody objects

告警规则模板列表。

count

Integer

告警规则模板总数。

表5 AlarmRuleTemplateBody

参数

参数类型

描述

alarm_rule_template_name

String

告警规则模板名称。

alarm_rule_template_name_en

String

告警规则模板英文名称。

alarm_rule_template_description

String

告警规则模板描述。

alarm_rule_template_id

String

告警规则模板id。

alarm_rule_template_project_id

String

租户从IAM申请到的projectid,一般为32位字符串。

alarm_rule_template_type

String

告警规则模板类型

  • “statics”:静态告警模板

  • “dynamic”:动态告警模板

alarm_rule_template_source

String

告警规则模板来源。

alarm_rule_template_binding

Map<String,String>

告警规则模板所绑定的告警规则。

alarm_template_spec_list

Array of AlarmRuleTemplateSpecWithCloudService objects

告警模板规则列表。

enterprise_project_id

String

企业项目id。

create_time

Long

创建时间。

modify_time

Long

更新时间。

templating

Templating object

告警规则模板变量列表。

template_version

String

告警规则模板版本。

表6 AlarmRuleTemplateSpecWithCloudService

参数

参数类型

描述

related_cloud_service

String

关联的云服务。

related_cce_clusters

Array of strings

关联的CCE集群。

related_prometheus_instances

Array of strings

关联的Prom实例。

alarm_notification

AlarmNotification object

通知信息。

alarm_template_spec_items

Array of AlarmTemplateSpecItem objects

告警模板列表。

表7 AlarmNotification

参数

参数类型

描述

notification_type

String

通知类型。

  • “direct”:直接告警

  • “alarm_policy”:告警降噪

枚举值:

  • direct

  • alarm_policy

route_group_enable

Boolean

启用分组规则。

  • 当通知类型为“alarm_policy”时:true

  • 当通知类型为“direct”时:false

说明:

如果告警触发“notify_triggered”或告警恢复“notify_resolved”都设置为false(即都不进行告警通知),则route_group_enable需设置为false。

枚举值:

  • true

  • false

route_group_rule

String

分组规则名称。

  • 当route_group_enable 为true时,填分组规则名称

  • 当route_group_enable 为false时,填“”

notification_enable

Boolean

是否启用告警行动规则。

  • 当通知类型为“direct”时,填true

  • 当通知类型为“alarm_policy”时,填false

说明:

如果告警触发“notify_triggered”或告警恢复“notify_resolved”都设置为false(即都不进行告警通知),则notification_enable需设置为false。

bind_notification_rule_id

String

告警行动策略id。

  • 当notification_enable为true时,填告警行动策略id

  • 当notification_enable为false时,填“”

notify_resolved

Boolean

告警解决是否通知。

  • true:通知

  • false:不通知

枚举值:

  • true

  • false

notify_triggered

Boolean

告警触发是否通知。

  • true:通知

  • false:不通知

枚举值:

  • true

  • false

notify_frequency

Integer

通知频率

  • 当通知类型为“alarm_policy”时,填“-1”

  • 当通知类型为“direct”时,

    • “0”:只告警一次

    • “300”:每5分钟

    • “600”:每10分钟

    • “900”:每15分钟

    • “1800”:每30分钟

    • “3600”:每1小时

    • “10800”:每3小时

    • “21600”:每6小时

    • “43200”:每12小时

    • “86400”:每天

表8 AlarmTemplateSpecItem

参数

参数类型

描述

alarm_template_name

String

告警规则模板下单个告警规则名称。

alarm_template_name_en

String

告警规则模板下单个告警规则英文名称。

desc

String

告警规则模板下单个告警规则描述。

desc_en

String

告警规则模板下单个告警规则英文描述。

alarm_template_spec_type

String

告警规则模板下单个告警规则类型。

“metric”:指标告警

“event”:事件告警

metric_alarm_template_spec

MetricAlarmTemplateSpec object

指标告警模板。

event_alarm_template_spec

EventAlarmTemplateSpec object

事件告警模板。

表9 MetricAlarmTemplateSpec

参数

参数类型

描述

alarm_subtype

String

告警规则类别。

alarm_source

String

告警规则来源云服务:CCE 创建标识。

monitor_type

String

监控类型。

trigger_conditions

Array of TemplateTriggerCondition objects

触发条件。

no_data_conditions

Array of NoDataCondition objects

数据不足条件。

alarm_tags

Array of AlarmTags objects

告警标签。

recovery_conditions

RecoveryCondition object

告警恢复条件。

表10 TemplateTriggerCondition

参数

参数类型

描述

metric_query_mode

String

指标查询模式。

  • “AOM”:AOM原生

  • “PROM”:AOM Prometheus

  • “NATIVE_PROM”:原生Prometheus

枚举值:

  • AOM

  • PROM

  • NATIVE_PROM

metric_namespace

String

指标命名空间。

metric_name

String

指标名称。

metric_unit

String

指标单位。

metric_labels

Array of strings

指标维度。

promql

String

Prometheus语句。

promql_expr

Array of strings

Prometheus语句模板。

trigger_times

String

连续周期个数。

trigger_interval

String

检查频率周期。

  • 当trigger_type 为“HOURLY”时,填“”

  • 当trigger_type为“DAILY”时,格式为:“小时” 例如 每天凌晨三点"03:00"

  • 当trigger_type为“WEEKLY”时,格式为:“星期 小时”例如每周一凌晨三点 “1 03:00”

  • 当trigger_type为“CRON”时,格式为 标准CRON表达式

  • 当trigger_type为“FIXED_RATE”时,秒的取值为15s,30s,分钟为 1~59,小时为 1~24。例如:“15s”,“30s”,“1min”,“1h”

trigger_type

String

触发频率的类型:

  • “FIXED_RATE”:固定间隔

  • “HOURLY”:每小时

  • “DAILY”:每天

  • “WEEKLY”:每周

  • “CRON”:Cron表达式

枚举值:

  • FIXED_RATE

  • HOURLY

  • DAILY

  • WEEKLY

  • CRON

promql_for

String

Prometheus原生监控时长。

aggregation_type

String

统计方式:

  • average

  • minimum

  • maximum

  • sum

  • sampleCount

operator

String

判断条件:“>”,“<”,“=”,“>=”,“<=”

thresholds

Map<String,String>

键值对形式,键为告警级别,值为告警阈值

aggregation_window

String

统计周期。

  • “15s”

  • “30s”

  • “1m”

  • “5m”

  • “15m”

  • “1h”

cmdb

CmdbInfo object

cmdb信息。

query_match

String

查询筛选条件。

aom_monitor_level

String

监控层级。

aggregate_type

String

聚合方式。

  • “by”:不分组

  • “avg”

  • “max”

  • “min”

  • “sum”

枚举值:

  • by

  • avg

  • max

  • min

  • sum

metric_statistic_method

String

当配置方式为全量指标时可选择的指标运算方式。

  • “single”:单个指标进行运算

  • “mix”:多个指标进行混合运算

枚举值:

  • single

  • mix

expression

String

混合运算的表达式。

mix_promql

String

混合运算的promQL。

表11 CmdbInfo

参数

参数类型

描述

app_id

String

应用id。

node_ids

Array of NodeInfo objects

节点信息列表。

表12 NodeInfo

参数

参数类型

描述

node_type

String

节点类型。

node_id

String

节点id。

表13 NoDataCondition

参数

参数类型

描述

no_data_timeframe

Integer

无数据周期的个数。

no_data_alert_state

String

数据不足时,阈值规则的状态。

  • “no_data”:数据不足并发送通知

  • “alerting”:告警

  • “ok”:正常

  • “pre_state”:保持上一个状态

枚举值:

  • no_data

  • alerting

  • ok

  • pre_state

notify_no_data

Boolean

数据不足是否通知。

表14 AlarmTags

参数

参数类型

描述

auto_tags

Array of strings

自动标签。

custom_tags

Array of strings

自定义标签。

custom_annotations

Array of strings

告警标注。

表15 RecoveryCondition

参数

参数类型

描述

recovery_timeframe

Integer

告警恢复周期的个数。

表16 EventAlarmTemplateSpec

参数

参数类型

描述

alarm_subtype

String

告警规则类别。

alarm_source

String

告警规则来源云服务:CCE 创建标识。

event_source

String

告警来源。

monitor_object_templates

Array of strings

监控对象模板(创建告警时需要补齐里面的内容)。

monitor_objects

Array of Map<String,String> objects

监控对象列表。键值对形式,键值为:

  • “event_type”:通知类型

  • “event_severity”:告警级别

  • “event_name”:事件名称

  • “namespace”:命名空间

  • “clusterId”:集群id

  • “customField”:用户自定义字段

trigger_conditions

Array of EventTriggerCondition objects

触发条件。

表17 EventTriggerCondition

参数

参数类型

描述

event_name

String

事件名称。

trigger_type

String

触发方式:

  • “immediately”:立即触发

  • “accumulative”:累计触发

枚举值:

  • immediately

  • accumulative

aggregation_window

Long

统计周期。单位为秒,例如 1小时 填“3600”,当trigger_type为“immediately”时 不填。

operator

String

判断条件:“>”,“<”,“=”,“>=”,“<=”,当trigger_type为“immediately”时 不填。

thresholds

Map<String,Integer>

键值对形式,键为告警级别,值为累计次数,当trigger_type为“immediately”时 值为空。

frequency

String

事件类告警频率。当trigger_type为“immediately”时 不填。

  • “0”:只告警一次

  • “300”:每5分钟

  • “600”:每10分钟:

  • “900”:每15分钟:

  • “1800”:每30分钟:

  • “3600”:每1小时:

  • “10800”:每3小时:

  • “21600”:每6小时:

  • “43200”:每12小时:

  • “86400”:每天:

表18 Templating

参数

参数类型

描述

list

Array of TemplateInfo objects

变量列表

表19 TemplateInfo

参数

参数类型

描述

name

String

变量名称

type

String

变量类型

query

String

变量值

description

String

变量描述

请求示例

  • 查询告警规则列表

    https://{Endpoint}/v4/{project_id}/alarm-rules-template
  • 查询告警规则模板id为12142546931的告警规则模板

    https://{Endpoint}/v4/{project_id}/alarm-rules-template?id=1214****2546****931

响应示例

状态码: 200

OK 请求响应成功。

{
  "alarm_rule_templates" : [ {
    "alarm_rule_template_binding" : { },
    "alarm_rule_template_id" : "130****1802****3121",
    "alarm_rule_template_name" : "aomTemplate",
    "alarm_rule_template_project_id" : "2a47****cca5****8373****1bff****",
    "alarm_rule_template_type" : "statics",
    "alarm_template_spec_list" : [ {
      "alarm_template_spec_items" : [ ],
      "related_cce_clusters" : [ ],
      "related_cloud_service" : "VPC",
      "related_prometheus_instances" : [ ]
    } ],
    "create_time" : 1732266984780,
    "enterprise_project_id" : "0",
    "modify_time" : 1732266984780
  } ],
  "count" : 119
}

状态码

状态码

描述

200

OK 请求响应成功。

错误码

请参见错误码

相关文档