文档首页/ 云日志服务 LTS/ API参考/ API说明/ 关键词告警规则/ 查询关键词告警规则 - ListKeywordsAlarmRules
更新时间:2026-07-07 GMT+08:00
分享

查询关键词告警规则 - ListKeywordsAlarmRules

功能介绍

该接口用于查询关键词告警。

调用方法

请参见如何调用API

授权信息

账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。

  • 如果使用角色与策略授权,具体权限要求请参见权限和授权项
  • 如果使用身份策略授权,需具备如下身份策略权限。

    授权项

    访问级别

    资源类型(*为必须)

    条件键

    别名

    依赖的授权项

    lts:alarmRule:listWordAlarmRule

    List

    -

    -

    -

    -

URI

GET /v2/{project_id}/lts/alarms/keywords-alarm-rule

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

参数解释:

项目ID,可以从调用API处获取,也可以从控制台获取。获取方式请参见:获取项目ID

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

参数解释:

从IAM服务获取的用户Token,获取方式请参见:获取用户Token

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

Content-Type

String

参数解释:

用于定义消息体的格式,该字段填为:application/json;charset=utf8。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

响应参数

状态码:200

表3 响应Body参数

参数

参数类型

描述

keywords_alarm_rules

Array of KeywordsAlarmRuleRespList objects

参数解释:

关键词告警规则ID。

表4 KeywordsAlarmRuleRespList

参数

参数类型

描述

projectId

String

参数解释:

项目ID。

取值范围:

不涉及。

keywords_alarm_rule_id

String

参数解释:

关键词告警规则ID。

取值范围:

不涉及。

keywords_alarm_rule_name

String

参数解释:

关键词告警规则名称。

取值范围:

不涉及。

keywords_alarm_rule_description

String

参数解释:

关键词告警规则的简要描述。

取值范围:

不涉及。

condition_expression

String

参数解释:

告警条件表达式。

取值范围:

不涉及。

keywords_requests

Array of KeywordsRequestResponse objects

参数解释:

关键词告警规则信息。

frequency

FrequencyRespBody object

参数解释:

关键词告警统计周期信息。

约束限制:

不涉及。

keywords_alarm_level

String

参数解释:

关键词告警级别。

取值范围:

  • Info:提示

  • Minor:次要

  • Major:重要

  • Critical:紧急

domain_id

String

参数解释:

账号ID,获取方式请参见:获取账号ID

取值范围:

不涉及。

create_time

Long

参数解释:

创建时间(毫秒时间戳)。

取值范围:

不涉及。

update_time

Long

参数解释:

更新时间(毫秒时间戳)。

取值范围:

不涉及。

status

String

参数解释:

关键词告警状态。

取值范围:

  • RUNNING (开启)

  • STOPPING (关闭)

trigger_condition_count

Integer

参数解释:

告警触发条件:满足条件次数。

取值范围:

不涉及。

trigger_condition_frequency

Integer

参数解释:

告警触发条件:统计周期次数。

取值范围:

不涉及。

whether_recovery_policy

Boolean

参数解释:

是否配置告警恢复策略。

取值范围:

  • true:配置告警恢复策略。

  • false:不配置告警恢复策略。

recovery_policy

Integer

参数解释:

告警恢复策略周期次数。

取值范围:

  • 最小值为1

  • 最大值为10

notification_frequency

Integer

参数解释:

关键词告警通知频率,单位(分钟)。

取值范围:

0、5、10、15、30、60、180、360

alarm_action_rule_name

String

参数解释:

告警行动规则名称。

取值范围:

不涉及。

tags

Array of tagsResBody objects

参数解释:

告警标签信息。标签是以键值对(key-value)的形式表示,key和value为一一对应关系。

表5 KeywordsRequestResponse

参数

参数类型

描述

log_stream_id

String

参数解释:

日志流ID,获取方式请参见:获取日志组ID和日志流ID

取值范围:

不涉及。

log_stream_name

String

参数解释:

日志流名称。

取值范围:

不涉及。

log_group_id

String

参数解释:

日志组ID。

取值范围:

不涉及。

log_group_name

String

参数解释:

日志组名称。

取值范围:

不涉及。

keywords

String

参数解释:

在日志搜索能查到的日志关键字。

取值范围:

不涉及。

condition

String

参数解释:

告警查询条件。

取值范围:

<、- >、 <=、>=

number

Integer

参数解释:

告警匹配条数。

取值范围:

不涉及。

search_time_range

Integer

参数解释:

查询执行告警任务时最近数据的时间范围。

取值范围:

  • 最小值:1

  • 最大值:60

search_time_range_unit

String

参数解释:

查询告警时间范围单位。

取值范围:

  • minute

  • hour

custom_date

CustomDate object

参数解释:

根据与告警执行时间的相对时间自定义告警查询时间区间。

约束限制:

不涉及。

is_time_range_relative

Boolean

参数解释:

告警查询日志的时间区间为相对时间还是整点时间。

约束限制:

不涉及。

取值范围:

  • true: 相对时间。

  • false: 整点时间。

默认取值:

true

conditions

Array of KeywordsAlarmConditions objects

参数解释:

支持根据不同条件触发不同级别的告警。当使用该参数时,将优先使用该参数中的条件触发告警,无视keywords_alarm_level参数以及keywords_requests中的condition、number参数。

约束限制:

不涉及。

表6 CustomDate

参数

参数类型

描述

start

Integer

参数解释:

查询起始时间相对于告警计划执行时间的偏移量数值。

约束限制:

根据start_unit字段的单位将有不同的取值范围,根据单位将start换算为时间不超过1天。

取值范围:

start_unit取值为second,start取值范围为 1-86400;

start_unit取值为minute,start取值范围为 1-1440;

start_unit取值为hour,start取值范围为 1-24。

默认取值:

-无。

start_unit

String

参数解释:

查询起始时间相对于告警计划执行时间的偏移量单位。

约束限制:

整点时间即is_time_range_relative为false时start_unit不支持second。

取值范围:

  • hour

  • minute

  • second

默认取值:

minute

end

Integer

参数解释:

查询结束时间相对于告警计划执行时间的偏移量数值。

约束限制:

根据end_unit字段的单位将有不同的取值范围,根据单位将end换算为时间不超过1天;

取值范围:

end_unit取值为second,end取值范围为 0-86399;

end_unit取值为minute,end取值范围为 0-1439;

end_unit取值为hour,end取值范围为 0-23。

默认取值:

-无。

end_unit

String

参数解释:

查询结束时间相对于告警计划执行时间的偏移量单位。

约束限制:

整点时间即is_time_range_relative为false时end_unit不支持second。

取值范围:

  • hour

  • minute

  • second

默认取值:

minute

表7 KeywordsAlarmConditions

参数

参数类型

描述

condition

String

参数解释:

触发条件,即满足该条件时,会触发告警。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

number

Integer

参数解释:

匹配条数。当关键词搜索结果的日志条数达到设定的条数时,会触发告警。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

alarm_level

String

参数解释:

告警级别。

约束限制:

不涉及。

取值范围:

  • Info:提示

  • Minor:次要

  • Major:重要

  • Critical:紧急

默认取值:

不涉及。

表8 FrequencyRespBody

参数

参数类型

描述

type

String

参数解释:

告警统计周期类型。

取值范围:

  • CRON:cron表达式。

  • HOURLY:每小时。

  • DAILY:每天。

  • WEEKLY:每周。

  • FIXED_RATE:固定间隔。

cron_expr

String

参数解释:

CRON表达式。当type取值为CRON时,返回该字段。CRON最小精度为分钟,格式为24小时制。

取值范围:

不涉及。

hour_of_day

Integer

参数解释:

每天每小时。当type取值为DAILY或HOURLY时,返回该字段。

取值范围:

不涉及。

day_of_week

Integer

参数解释:

每周。当type取值为WEEKLY时,返回该字段。

取值范围:

不涉及。

fixed_rate

Integer

参数解释:

固定间隔。当type取值为FIXED_RATE时,返回该字段。

取值范围:

不涉及。

fixed_rate_unit

String

参数解释:

固定间隔时间单位。

取值范围:

  • minute

  • hour

表9 tagsResBody

参数

参数类型

描述

key

String

参数解释:

标签键。

取值范围:

不涉及。

value

String

参数解释:

标签值。

取值范围:

不涉及。

状态码:500

表10 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:

错误码,请参见:错误码

取值范围:

不涉及。

error_msg

String

参数解释:

调用失败响应信息描述。

取值范围:

不涉及。

请求示例

查询关键词告警规则。

GET https://{endpoint}/v2/{project_id}/lts/alarms/keywords-alarm-rule

/v2/{project_id}/lts/alarms/keywords-alarm-rule

响应示例

状态码:200

请求响应成功。

{
  "keywords_alarm_rules" : [ {
    "alarm_action_rule_name" : "***",
    "alarm_level" : "CRITICAL",
    "alarm_rule_alias" : "tuod**********word",
    "alarm_rule_description" : "",
    "alarm_rule_id" : "3bba********************************772",
    "alarm_rule_name" : "tuod**********word",
    "alarm_send" : true,
    "create_time" : 1779799438888,
    "domain_id" : "eb71********************************03f",
    "enterprise_project_id" : "0",
    "frequency" : {
      "cron_expr" : "",
      "day_of_week" : 1,
      "fixed_rate" : 1,
      "fixed_rate_unit" : "minute",
      "hour_of_day" : 0,
      "type" : "FIXED_RATE"
    },
    "is_css_sql" : false,
    "ltsAlarmInfos" : [ {
      "condition" : ">",
      "conditions" : [ {
        "alarm_level" : "CRITICAL",
        "condition" : ">",
        "number" : 5
      } ],
      "eps_id" : "0",
      "is_time_range_relative" : true,
      "keywords" : "ERROR",
      "log_group_id" : "38a0********************************d718",
      "log_group_name" : "lts-**********group",
      "log_group_name_alias" : "lts-**********group",
      "log_stream_id" : "96ec********************************75f",
      "log_stream_name" : "lts-***********jiqi",
      "log_stream_name_alias" : "lts-***********jiqi",
      "number" : 5,
      "search_time_range" : 5,
      "search_time_range_unit" : "minute"
    } ],
    "notification_frequency" : 0,
    "projectId" : "05b5********************************4747",
    "route_group_rule" : "",
    "status" : "RUNNING",
    "tags" : [ ],
    "topics" : [ ],
    "type" : "keyw**********words",
    "update_time" : 1779799719791,
    "whether_recovery_policy" : true
  } ]
}

状态码:500

表明服务端能被请求访问到,但是服务内部出错。

{
  "error_code" : "LTS.2008",
  "error_msg" : "Find Alarm rule failed."
}

状态码

状态码

描述

200

请求响应成功。

500

表明服务端能被请求访问到,但是服务内部出错。

错误码

请参见错误码

相关文档