elastic/kibana-alerting-rules

kibana-alerting-rules은(는) 무엇을 하나요?

Kibana 알림 규칙을 REST API 또는 Terraform을 통해 생성하고 관리합니다. 규칙 생성, 업데이트, 수명 주기 관리(활성화, 비활성화, 음소거, 지연) 또는 코드형 규칙 워크플로에 사용하세요.

REST API 사용

Kibana REST API를 사용하여 규칙을 생성하고 관리하려면 다음 엔드포인트를 사용하세요:

• 규칙 생성: POST /api/alerting/rule
• 규칙 업데이트: PUT /api/alerting/rule/{ruleId}
• 규칙 활성화: POST /api/alerting/rule/{ruleId}/_enable
• 규칙 비활성화: POST /api/alerting/rule/{ruleId}/_disable
• 규칙 음소거: POST /api/alerting/rule/{ruleId}/_mute
• 규칙 snooze: POST /api/alerting/rule/{ruleId}/_snooze?duration={minutes}

인증

요청에는 Authorization 헤더에 ApiKey 또는 Bearer 토큰을 포함해야 합니다. 자세한 내용은 Kibana API 문서를 참조하세요.

Terraform 사용

Terraform을 사용하여 규칙을 관리하려면 elastic/kibana 공급자를 사용하세요:

resource "elastic_kibana_alerting_rule" "example" {
  name        = "Example Rule"
  rule_type_id = "metrics.alert.threshold"
  consumer     = "alerts"
  schedule     = {
    interval = "1m"
  }
  params = {
    criteria = []
  }
  actions = []
  enabled = true
}

Terraform 공급자 설치 지침은 Elastic Terraform 문서를 참조하세요.

예제

REST API로 규칙 생성

curl -X POST "https://localhost:5601/api/alerting/rule" \
  -H "Content-Type: application/json" \
  -H "Authorization: ApiKey YOUR_API_KEY" \
  -d '{
    "name": "High CPU Alert",
    "rule_type_id": "metrics.alert.threshold",
    "consumer": "alerts",
    "schedule": {"interval": "1m"},
    "params": {
      "criteria": [
        {
          "metric": "cpu_usage",
          "threshold": 0.9,
          "comparator": ">"
        }
      ]
    },
    "actions": []
  }'

Terraform으로 규칙 비활성화

Terraform 리소스에서 enabled = false를 설정한 후 terraform apply를 실행하세요.

참고

• 자세한 내용은 Kibana 알림 규칙 가이드를 참조하세요.
• 기여는 GitHub 리포지토리에서 환영합니다.