19. 내가 잠든 사이 서버가 뻗는다면? 파이썬(FastAPI) 에러 추적 및 디스코드 자동 알림 시스템 기획기

👤 관리자

조회 수 44

낡은 노트북 서버의 숙명, 그리고 무지(無知)의 공포

현재 제 서버는 16GB 램을 장착한 구형 노트북 위에서 <code>tmux</code>라는 백그라운드 세션 관리 도구를 통해 24시간 외롭게 돌아가고 있습니다. 파이썬 백엔드 코드가 아무리 완벽하더라도, 물리적인 노트북의 발열, 갑작스러운 인터넷 회선의 끊김, 혹은 제가 미처 잡아내지 못한 치명적인 버그(예를 들어 누군가 이상한 문자를 입력해 DB 연결이 끊어지는 현상)가 발생하면 사이트는 그 즉시 마비됩니다.

가장 큰 문제는 사이트가 멈추거나 에러가 발생했을 때, 제가 그것을 '즉각적으로' 알 방법이 없다는 것입니다. 현재로서는 제가 스마트폰으로 수시로 제 사이트에 접속해 보거나, 퇴근 후 노트북을 열어 우분투 서버에 SSH로 원격 접속한 뒤 까만 터미널 창의 로그(Log)를 수백 줄씩 위로 올려보며 "아, 낮에 에러가 났었구나..." 하고 뒤늦게 깨닫는 수밖에 없습니다. 만약 구글 검색 로봇이 제 사이트를 수집하러 방문했는데 하필 그때 서버가 죽어있다면? 그동안 공들여 쌓아 올린 SEO 점수와 애드센스 합격의 꿈은 산산조각이 날 것입니다.

수동 모니터링의 한계를 넘다: 에러 알림 자동화 기획

더 이상 불안감에 떨며 하루에 수십 번씩 새로고침을 누르는 '수동 모니터링'을 할 수는 없습니다. 그래서 저는 사이트에 치명적인 문제(500 Internal Server Error 등)가 발생하면, 파이썬 서버가 즉시 제 스마트폰으로 긴급 구조 신호를 보내는 '실시간 에러 추적 및 자동 알림 시스템'을 구축하기로 기획했습니다.

1단계: 파이썬 Logging 시스템의 세분화 현재는 서버 창에 모든 접속 기록과 에러가 뒤섞여서 출력되고 있습니다. 이를 개선하기 위해 파이썬의 기본 내장 모듈인 <code>logging</code>을 활용하여 로그의 등급을 나눌 계획입니다. 일반적인 방문 기록은 INFO 등급으로 파일에 조용히 저장하고, 페이지 접속 실패(404)나 서버 내부 에러(500) 같은 치명적인 문제는 ERROR나 CRITICAL 등급으로 분류하여 서버가 스스로 사태의 심각성을 인지하도록 코드를 개조할 것입니다.

2단계: 디스코드(Discord) Webhook 연동 에러를 감지했다면 이제 저에게 알려야겠죠. 문자 메시지나 카카오톡 알림을 구현하려면 복잡한 API 심사와 비용이 발생하지만, 전 세계 게이머와 개발자들이 사랑하는 메신저 '디스코드(Discord)'를 활용하면 이 모든 것이 무료입니다. 제 개인 디스코드 서버에 '비밀 관제소' 채널을 하나 만들고 Webhook(웹훅) URL을 발급받을 예정입니다. 그리고 FastAPI의 'Exception Handler(예외 처리기)' 기능에 코드를 추가하여, 서버에서 ERROR 등급의 문제가 터지면 그 즉시 파이썬이 디스코드 웹훅 주소로 에러의 원인, 발생 시간, 문제가 된 URL을 정리하여 스마트폰 푸시 알림으로 전송하게 만들 것입니다.

3단계: Slack이 아닌 Discord를 선택한 이유 보통 기업에서는 슬랙(Slack)을 많이 쓰지만, 1인 개발자에게는 디스코드가 압도적으로 유리합니다. 모바일 앱의 반응 속도가 훨씬 빠르고, 밤에 자고 있을 때 특정 채널의 알림만 요란하게 울리도록 설정(방해금지 모드 예외 처리)하는 것이 매우 직관적이기 때문입니다. 방구석 서버 관리자에게는 새벽에 서버가 죽었을 때 저를 깨워줄 확실한 알람 시계가 필요하니까요.

맺음말: 진정한 '시스템 관리자'로 거듭나는 길

에러가 발생하지 않는 완벽한 서버는 세상에 존재하지 않습니다. 구글이나 네이버 같은 대기업 서버도 종종 멈추곤 하니까요. 중요한 것은 에러를 아예 안 내는 것이 아니라, "에러가 났을 때 얼마나 빨리 알아채고 복구할 수 있는가"하는 운영의 묘미일 것입니다.

이제 터미널 창만 멍하니 바라보던 초보를 벗어나, 디스코드 알림을 통해 스마트하게 서버의 생명 징후를 체크하는 진정한 시스템 관리자(SysAdmin)로 레벨 업 할 차례입니다. 당장 내일부터 파이썬 서버 코드를 열어 <code>try-except</code> 구문과 디스코드 웹훅을 연결하는 삽질(?)을 시작해 보겠습니다. 제 스마트폰에 첫 번째 에러 알림이 성공적으로 울리는(물론 진짜 에러가 아니라 테스트용이길 바랍니다!) 그날의 구축기를 다음 포스팅에서 기대해 주세요.