파이썬 sentry(오류 모니터링 툴) 연결 방법 정리

안녕하세요.

이번 시간에는 Python에서 예외 모니터링 툴로 널리 사용되는 sentry를

연결하는 방법을 간략하게 정리해보도록 하겠습니다.

 

 

센트리 프로젝트 생성

1. sentry.io 사이트에 접속합니다.

 

2. 로그인(또는 회원 가입) 후, 프로젝트를 생성합니다.

 

여기서 프로젝트에서 사용하는 언어를 고를 때,

python 뿐만 아니라 fastapi, flask 등 프레임워크 단위로도 존재하니 참고하세요.

 

3. 만든 프로젝트에 대해서 설정(톱니바퀴 모양 버튼 클릭)에 들어가줍니다.

 

4. 여기서 좌측의 Client Keys (DSN) 메뉴 탭을 보시면 상단에 DSN이 있으므로,

이 값을 잘 복사하여 가져옵니다.

 

여기까지 진행되었다면 파이썬 프로그램을 sentry 프로젝트에 연결하기 위한

웹 사이트에서의 기본적인 준비는 모두 완료된 것입니다.

 

 

sentry-sdk 모듈 설치

파이썬에서 센트리를 연결하기 위해서는 sentry-sdk 패키지를 설치해야 합니다.

이 과정은 다음 명령어로 간단하게 진행이 가능합니다.

pip install sentry-sdk

 

 

센트리 프로젝트 연결

이제 코드에서 sentry를 연결할 준비만 진행해주시면 됩니다.

이 과정은 코드가 실행되는 최상단에 아래의 코드만 추가해주시면 완료됩니다.

import sentry_sdk

sentry_sdk.init(
    dsn="위에서 복사한 DSN 주소",
    traces_sample_rate=1.0  # 추적 rate 설정(1.0이면 모든 트랜잭션 추적)
)

 

이후, 간단한 오류를 일부러 발생시킨 뒤에, 위에서 만든 웹 사이트 내 프로젝트 페이지에서

에러 로그가 잘 기록된 것을 확인했다면 세팅이 모두 성공적으로 완료된 것입니다.

 

이 글이 sentry 세팅 과정에 도움이 되셨기를 기원하겠습니다.

잘 봐주셔서 감사합니다.