Webhook Management

[Plugin & Integration Hub > Webhooks] 페이지에서 CloudOps 이벤트 (cloud account, resource, cost) 를 구독해 서비스로 실시간 전달하는 webhook endpoint 를 등록할 수 있습니다.

Webhook 목록

webhook 테이블은 테넌트에 등록된 모든 endpoint 를 나열합니다.

컬럼설명
Namewebhook 의 표시명. 클릭하면 상세 페이지로 이동
Source Plugin이 webhook 이 구독하는 이벤트를 소유한 플러그인
State라이프사이클 상태 — Active, Disabled, Error, Setting up
Requests (24h)최근 24시간 동안 수신한 요청 수
Created생성 시각

검색 및 필터

UI 요소설명
SearchSearch by Webhook Name...
Source 필터All Sources / 등록된 각 source plugin
State 필터All States / Active / Disabled / Error / Setting up
More menu (⋮)Set Display (컬럼 표시), Refresh

행 액션 메뉴

각 행의 우측 끝에 액션 메뉴 (⋯) 가 있으며 두 항목을 포함합니다.

액션설명
Edit편집 폼을 엽니다 (상세 페이지에서도 가능)
Delete이 webhook 을 삭제합니다 — 아래 “Webhook 삭제” 참조

대량 작업

한 개 이상의 행을 선택하면 플로팅 하단 바 가 나타나며 {count} webhook(s) selected · Ready for bulk actions 가 표시됩니다. 유일한 대량 액션은 Delete 입니다. 선택된 각 webhook 은 개별 API 호출로 삭제되며, 부분 실패는 토스트({succeeded} deleted, {failed} failed.) 로 요약됩니다.

Webhook 생성

생성 플로우는 4단계 위자드입니다: Source Plugin → Basic Info → Schema Mapping → Complete.

Step 1 — Source Plugin 선택

페이지 우상단의 [+ Create Webhook] 버튼을 클릭합니다. Create Webhook 위자드 페이지로 이동합니다.

이 webhook에 이벤트를 전달할 Source Plugin을 선택합니다:

Source Plugin설명
AWS SNS (CloudWatch Alarm)AWS SNS notification으로 wrap된 CloudWatch alarm을 정규화
AWS Health (PHD)AWS Personal Health Dashboard 이벤트를 정규화
Grafana AlertingGrafana unified alerting webhook 이벤트를 정규화
Prometheus AlertmanagerPrometheus Alertmanager webhook 이벤트를 정규화

플러그인을 선택하고 [Next] 를 클릭합니다.

Step 2 — Basic Info

필드필수설명
NameYesWebhook 표시명. 영문자, 숫자, 하이픈, 언더스코어 (3~64자)
DescriptionNo선택적 설명 (최대 256자)

[Next] 를 클릭하여 진행하거나, [Previous] 로 이전 단계로 돌아갑니다.

Step 3 — Schema Mapping

수신 이벤트 필드를 CloudOps 이벤트 스키마에 매핑하는 방법을 구성합니다. 매핑 규칙은 선택한 Source Plugin에 따라 달라집니다.

Step 4 — Complete

구성을 검토하고 [Create] 를 클릭하여 저장합니다. Webhook이 Enabled 상태로 목록에 나타납니다.

Webhook 상세 페이지

행의 Name 을 클릭하면 상세 페이지가 열립니다. 헤더 액션:

액션설명
Back관리 목록으로 돌아가기
Edit이름과 endpoint 메타데이터 편집
Send Test Event합성 이벤트를 전송하여 endpoint 연결 확인
Delete삭제 확인 다이얼로그 열기

상세 페이지 본문에는 다음이 표시됩니다:

  • Endpoint URL, headers, secret 상태
  • 구독 필터와 이벤트 타입
  • 최근 전송 시도 (상태 코드와 타이밍 포함)

Webhook 삭제

삭제 다이얼로그 열기

행의 액션 메뉴, 상세 페이지 헤더, 또는 대량 바에서 Delete 를 클릭합니다.

확인

다이얼로그 제목은 “Delete this webhook?” (대량 삭제 시 "Delete {count} webhooks?") 입니다. 본문은 수신 이벤트가 더 이상 처리되지 않으며 되돌릴 수 없음을 안내합니다.

[Delete] 클릭

성공 토스트가 결과를 안내합니다 (Webhook deleted. 또는 Deleted {count} webhooks.). 대량 실행에서 부분 실패는 {succeeded} deleted, {failed} failed. 로 요약됩니다.

ℹ️
webhook 이 하나도 등록되지 않았을 때 표 영역에 빈 상태가 표시됩니다 — “No webhooks configured yet”“Register a webhook endpoint to receive cloud account, resource, and cost events.”. 페이지 헤더의 [+ Create Webhook] 버튼은 항상 사용 가능합니다.
v1.1.0