Integrate Sentry Monitoring

개요

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

연동을 완료하면 전송이 시작(Transfer Started), 완료(Transfer Completed) 되거나 기기가 연결(Device Connected), 해제(Device Disconnected) 되는 등 지정한 이벤트가 발생할 때마다 Sentry로 이벤트가 전송되며, 지정한 환경(Environment)으로 구분하여 확인할 수 있습니다.

전체 과정은 ① Sentry DSN 확인 → ② 제품에서 연동 설정 두 단계로 진행됩니다.

준비 사항

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

Sentry DSN 확인 및 환경 이름 결정

Sentry로 이벤트를 전송하려면 프로젝트의 DSN을 확인하고 이벤트를 구분할 Environment Name을 결정합니다.

Step 1. DSN 확인

Sentry에서 대상 프로젝트의 Settings → SDK Setup → Client Keys (DSN) 메뉴로 이동하여 DSN을 복사합니다.

DSN 형식은 다음과 같습니다.

DSN은 이벤트 전송만 허용하는 공개 키이지만, 외부에 노출될 경우 불필요한 이벤트가 전송될 수 있으므로 필요 시 Rotate 기능으로 새 DSN을 발급할 수 있습니다.

Step 2. 환경 이름 결정

이벤트를 구분할 Environment Name을 결정합니다.

예시:

환경은 별도로 생성할 필요가 없으며, 해당 이름으로 이벤트가 수집되면 Sentry에서 자동으로 표시됩니다.

확인 사항

✔ 프로젝트의 DSN을 확인했습니다.

✔ 사용할 Environment Name을 결정했습니다.

Sentry 연동 설정

확인한 DSN과 Environment Name을 제품에 입력합니다.

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

Step 1. Sentry DSN URL 입력

Sentry DSN URL 항목에 확인한 DSN을 입력합니다.

Step 2. Environment Name 입력

Environment Name 항목에 사용할 환경 이름을 입력합니다.

예:

Step 3. 이벤트 선택

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

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

Step 4. 설정 저장

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

확인 사항

✔ Sentry DSN URL이 입력되었습니다.

✔ Environment Name이 입력되었습니다.

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

연동 확인

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

Step 1. 테스트 이벤트 발생

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

Step 2. Sentry 확인

Sentry에서 이벤트가 정상적으로 수집되었으며 지정한 Environment로 구분되어 표시되는지 확인합니다.

확인 사항

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

✔ 지정한 Environment로 구분되어 표시됩니다.

설정 완료

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

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

문제 해결 (Troubleshooting)