​
개요

Honeycomb은 이벤트를 Rootly로 알림으로 보내도록 구성할 수 있습니다. Rootly에서 수신된 알림은 Slack 채널로 라우팅되거나, 인시던트를 시작하는 데 사용되거나, Rootly 온콜 대상에 페이징하는 데 사용될 수 있습니다.

​
설치

​
인증 설정

Honeycomb을 설정하려면 먼저 관리자 사용자 로 Honeycomb에 로그인해야 합니다. 로그인한 후, Rootly와 통합하려는 환경에 있는지 확인하고 설정 아이콘 ⚙️을 선택하세요.
Document Image
그런 다음 API Keys 탭 > Configuration > Create Configuration API Key를 선택하세요.
Honeycomb에는 두 가지 유형의 API 키가 있습니다: Configuration과 Management API 키입니다.Rootly가 필요로 하는 것은 Configuration (일명 Environment-level) API 키입니다.
Document Image
Create API Key 모달에서 설명을 입력하고Name 아무 권한이나 체크하세요. 완료되면 API 키를 저장하세요.
API 키로 통합하는 것은 순전히 Rootly를 Honeycomb 환경의 클라이언트로 인증하기 위한 것입니다. 이를 통해 우리는 귀하의 조직에 고유한 webhook URL + secret 조합을 생성할 수 있습니다. Rootly는 Honeycomb에 직접 읽기나 쓰기 호출을 하지 않습니다. Rootly는 오직 Honeycomb에서 들어오는 알림만 수신합니다.Honeycomb 통합은 Rootly Alert Sources로 이동될 예정이므로 이 단계는 결국 불필요해질 것입니다.
Document Image
이제 Honeycomb에서 새로 생성된 API 키를 복사하여 Rootly의 Honeycomb 통합 모달에 붙여넣고 Connect를 선택하세요.
Honeycomb 통합 모달에 접근하려면 Rootly에서 Admin 사용자여야 하며 Integrations > Honeycomb > Setup
Document Image
으로 이동해야 합니다. 성공적인 통합은 Honeycomb 계정에서 웹훅을 구성하는 데 필요한 webhook URL + secret 조합을 제공할 것입니다.
Document Image

​
웹훅 생성

이제 조직 특정 webhook URL + secret 조합을 가지고 있으니, Honeycomb 계정으로 가서 웹훅을 생성해 봅시다. 로그인한 후, Team settings 페이지로 이동하세요.
Document Image
그런 다음 Integrations 탭을 선택하고 Add Integration을 클릭하세요.
Document Image
Add Integration 모달에서 Provider를 Webhook로 설정하고 설명을 입력하세요Name (예: Page Engineering On-Call, Page Infrastructure Team, Rootly Alerts 등).
Document Image
Webhook URL 필드에 입력하는 값은 이 특정 웹훅이 Rootly로 보내려는 알림 유형에 따라 달라집니다. 일반 알림(비 페이징 알림)의 경우 비 페이징 알림은 Rootly의 Alerts 페이지에 도착하지만 누구에게도 페이징하지 않습니다. Honeycomb은 Rootly의 Webhook URL과 secret이 다음 형식으로 Webhook URL 필드에 포함되어야 합니다:
Webhook URL
https://webhooks.rootly.com/webhooks/incoming/honeycomb_webhooks?secret=<enter_sercret_here>
webhook URL과 secret은 Rootly의 Honeycomb 통합 페이지에서 얻을 수 있습니다 (Integrations > Honeycomb > Configure).
Document Image
네, secret은 Webhook URL 경로의 일부로도 존재해야 하고 Shared Secret 필드에도 있어야 합니다. 두 곳의 secret이 정확히 동일한지 확인하세요.
Rootly 온콜에 페이징하기 위해 (페이징 알림) Rootly 온콜을 통한 페이징도 웹훅 알림에 의존합니다. 주요 차이점은 쿼리 파라미터에 알림 대상이 포함된다는 것입니다. 알림 대상은 다음으로 구성됩니다:
  • resource_type - 이는 페이징에 사용될 Rootly 리소스 유형을 정의합니다.
    • 사용 가능한 값은 다음과 같습니다: User | Group (Team) | EscalationPolicy | Service
  • resource_id - 이는 페이징 대상이 될 정확한 리소스를 지정합니다.
    • 리소스의 ID는 각 리소스를 편집할 때 확인할 수 있습니다.
입력하세요webhook URL, secret 그리고 notification target 을 다음 형식으로 Webhook URL Honeycomb의 필드에:
Webhook URL
https://webhooks.rootly.com/webhooks/incoming/honeycomb_webhooks/notify/<resource_type>/<resource_id>?secret=<enter_sercret_here>
Document Image
네, secret 은 Webhook URL 경로의 일부로도 존재해야 하고 Shared Secret 필드에도 있어야 합니다. 두 곳의 secret이 정확히 동일한지 확인하세요.

​
제거

이 통합을 제거할 수 있습니다. 통합 패널에서 Configure > Delete를 클릭하세요.
Document Image
Honeycomb에서도 웹훅을 삭제했는지 확인하세요. Rootly에서 통합을 삭제하는 것만으로는 Honeycomb가 Rootly로 알림 이벤트를 보내는 것을 중단하지 않습니다.

​
지원

이 통합에 대해 도움이나 추가 정보가 필요하면 support@rootly.com로 연락하거나 Help > Chat with Us로 이동하여 채팅을 시작하세요.