개요#
파일 전송 작업과 기기 상태 변화를 Sentry로 전송하여 모니터링하려면 Sentry 연동을 설정할 수 있습니다.
연동을 완료하면 전송이 시작(Transfer Started), 완료(Transfer Completed) 되거나 기기가 연결(Device Connected), 해제(Device Disconnected) 되는 등 지정한 이벤트가 발생할 때마다 Sentry로 이벤트가 전송되며, 지정한 환경(Environment)으로 구분하여 확인할 수 있습니다.
전체 과정은 ① Sentry DSN 확인 → ② 제품에서 연동 설정 두 단계로 진행됩니다.
준비 사항#
시작하기 전에 다음 사항을 확인하세요.
| 항목 | 설명 |
|---|---|
| Sentry 프로젝트 | 이벤트를 수집할 Sentry 프로젝트와 DSN을 확인할 수 있는 권한이 필요합니다. |
| 환경 이름 | 이벤트를 구분할 환경 이름(예: production)을 미리 결정합니다. |
| 네트워크 | 제품이 설치된 환경에서 DSN의 Ingest 엔드포인트(예: oXXX.ingest.sentry.io, 443)로의 외부 HTTPS 통신이 허용되어야 합니다. |
Sentry DSN 확인 및 환경 이름 결정#
Sentry로 이벤트를 전송하려면 프로젝트의 DSN을 확인하고 이벤트를 구분할 Environment Name을 결정합니다.
Step 1. DSN 확인#
Sentry에서 대상 프로젝트의 Settings → SDK Setup → Client Keys (DSN) 메뉴로 이동하여 DSN을 복사합니다.
DSN 형식은 다음과 같습니다.
https://<public_key>@o<조직 ID>.ingest.sentry.io/<프로젝트 ID>ℹ️ DSN은 이벤트 전송만 허용하는 공개 키이지만, 외부에 노출될 경우 불필요한 이벤트가 전송될 수 있으므로 필요 시 Rotate 기능으로 새 DSN을 발급할 수 있습니다.
Step 2. 환경 이름 결정#
이벤트를 구분할 Environment Name을 결정합니다.
예시:
productionstaging환경은 별도로 생성할 필요가 없으며, 해당 이름으로 이벤트가 수집되면 Sentry에서 자동으로 표시됩니다.
확인 사항#
- ✔ 프로젝트의 DSN을 확인했습니다.
- ✔ 사용할 Environment Name을 결정했습니다.
Sentry 연동 설정#
확인한 DSN과 Environment Name을 제품에 입력합니다.
Monitoring 설정 창을 열면 아래와 같은 화면이 표시됩니다.
Step 1. Sentry DSN URL 입력#
Sentry DSN URL 항목에 확인한 DSN을 입력합니다.
Step 2. Environment Name 입력#
Environment Name 항목에 사용할 환경 이름을 입력합니다.
예:
productionStep 3. 이벤트 선택#
Events 항목에서 모니터링할 이벤트를 선택합니다.
여러 개를 선택할 수 있으며 선택한 이벤트가 발생할 때만 Sentry로 전송됩니다.
| 이벤트 | 발생 시점 |
|---|---|
| Transfer Started | 전송 작업이 시작되었을 때 |
| Transfer Completed | 전송 작업이 정상적으로 완료되었을 때 |
| Transfer Paused | 전송 작업이 일시 중지되었을 때 |
| Transfer Recovered | 중단 또는 오류 후 전송이 자동 복구되어 재개되었을 때 |
| Device Connected | 기기가 연결되었을 때 |
| Device Disconnected | 기기 연결이 해제되었을 때 |
Step 4. 설정 저장#
입력을 완료한 후 Add를 클릭하여 연동을 저장합니다.
확인 사항#
- ✔ Sentry DSN URL이 입력되었습니다.
- ✔ Environment Name이 입력되었습니다.
- ✔ 모니터링할 이벤트가 선택되었습니다.
연동 확인#
설정이 정상적으로 동작하는지 확인합니다.
Step 1. 테스트 이벤트 발생#
실제 전송 작업을 실행하거나 선택한 이벤트를 발생시킵니다.
Step 2. Sentry 확인#
Sentry에서 이벤트가 정상적으로 수집되었으며 지정한 Environment로 구분되어 표시되는지 확인합니다.
확인 사항#
- ✔ Sentry에 이벤트가 도착했습니다.
- ✔ 지정한 Environment로 구분되어 표시됩니다.
설정 완료#
설정을 저장하면 연동이 적용됩니다.
이후 선택한 이벤트가 발생할 때마다 Sentry로 이벤트가 자동으로 전송됩니다.
문제 해결 (Troubleshooting)#
| 문제 | 확인 사항 |
|---|---|
| 이벤트가 표시되지 않음 | Sentry DSN URL이 정확한지, 앞뒤 공백이나 누락이 없는지 확인 |
| 프로젝트를 찾을 수 없음 | DSN이 대상 프로젝트의 것인지, Rotate 또는 비활성화되지 않았는지 확인 |
| Environment로 구분되지 않음 | Environment Name이 올바르게 입력되었는지 확인 |
| 일부 이벤트가 누락됨 | Client Keys의 Rate Limit에 도달하지 않았는지 확인 |
| 폐쇄망에서 연동 실패 | DSN의 Ingest 엔드포인트(예: oXXX.ingest.sentry.io, 443) 아웃바운드 통신이 방화벽 또는 프록시에서 허용되는지 확인 |