创建告警规则

POST/v2/monitor/alerts/rules

新建指标告警规则并绑定通知渠道。

Bearer Token monitor:write api.demo.acme-cloud.dev

请求体

application/json

name 必填

string

规则名称

metric 必填

string

监控指标

可选值cpu_usage_pctmemory_usage_pctdisk_usage_pctreq_error_rate

expr 必填

string

触发表达式

for_duration 可选

string · 默认 5m

持续满足条件的时长后才触发，抑制抖动

severity 必填

string · 默认 warning

严重级别

可选值infowarningcritical

scope 可选

object

生效范围（标签选择器）

labels 可选

object

标签匹配，如 {"env":"prod"}

notify_channels 可选

array<string> · 默认 [ "webhook" ]

通知渠道

可选值webhookemailsms

响应

3 种状态

201 Created

响应示例

{
  "id": "rule_9f12a",
  "name": "磁盘使用率过高",
  "metric": "disk_usage_pct",
  "expr": "avg(60s) > 90",
  "severity": "warning",
  "enabled": true,
  "created_at": "2026-10-16T08:01:00Z"
}

代码示例

cURL

curl -i -X POST 'https://api.demo.acme-cloud.dev/v2/monitor/alerts/rules' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
  "name": "磁盘使用率过高",
  "metric": "disk_usage_pct",
  "expr": "avg(60s) > 90",
  "for_duration": "5m",
  "severity": "warning",
  "scope": {
    "labels": {
      "env": "prod"
    }
  },
  "notify_channels": [
    "webhook",
    "email"
  ]
}'