跳转到主要内容
ZStack
告警与响应相关接口/告警事件

试运行告警规则

模拟规则评估针对当前数据创建告警。

POST/api/v1/alerting/dry-run

操作 ID

DryRunAlertRule

起始版本

1.0.0

执行模式

同步

认证信息

需要认证

认证信息

调用该 API 时需要在请求头中携带以下认证信息。

Authorizationstring必填

Bearer 令牌

X-Tenant-IDstring

X-Tenant-ID

请求参数

application/json

请求体字段

  • expression
    String必填

    表达式。

    示例： avg(cpu_usage_percent) > 90

  • duration
    String必填

    持续时间。

    示例： 5m

  • labels
    LinkedHashMap必填

    标签列表。

    示例： (nested object)

  • evalTimestamp
    String必填

    评估时间戳。

    示例： 2026-01-15T08:00:00Z

  • simulateHours
    Integer必填

    模拟时长，单位为小时。

    示例： 24

响应状态

200 OK
200 OK

该 API 成功时返回以下响应结构。

  • valid
    Boolean

    是否有效。

    示例： true

  • parseError
    String

    消息表达式无效。

    示例： syntax error at line 5

  • errorPosition
    Integer

    字符位置解析错误。

    示例： 20

  • firing
    Boolean

    规则当前触发。

    示例： true

  • matchedSeries
    Integer

    已匹配序列。

    示例： 3

  • sampleValues
    List

    已匹配时间序列。

    示例： (nested array)

    • labels
      LinkedHashMap

      标签列表。

      示例： (nested object)

    • value
      Long

      字段值。

      示例： 95.3

    • timestamp
      String

      时间戳。

      示例： 2026-01-15T08:00:00Z

  • simulationSummary
    Object

    指定时间范围。

    • totalEvalPoints
      Integer

      评估点总数。

      示例： 288

    • firingCount
      Integer

      触发数量。

      示例： 12

    • firingPercentage
      Long

      触发百分比。

      示例： 4.2

    • firstFiringAt
      String

      首次触发时间。

      示例： 2026-01-15T08:00:00Z

    • lastFiringAt
      String

      最近一次触发时间。

      示例： 2026-01-15T08:00:00Z

  • evalDuration
    String

    时长评估。

    示例： 120ms