Uptime Kuma로 내 서비스 상태 직접 모니터링하기

셀프호스팅 서비스를 5개, 10개 넘게 운영하다 보면, “지금 이 서비스가 정상적으로 살아있나?”를 매번 직접 접속해서 확인하는 게 번거로워져요. Nextcloud, Jellyfin, Vaultwarden처럼 여러 서비스를 동시에 운영할수록 이 문제는 더 커지는데, Uptime Kuma는 이런 다중 서비스 환경을 한눈에 모니터링할 수 있게 해주는 셀프호스팅 상태 모니터링 도구예요. 그럼 Uptime Kuma로 내 서비스 상태를 어떻게 직접 모니터링할 수 있을까요?

핵심 기능

Uptime Kuma는 다양한 방식의 상태 확인, 공유 가능한 상태 페이지, 풍부한 알림 채널을 기본으로 제공해요.

• 다양한 모니터링 방식: HTTP(S) 응답 확인, TCP 포트 확인, ping, DNS 조회, Docker 컨테이너 상태 확인 등 여러 방식으로 서비스 생존 여부를 체크할 수 있어요.
• 상태 페이지: 여러 서비스의 상태를 하나의 공개 또는 비공개 대시보드 페이지로 모아서 보여줄 수 있어요. 가족이나 팀원에게 “지금 뭐가 다운됐는지” 공유하기 좋아요.
• 알림 연동: 서비스 장애 발생 시 Telegram, Discord, Slack, 이메일 등 90개 이상의 알림 채널로 즉시 알림을 보낼 수 있어요.
• 응답 시간 그래프: 단순히 살아있는지 여부뿐 아니라, 응답 속도 추이를 시각화해 서서히 느려지는 문제도 조기에 발견할 수 있어요.

설치와 초기 구성

Uptime Kuma는 Docker 한 줄로 실행할 수 있을 만큼 설치가 간단해요.

services:
  uptime-kuma:
    image: louislam/uptime-kuma:1
    volumes:
      - uptime_kuma_data:/app/data
    ports:
      - "3001:3001"
volumes:
  uptime_kuma_data:

실행 후 웹 인터페이스에 접속해 관리자 계정을 만들고, 모니터링하고 싶은 서비스마다 “Add New Monitor”로 URL이나 포트를 등록하면 바로 상태 추적이 시작돼요.

알림 설정이 진짜 핵심

Uptime Kuma를 켜두기만 하고 대시보드를 매번 들여다보지 않는다면 반쪽짜리 활용이에요. 진짜 가치는 “문제가 생겼을 때 내가 확인하러 가지 않아도 먼저 알려준다”는 데 있어요. Telegram 봇이나 Discord 웹훅을 연동해두면, 서비스가 다운되는 즉시 스마트폰으로 알림을 받을 수 있어요. 재택 서버 운영자에게는 이 부분이 실제로 가장 유용하게 쓰이는 기능이에요.

모니터링 대상을 어디까지 확장할 수 있나

Uptime Kuma는 홈서버 안의 서비스뿐 아니라, 외부에서 사용 중인 도메인이나 API, 심지어 SSL 인증서 만료일까지 감시할 수 있어요. 인증서가 만료되기 며칠 전에 미리 알림을 받도록 설정해두면, “인증서 만료로 사이트가 갑자기 접속 안 됨” 같은 흔한 사고를 예방할 수 있어요.

모니터링 서버 자체의 이중화 문제

역설적이게도, Uptime Kuma가 돌아가는 서버 자체가 다운되면 “다운됐다”는 알림조차 받을 수 없어요. 이를 보완하기 위해 별도의 저전력 기기(라즈베리파이 등)에 Uptime Kuma를 독립적으로 띄우거나, 무료 외부 모니터링 서비스(UptimeRobot 등)를 함께 사용해 “모니터링 시스템을 모니터링”하는 이중 체계를 구성하는 경우도 많아요.

다른 모니터링 도구와의 관계

Grafana + Prometheus 조합은 훨씬 정교한 지표 수집과 시각화를 제공하지만, 그만큼 구성이 복잡해요. Uptime Kuma는 “일단 살아있는지 아닌지, 그리고 장애를 즉시 알아채는 것”이라는 단일 목적에 집중해서 진입 장벽이 훨씬 낮아요. 처음 홈서버 모니터링을 시작한다면 Uptime Kuma로 시작해 기본적인 가용성 감시 체계를 갖추고, 필요에 따라 나중에 Grafana 같은 정교한 도구를 추가하는 순서를 추천해요.

결론

여러 서비스를 셀프호스팅하기 시작하면 “지금 몇 개가 살아있고 몇 개가 죽어있는지” 파악하는 것 자체가 하나의 일이 돼요. Uptime Kuma는 이 기본적이지만 중요한 문제를 가장 쉽고 직관적으로 해결해주는 도구예요.