매일 정해진 새벽 시간에 컴퓨터가 알아서 깨어나 공공데이터를 긁어모으고, 엑셀 마스터 파일에 누적한 뒤, 멋진 시각화 그래프까지 완성해 두는 시스템을 갖췄습니다. 이제 완벽한 무인 자동화 수익형 블로그가 완성되었다고 생각하며 한 일주일 동안 확인을 안 할지도 모릅니다. 하지만 오랜만에 폴더를 열어봤을 때, 며칠 전부터 데이터가 전혀 업데이트되지 않고 멈춰 있는 황당한 상황을 마주하곤 합니다.
확인해 보면 원인은 허탈합니다. 공공데이터 서버가 잠시 점검 중이었거나, 내 컴퓨터의 인터넷 연결이 새벽에 1초간 끊겼거나, API 제공 기관에서 보안 패치를 하며 응답 데이터의 형식을 미세하게 바꿨기 때문입니다. 수동으로 돌릴 때는 에러 메시지가 화면에 바로 뜨니 알 수 있었지만, 스케줄러를 통해 배경에서 돌아갈 때는 프로그램이 중간에 뻗어버려도 우리가 알아채기가 불가능합니다.
진정한 일류 자동화 엔진은 '에러가 나지 않는 프로그램'이 아니라, '에러가 났을 때 주인에게 스스로 비명을 질러 알려주는 프로그램'입니다. 오늘은 별도의 비용 없이 가장 빠르고 확실하게 내 스마트폰으로 실시간 에러 로그를 전송해 주는 '텔레그램 봇(Telegram Bot)' 연동 보안 모니터링 시스템을 구축해 보겠습니다.
카카오톡 대신 텔레그램 API 알림을 선택하는 현실적인 이유
많은 분이 자동화 알림을 구축할 때 가장 먼저 익숙한 카카오톡을 떠올립니다. 하지만 직접 구현해 보려고 개발자 센터를 방문하면 이내 고개를 저으며 포기하게 됩니다. 카카오톡 API는 보안과 비즈니스 악용 방지를 위해 링크 연동, 비즈니스 채널 인증, 주기적인 액세스 토큰 갱신(Refresh Token) 등 비전공자가 다루기에 너무나도 복잡한 인증 절차를 요구하기 때문입니다. 까딱하면 토큰이 만료되어 알림이 끊기기 일쑤입니다.
반면 텔레그램은 자동화 개발자들에게 축복과도 같은 환경을 제공합니다. 봇을 생성하는 과정이 메신저 대화 몇 번으로 끝날 만큼 극도로 간단하며, 한 번 발급받은 '봇 토큰(Bot Token)'은 내가 직접 폐기하기 전까지 만료되지 않고 평생 유지됩니다. 파이썬 코드 단 몇 줄만으로 내 스마트폰에 실시간 푸시 알림을 꽂아 넣을 수 있기 때문에, 1인 시스템 모니터링용으로는 텔레그램이 압도적으로 효율적입니다.
텔레그램 봇 생성 및 내 고유 ID(Chat ID) 조회하기
텔레그램 알림을 코드에 심기 전, 내 개인 비서 역할을 할 봇을 먼저 만들고 주소를 받아야 합니다.
수집 에러 발생 시 스마트폰으로 경고를 쏘아주는 실전 파이썬 코드
11편에서 배웠던 것처럼 중요 보안 자산인 텔레그램 토큰과 챗 ID는 .env 파일에 저장해 두고 불러와야 안전합니다. 아래 코드는 API 수집 중 예외 상황(Error)이 발생하면 프로그램이 조용히 꺼지는 대신, 예외 처리 구문(except)이 발동해 내 스마트폰으로 정확한 에러 원인 문장을 전송해 주는 모니터링 자동화 스크립트입니다.
import os
import requests
from dotenv import load_dotenv
# .env 환경변수 로드 (보안 설정)
load_dotenv()
TELEGRAM_TOKEN = os.environ.get("TELEGRAM_TOKEN")
TELEGRAM_CHAT_ID = os.environ.get("TELEGRAM_CHAT_ID")
def send_telegram_alert(message):
"""지정한 텍스트 메시지를 내 텔레그램 스마트폰 앱으로 전송하는 함수"""
url = f"https://api.telegram.org/bot{TELEGRAM_TOKEN}/sendMessage"
payload = {
"chat_id": TELEGRAM_CHAT_ID,
"text": message,
"parse_mode": "Markdown" # 메시지 내 볼드체 등 마크다운 문법 허용
}
try:
response = requests.post(url, json=payload, timeout=5)
response.raise_for_status()
except Exception as e:
print(f"텔레그램 알림 전송 실패: {e}")
# --- 실전 API 수집 및 모니터링 루프 ---
# 예시를 위해 존재하지 않는 잘못된 도메인을 호출하여 의도적으로 에러를 발생시킵니다.
api_url = "http://invalid-openapi-server-test.go.kr/data"
try:
print("[시스템] 공공데이터 실시간 수집을 시작합니다.")
# ⚠️ 여기서 연결 에러(ConnectionError) 또는 타임아웃 발생 가동
response = requests.get(api_url, timeout=5)
response.raise_for_status()
# 정상 작동 시 로그 (매번 알림을 보내면 귀찮으므로 정상 로그는 콘솔에만 출력)
print("[시스템] 데이터 수집 및 마스터 파일 누적 성공.")
except Exception as error_msg:
# 🚨 에러 발생 시 아래 블록이 실행되며 내 스마트폰으로 비명을 지릅니다.
print(f"[경고] 시스템 내부 에러 감지: {error_msg}")
alert_text = (
f"🚨 *[공공데이터 수집 엔진 에러 발생]*\n\n"
f"• *발생 시각:* 2026-07-09 22:46:26\n"
f"• *원인:* {error_msg}\n\n"
f"👉 스케줄러 배경 실행 중 프로세스가 중단되었습니다. 서버 상태 및 인터넷 연결을 점검하세요."
)
# 내 스마트폰 텔레그램 앱으로 알림 쏘기
send_telegram_alert(alert_text)
무인 자동화 시 주의점: 과도한 알림 늪(Alert Fatigue) 피하기
텔레그램 알림을 처음 연동하면 신기하고 재밌어서 프로그램이 정상적으로 성공했을 때도 "수집 완료!", "저장 완료!" 같은 알림을 매일 아침 전송하도록 코드를 짜는 분들이 많습니다.
하지만 이는 현업 개발 환경에서 가장 경계하는 '알림 피로(Alert Fatigue)' 증상을 유발합니다. 매일 아침 아무 문제 없다는 알림이 오면 인간의 뇌는 어느 순간부터 그 알림을 스팸 문자처럼 무시하게 됩니다. 그러다 정작 한 달 뒤 진짜 심각한 데이터 유실이나 코드 에러 경고가 발생했을 때도 무심코 알림을 넘겨버려 대형 데이터 소실 사태를 방치하게 됩니다.
가장 이상적인 알림 감시 비서는 '평소에는 완벽하게 침묵하다가, 정말 문제가 터진 긴급 상황에서만 딱 한 번 날카롭게 울리는 시스템'입니다. 정상 로그는 12편에서 구축한 배치 파일의 콘솔 창이나 별도의 log.txt 파일에 누적되도록 분리하고, 텔레그램 함수는 오직 except Exception 블록 내부에서 시스템이 멈추기 직전에만 발동되도록 설계하는 것이 오랜 기간 신경 쓰지 않고 무인 자동화를 유지하는 핵심 운영 철학입니다.
핵심 요약
윈도우 스케줄러를 통한 배경 자동화 환경에서는 수집 오류를 눈으로 볼 수 없으므로 실시간으로 에러를 통보해 주는 외부 메신저 연동이 필수적입니다.
카카오톡 API 대비 텔레그램 API는 복잡한 토큰 갱신 과정이 없고 인증 절차가 간결하여 1인 데이터 수집 모니터링 시스템 구축에 최적화되어 있습니다.
알림 피로를 방지하고 무인 시스템의 신뢰도를 유지하기 위해서는 정상 작동 로그는 파일로 격리하고 오직 예외 오류(
try-except) 상황에서만 텔레그램 알림이 작동하도록 코딩해야 합니다.
0 댓글