Integrate PagerDuty Monitoring

개요

파일 전송 작업과 기기 상태 변화를 PagerDuty 이벤트로 생성하여 모니터링 및 대응하려면 PagerDuty 연동을 설정할 수 있습니다.

연동을 완료하면 전송이 시작(Transfer Started), 완료(Transfer Completed) 되거나 기기가 연결(Device Connected), 해제(Device Disconnected) 되는 등 지정한 이벤트가 발생할 때마다 PagerDuty에 이벤트(알림 또는 인시던트)가 자동으로 생성됩니다.

전체 과정은 ① Integration Key 발급 → ② 제품에서 연동 설정 두 단계로 진행됩니다.

준비 사항

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

PagerDuty Integration Key 발급

PagerDuty에 이벤트를 전송하려면 서비스에 Events API V2 Integration을 추가하고 Integration Key(Routing Key) 를 발급받습니다.

Step 1. Events API V2 Integration 추가

PagerDuty에서 Services → Service Directory로 이동한 후 대상 서비스를 선택하거나 새 서비스를 생성합니다.

서비스의 Integrations 탭에서 Add Integration을 클릭하고 Events API V2를 선택합니다.

Step 2. Integration Key 확인

Integrations 탭에서 생성한 Integration의 Integration Key(Routing Key) 를 복사합니다.

Integration Key는 비밀번호와 동일한 권한을 가지므로 공개 저장소나 외부 문서에 노출되지 않도록 주의합니다.

유출된 경우 Edit Integration → Generate a new Integration Key를 통해 새 키를 생성합니다.

확인 사항

✔ Events API V2 Integration을 추가했습니다.

✔ Integration Key를 복사했습니다.

PagerDuty 연동 설정

발급받은 Integration Key를 제품에 입력합니다.

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

Step 1. Integration Key 입력

Integration Key (Routing Key) 항목에 발급한 Integration Key를 입력합니다.

Step 2. 이벤트 선택

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

여러 개를 선택할 수 있으며 선택한 이벤트가 발생할 때만 PagerDuty에 이벤트가 생성됩니다.

Step 3. 설정 저장

입력을 완료한 후 Add를 클릭하여 연동을 저장합니다.

확인 사항

✔ Integration Key가 입력되었습니다.

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

연동 확인

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

Step 1. 테스트 이벤트 발생

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

Step 2. PagerDuty 확인

Integration Key를 발급한 PagerDuty 서비스에서 이벤트 또는 인시던트가 생성되었는지 확인합니다.

확인 사항

✔ PagerDuty에 이벤트가 생성되었습니다.

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

설정 완료

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

이후 선택한 이벤트가 발생할 때마다 PagerDuty에 이벤트가 자동으로 생성됩니다.

문제 해결 (Troubleshooting)