Uptime Kuma로 Django 사이트 50개 감시하기

Uptime Kuma 한 대로 Django 사이트 50개를 감시하려면? 사이트별 HTTP·키워드 모니터, 텔레그램 알림 통합, 그룹 구성으로 알림 폭주를 막으세요.

조회 62
Uptime Kuma로 Django 사이트 50개 감시하기

핵심 요약

  • 사이트마다 HTTP 또는 키워드 모니터를 만들고 알림은 텔레그램 하나로 모읍니다.
  • /healthz/ 엔드포인트와 키워드 모니터로 200 응답이어도 깨진 앱을 잡아냅니다.
  • 서버·역할 단위 그룹, 재시도, 유지보수 기능으로 알림 피로를 줄입니다.

Uptime Kuma 한 대로 Django 사이트 50개를 감시할 수 있습니다. 설정은 세 가지로 정리됩니다. 사이트마다 HTTP 또는 키워드 모니터를 하나씩 만들고, 알림은 텔레그램 하나로 모읍니다. 마지막으로 모니터를 그룹으로 묶어 장애 한 건이 알림 수십 개로 번지지 않게 합니다. 이 글은 그 순서대로 설명합니다.

왜 Uptime Kuma인가

Uptime Kuma GitHub에 따르면 이 도구는 셀프 호스팅 모니터링 도구입니다. HTTP(s), TCP, HTTP(s) 키워드, JSON 쿼리, Ping, DNS, Push, 도커 컨테이너 등을 감시할 수 있고, 최소 간격은 20초입니다. 인증서 정보 확인, 여러 개의 상태 페이지, 프록시도 지원합니다.

Django 사이트가 50개면 SaaS 모니터링은 모니터 수 기준으로 과금되는 경우가 많습니다. 가격은 공식 발표로 비교하지 않았으니 여기서 수치를 들지는 않겠습니다. 다만 셀프 호스팅이면 모니터 수 제한을 걱정하지 않고 서버 한 대에서 운영할 수 있습니다. 감시 대상과 감시 서버의 장애 영역을 분리하려면 앱 서버와 다른 네트워크나 다른 호스트에 두는 편이 안전합니다.

Docker로 설치하기

GitHub README는 Docker Compose 설치 방법을 이렇게 안내합니다.

mkdir uptime-kuma
cd uptime-kuma
curl -o compose.yaml https://raw.githubusercontent.com/louislam/uptime-kuma/master/compose.yaml
docker compose up -d

실행하면 3001번 포트로 접속할 수 있습니다(예: http://your-ip:3001). Uptime Kuma GitHub는 NFS 같은 파일 시스템을 지원하지 않는다고 경고합니다. 데이터는 로컬 디렉터리나 볼륨에 매핑하세요. 모니터 설정과 이력이 모두 이 데이터 디렉터리에 저장되므로 백업 대상에 반드시 넣어야 합니다.

운영 환경에서는 Nginx나 Caddy 같은 리버스 프록시 뒤에 두고 HTTPS를 적용하길 권합니다. 관리자 계정은 첫 접속 때 만듭니다.

HTTP 모니터와 키워드 모니터

Django 사이트는 서버가 응답해도 앱이 깨져 있는 경우가 흔합니다. DB 연결이 끊기면 500 페이지를 반환하고, 배포 실수로 기본 페이지나 점검 페이지가 뜰 수도 있습니다. 용도에 맞게 두 모니터를 나눠 쓰세요.

모니터 확인하는 것 적합한 대상
HTTP(s) 상태 코드 (2xx 등) 기본 생존 확인
HTTP(s) - Keyword 응답 본문에 특정 문자열이 있는지 렌더링과 DB 조회까지 확인

Django에서는 헬스체크용 URL을 하나 만들어 쓰면 편합니다. 아래는 DB를 가볍게 조회하고 고정 문자열을 반환하는 예시입니다.

# urls.py
from django.db import connection
from django.http import HttpResponse, HttpResponseServerError
from django.urls import path

def healthz(request):
    try:
        with connection.cursor() as cur:
            cur.execute("SELECT 1")
    except Exception:
        return HttpResponseServerError("db error")
    return HttpResponse("OK-HEALTHY")

urlpatterns = [path("healthz/", healthz)]

Uptime Kuma에서는 키워드 모니터를 만들고 URL에 https://사이트/healthz/, 키워드에 OK-HEALTHY를 넣습니다. 이러면 200이지만 내용이 틀린 경우도 장애로 잡힙니다. 50개 사이트가 같은 Django 템플릿이라면 같은 엔드포인트와 키워드를 쓰도록 통일하세요. 모니터를 복제해 URL만 바꾸면 되니 등록 작업이 훨씬 줄어듭니다.

텔레그램 알림 연결

텔레그램은 Uptime Kuma가 기본으로 지원하는 알림 채널입니다. Uptime Kuma GitHub는 Telegram, Discord, Slack, 이메일(SMTP) 등 90개 이상의 알림 서비스를 지원한다고 밝힙니다. 설정 순서는 다음과 같습니다.

  1. 텔레그램에서 @BotFather로 봇을 만들고 토큰을 받습니다.
  2. 봇을 알림용 그룹 채팅에 초대하고 채팅 ID를 확인합니다.
  3. Uptime Kuma의 설정에서 알림을 추가하고 Telegram을 선택한 뒤 토큰과 채팅 ID를 입력합니다.
  4. 테스트 버튼으로 수신을 확인합니다.

알림을 만들 때 "모든 모니터에 기본 적용" 옵션을 켜면 새 모니터에도 자동으로 붙습니다. 다만 채널을 하나로 몰면 50개 사이트의 알림이 한곳에 쏟아집니다. 이때 아래의 그룹 구성이 필요합니다.

알림 피로를 줄이는 그룹 구성

공유 DB나 서버 한 대에 사이트 여러 개가 얹혀 있으면, 서버 하나가 죽을 때 알림이 사이트 수만큼 옵니다. 다음 원칙으로 줄일 수 있습니다.

  • 서버·역할 단위로 그룹을 만듭니다. 예를 들어 web-01, web-02, 고객사A처럼 묶습니다. Uptime Kuma의 그룹 모니터는 하위 모니터를 한 덩어리로 보여 줍니다. 하위 중 하나라도 내려가면 그룹 상태에 반영되므로 목록이 정돈됩니다.
  • 재시도 횟수를 둡니다. 한 번 실패했다고 바로 알리지 않고, 재시도를 2~3회 지정해 일시적인 네트워크 흔들림을 걸러 냅니다.
  • 중요도별로 알림 채널을 나눕니다. 매출과 직결된 사이트는 별도 텔레그램 그룹으로 보내 즉시 확인하고, 나머지는 조용한 채널로 보냅니다.
  • 재알림 간격을 조절합니다. 장애가 이어질 때 같은 알림이 반복되지 않게 하세요.
  • 점검 시간을 등록합니다. 배포나 정기 점검 시간에는 유지보수 기능으로 알림을 끕니다.

핵심은 알림 하나가 사람이 해야 할 행동 하나에 대응하도록 만드는 것입니다. 서버 장애라면 서버 그룹에서 알림 한 건이 오는 편이 낫습니다. 사이트별 알림 수십 건은 필요하지 않습니다.

실천 가이드

처음부터 50개를 다 만들지 말고 단계적으로 진행하세요.

  1. Docker Compose로 설치하고 데이터 볼륨을 백업 대상에 넣습니다.
  2. Django 앱에 /healthz/ 같은 헬스체크 URL을 배포합니다.
  3. 대표 사이트 한 곳에서 키워드 모니터를 만들어 검증합니다.
  4. 텔레그램 봇을 연결하고 테스트 알림을 확인합니다.
  5. 모니터를 복제해 나머지 사이트를 등록하고, 서버·고객사 단위로 그룹을 구성합니다.
  6. 재시도와 재알림 간격을 조정하고, 일주일쯤 운영하며 불필요한 알림을 정리합니다.

마지막으로 Uptime Kuma 자체가 죽을 때를 대비해, 외부의 다른 서비스로 Uptime Kuma를 감시하는 이중화도 고려하세요. 세부 설정은 Uptime Kuma Wiki에서 확인할 수 있습니다.

자주 묻는 질문

Q. Uptime Kuma는 어떻게 설치하나요?

GitHub README의 Docker Compose 방법으로 compose.yaml을 내려받아 docker compose up -d를 실행합니다. 3001번 포트로 접속하며 관리자 계정은 첫 접속 때 만듭니다.

Q. HTTP 모니터와 키워드 모니터는 어떻게 다른가요?

HTTP(s) 모니터는 상태 코드로 기본 생존을 확인하고, 키워드 모니터는 응답 본문에 특정 문자열이 있는지 확인합니다. 키워드 모니터는 렌더링과 DB 조회까지 점검할 수 있어 200이지만 내용이 틀린 경우도 장애로 잡습니다.

Q. 사이트가 많을 때 알림이 쏟아지는 것을 어떻게 줄이나요?

서버나 역할 단위로 그룹을 만들고 재시도를 2~3회 지정해 일시적인 흔들림을 걸러 냅니다. 중요도별로 알림 채널을 나누고, 재알림 간격을 조절하며, 배포나 점검 시간에는 유지보수 기능으로 알림을 끕니다.

참고 자료

이 글은 웹 검색으로 확인한 위 출처를 바탕으로 AI(claude-sonnet-5-5)가 작성했습니다. 수치·가격은 출처 원문에서 다시 확인하세요.

#Django#Docker#Uptime Kuma#모니터링#셀프 호스팅#텔레그램 알림#헬스체크