mc-observability Trigger/Event Handler API usage scenarios

[yunha-inno]

트리거 및 알람 설정 API Swagger & 사용 시나리오

트리거 및 알람 설정 API Swagger : mc-observability-swagger

위 링크 하단 "[Metric Event] monitoring metric trigger", "[Metric Event] monitoring trigger event handler"을 참고하시면 됩니다.

트리거 관련 기능은 아래와 같습니다.

1. 트리거 정책 설정
2. 트리거 대상 설정
3. 트리거 이벤트 핸들러 설정 (Email, Slack)
4. 트리거 히스토리 조회

---

트리거 기능 중 slack 알람을 받기 위해서는 사전에 사용자가 알람을 받을 workspace, channel, bot user OAuth token 생성 및 적용 과정이 필요합니다.
가이드 문서: slack user guide

---

트리거 시나리오

1. 장애 알람 정책 설정 (CreateRequestTriggerPolicy)
   a. 트리거 정책 설정 가능 대상 : cpu, mem, disk
   b. 트리거 정책 설정 시 threshold 형식
   ex 1) {"crit": "value > 20", "warn": "value > 50"}
   ex 2) {"info": "value > 90"}

2. 장애 알람 대상 설정 (PutTriggerTarget)
   a. 장애 알람 정책을 설정할 대상을 설정
   b. agent-manager를 통해 등록된 monitoring target의 nsId와 id를 사용하여 알람 대상 추가 (Get Monitoring Target)

3. 트리거 발생 시 알람 수신 사용자 설정
   a. 이벤트 핸들러 종류 : Email, Slack
   b. 이벤트 핸들러 설정

   • Email : [CreateTriggerAlertEmailUser]
   • Slack : [CreateTriggerAlertSlackUser]

4. 트리거 이벤트 히스토리 조회
   a. 설정된 장애 알람 정책에 따라 이벤트 발생 시 히스토리 증적 및 조회 [GetTriggerHistoryAllList]

트리거 정책, 대상, 알람 사용자에 대한 CRUD API가 제공되고 있으며 mc-observability-swagger 에서 확인할 수 있습니다.