Integrate Datadog Monitoring

개요

파일 전송 작업과 기기 상태 변화를 Datadog으로 전송하여 모니터링하려면 Datadog 연동을 설정할 수 있습니다.

연동을 완료하면 전송이 시작(Transfer Started), 완료(Transfer Completed) 되거나 기기가 연결(Device Connected), 해제(Device Disconnected) 되는 등 지정한 이벤트가 발생할 때마다 Datadog으로 이벤트가 전송되어 Datadog에서 모니터링할 수 있습니다.

전체 과정은 ① Datadog 자격 증명(키) 발급 → ② 제품에서 연동 설정 두 단계로 진행됩니다.

준비 사항

시작하기 전에 다음 사항을 확인하세요.

Datadog 자격 증명(키) 발급 및 Site 확인

Datadog으로 데이터를 전송하려면 API Key와 Application Key가 필요하며, 조직이 위치한 Site도 함께 확인합니다.

Step 1. API Key 발급

Datadog에서 좌측 하단의 아바타를 클릭하고 Organization Settings → API Keys로 이동합니다.

+ New Key를 클릭하고 이름을 입력한 뒤 키를 생성하고 표시된 API Key를 복사합니다.

Step 2. Application Key 발급

Organization Settings → Application Keys로 이동하여 + New Key를 클릭하고 이름을 입력한 뒤 Application Key를 복사합니다.

Application Key는 발급 사용자의 권한을 가지며, 필요 시 범위(Scope)를 지정하여 접근 권한을 최소화할 수 있습니다.

API Key와 Application Key는 비밀번호와 같으므로 공개 저장소나 외부 문서에 노출되지 않도록 주의합니다. 유출된 경우 해당 키를 삭제하고 새로 발급합니다.

Step 3. Datadog Site 확인

로그인 상태에서 브라우저 주소를 통해 사용 중인 Site를 확인합니다.

예를 들어 app.datadoghq.com은 US1, us3.datadoghq.com은 US3, us5.datadoghq.com은 US5, datadoghq.eu는 EU, ap1.datadoghq.com은 AP1입니다.

확인한 Site는 제품 설정의 Datadog Site 값과 동일해야 합니다.

확인 사항

✔ API Key를 발급했습니다.

✔ Application Key를 발급했습니다.

✔ 사용 중인 Datadog Site를 확인했습니다.

Datadog 연동 설정

발급받은 키와 Site를 제품의 설정에 입력합니다.

Monitoring 설정 창을 열면 아래와 같은 화면이 표시됩니다.

Step 1. API Key 입력

API Key 항목에 복사한 API Key를 입력합니다.

Step 2. Application Key 입력

Application Key 항목에 복사한 Application Key를 입력합니다.

Step 3. Datadog Site 선택

Datadog Site 드롭다운에서 사용 중인 Site를 선택합니다.

키를 발급한 Site와 동일해야 합니다.

Step 4. 이벤트 선택

Events 항목에서 모니터링할 이벤트를 선택합니다.

여러 개를 선택할 수 있으며, 선택한 이벤트가 발생할 때만 Datadog으로 이벤트가 전송됩니다.

Step 5. 설정 저장

입력을 마쳤으면 Add를 클릭하여 연동을 저장합니다.

확인 사항

✔ API Key와 Application Key가 입력되었습니다.

✔ Datadog Site가 선택되었습니다.

✔ 모니터링할 이벤트가 선택되었습니다.

연동 확인

설정이 정상적으로 동작하는지 확인합니다.

Step 1. 테스트 이벤트 발생

실제 전송 작업을 실행하거나 선택한 이벤트 중 하나를 발생시킵니다.

Step 2. Datadog 확인

Datadog의 Event Stream 또는 Dashboard에서 해당 이벤트가 수신되었는지 확인합니다.

확인 사항

✔ Datadog에 이벤트가 도착했습니다.

✔ 발생한 이벤트가 정상적으로 전달되었습니다.

설정 완료

설정을 저장하면 연동이 적용됩니다.

이후 선택한 이벤트가 발생할 때마다 Datadog으로 이벤트가 자동으로 전송됩니다.

문제 해결 (Troubleshooting)

이벤트가 Datadog에 표시되지 않는 경우 아래 항목을 확인하세요.