Datadog 연동

Datadog은 SaaS 기반 대규모 애플리케이션 및 인프라를 위한 모니터링 및 분석 통합 플랫폼입니다.

서버, 컨테이너, 데이터베이스 및 애플리케이션의 실시간 지표를 추적할 수 있고, 이를 핵클 데이터와 통합하여 분석함으로써 기능 플래그의 점진적 출시에 따른 서비스 모니터링이 가능해집니다.

Datadog 연동

Datadog 연동을 위해서는 Datadog의 API Key 정보를 핵클 대시보드에 입력해야 합니다.

Datadog API Key 복사하기

Datadog에 접속하여 Organization Settings > API Keys 메뉴에서 API Key를 확인할 수 있습니다. Organization Settings 메뉴는 좌측 하단의 내 이메일 계정에 마우스를 호버하면 확인할 수 있습니다.

• API Keys 메뉴 URL: https://app.datadoghq.com/organization-settings/api-keys

Organization Settings > API Keys

핵클 대시보드에 Datadog API Key 입력

복사한 Datadog API Key를 핵클 대시보드에 입력합니다. 우측 상단에 위치한 설정 아이콘을 클릭하고, 외부 연동 메뉴에서 Datadog 연동을 설정할 수 있습니다.

아래 이미지의 Datadog 연동화면에서 API Key를 입력하고 '연동하기' 버튼을 클릭하면 연동 설정이 완료됩니다.

설정 (우측 상단 GNB에 위치) > 외부 연동

Datadog 으로 전송하는 항목

Datadog 연동이 완료되면 운영환경에서 발생한 기능플래그 노출 이벤트를 전송하게 됩니다. 이 외의 이벤트도 전송 가능하며, 설정이 필요한 경우 핵클 팀에 문의 부탁 드립니다.

구분	기본값	선택 가능한 항목
이벤트	기능플래그 이벤트	기능플래그, A/B 테스트, 원격구성, 사용자 행동 이벤트
설정변경	기능플래그 출시 비율(Rollout %), 기능플래그 상태(On/Off)	-
환경	운영환경	운영환경, 개발환경

Datadog에서 확인 가능한 항목

Datadog으로 전송된 핵클 기능 플래그 등의 이벤트를 활용하여 Dashboard를 생성할 수 있습니다. Datadog에서 수집되는 데이터를 기반으로 생성 가능한 모니터링 차트와 핵클 데이터를 기반으로 생성 가능한 기능 플래그 차트를 통합하여 Dashboard를 구성하여 서비스 모니터링을 수행할 수 있습니다.

위 스크린샷 내 위젯 명칭	설명
기능플래그 Rollout 설정 변경 횟수	기능플래그 상태 (On/Off), 출시 비율 (Rollout %) 혹은 타겟팅 조건 (Targeting Rule) 변경이 발생한 횟수를 의미합니다.
기능플래그 분배 이벤트 발생 횟수	기능플래그 분배 이벤트가 발생한 횟수를 의미합니다.
기능플래그 Rollout 설정 변경	핵클 대시보드에서 기능플래그 상태, 출시비율, 타겟팅 조건을 변경한 이력을 노출합니다.

Datadog에서 기능플래그 분배 이벤트 발생 현황 모니터링하기

Add Widgets > Graphs > Timeseries 를 선택합니다.

특정 시점에 기능플래그 호출이 어디에서, 얼마나 발생했는지 확인하여 얼마나 많은 고객이 영향도를 받았는지 확인할 수 있습니다.Metrics > hackle.feature_flag.count 를 선택하면 기능플래그 분배 이벤트 발생횟수를 확인할 수 있는 위젯을 생성할 수 있습니다. 또한, 아래의 변수를 활용하여 특정 조건의 기능플래그 분배 이벤트 발생을 모니터링 할 수 있습니다.

• key: 기능플래그 키 (예: 15번)

• variation: 분배결과 (true/false)

• decision_reason: 분배사유 기능 플래그 결정

• environment: 환경 (production/development)

기능플래그 분배 이벤트 발생횟수를 확인하기 위한 Datadog Widget 설정 예시

Datadog에서 기능플래그 Rollout 설정 변경 모니터링하기

Add Widgets > Graphs > Timeseries 혹은 List and Streams > List로 가능합니다.

특정 시점에 어떤 기능플래그의 Rollout 조건이 변경되었는지 확인할 수 있고, 이를 통해 Datadog에서 모니터링하고 있는 요소들과의 인과관계를 추정할 수 있습니다. Events > source:hackle 를 입력하면 핵클 대시보드에서 엔지니어가 기능플래그의 상태, 출시 비율, 타겟팅 조건을 변경할 때마다 Event 1건이 Datadog으로 전송됩니다. (예: 기능플래그 출시비율을 0% → 30%로 변경)

기능플래그 Rollout 설정 변경 횟수를 확인할 수 있는 Datadog Widget (Graph > Timeseries) 설정 예시

그리고 누가, 언제, 어떻게 특정 기능플래그의 Rollout 조건을 변경했는지 확인하기 위해 List 형태의 Widget을 생성하여 확인할 수 있습니다.

기능플래그 Rollout 설정 변경 히스토리를 확인할 수 있는 Datadog Widget (List and Streams > List) 설정 예시

Reporting format size 를 Large (full event) 로 선택하면 아래 이미지와 같이 Widget에서 기능플래그 Rollout 설정 변경에 대한 정보를 상세하게 확인할 수 있습니다.