Uptime Kuma의 개요
Uptime Kuma는 서비스가 살아 있는지 확인하고, 멈추면 알림을 보냅니다. HTTP(s), TCP, 키워드, JSON 쿼리, WebSocket, ping, DNS, 푸시, Docker 컨테이너 모니터를 지원하고, 최소 20초 간격으로 확인하며, Telegram, Discord, Slack, 이메일, 그리고 README 기준 90개가 넘는 알림 서비스로 경보를 보냅니다. 자체 도메인에 연결할 수 있는 상태 페이지도 게시합니다.
자체 AI 기능은 없습니다. 여기서 다루는 이유는 자체 호스팅 AI 스택 대부분이 쓰는 감시 도구이기 때문입니다. Open WebUI의 모니터링 가이드는 이 도구를 중심으로 쓰였으며, /health 확인, Ollama 모델에 접근할 수 있는지 확인하는 JSON 쿼리, 실제 채팅 요청을 보내는 더 깊은 확인을 소개합니다.
프로젝트는 MIT 라이선스이고 JavaScript로 작성되었으며, 포트 3001의 Docker 컨테이너 하나로 동작합니다. 공식 호스팅 버전이나 유료 요금제는 없습니다. README는 Google 최상위 결과인 uptimekuma.co가 프로젝트 사이트가 아니라고 경고합니다.
Uptime Kuma, 쓸 만한 가치가 있습니까?
Uptime Kuma는 한 가지 질문, 즉 아직 살아 있는가에 잘 답합니다. GitHub 스타는 94,486개이고 2026년 11월 12일에 버전 2.5.11이 나왔으며, 자기 서비스를 직접 호스팅하는 사람들의 기본 선택입니다. 이제 그 대상에는 로컬 모델 서버와 채팅 화면도 포함됩니다. Open WebUI의 모니터링 문서는 세 단계 확인에 이 도구를 씁니다. 60초마다 /health에 보내는 ping, Ollama 모델만 따로 셀 수 있는 300초마다의 /api/models JSON 쿼리, 그리고 실제 채팅 요청을 보내 응답을 검증하는 확인입니다.
AI 작업에 유용한 것은 마지막 확인입니다. 모델 서버는 모델 자체가 로드되지 않아도 상태 확인 경로에서 200을 반환할 수 있는데, 프롬프트를 보내는 JSON 쿼리나 키워드 모니터는 이를 잡아냅니다. 대신 모니터가 설정에 API 키를 보관하게 되고, Slack, Telegram 등의 알림 토큰과 함께 놓이므로 Uptime Kuma 인스턴스 자체가 보호해야 할 대상이 됩니다.
이 점이 중요한 이유는 보안 이력이 분주하기 때문입니다. GitHub에는 2026년 10월 9일 공개된 인증 없는 서비스 거부 관련 심각도 높음 권고와, 2026년 11월 2일 공개된 Apprise 인수 주입을 통한 인증된 원격 코드 실행이 올라 있으며, 2.5.11은 외부 패키지 때문에 생긴 관리자 전용 원격 코드 실행을 고쳤습니다. 알림 템플릿에는 2025년과 2026년 3월에 다시 파일을 읽을 수 있게 하는 서버 측 템플릿 주입 버그가 있었습니다. 기본 Docker 명령은 모든 인터페이스에서 수신 대기하며, README는 대신 127.0.0.1에만 바인딩하는 방법을 보여 줍니다.
Uptime Kuma는 LLM 관측성 도구가 아닙니다. 토큰, 모델별 지연 시간, 비용, 답변 품질을 보지 못하며, 그 일은 Langfuse나 PostHog의 AI 관측성이 맡습니다. 2025년 10월 20일에 나온 버전 2.0.0에는 호환되지 않는 변경과 마이그레이션 가이드가 있었으므로, 메이저 버전을 넘는 업그레이드에는 먼저 백업이 필요합니다. NFS 같은 네트워크 파일 시스템은 데이터 디렉터리로 지원되지 않습니다.
제 역할을 하는 곳
GPU 장비 한 대에서 Ollama와 Open WebUI를 돌리는 홈랩 운영자
채팅 화면이나 모델이 죽으면 가족보다 먼저 알고 싶다
Open WebUI의 /health 경로에 HTTP 모니터를, Ollama 모델 수를 세는 /api/models에 JSON 쿼리 모니터를 추가하고 둘 다 Telegram으로 알림을 보냅니다. 컨테이너 외에 비용이 들지 않으며, 확인 방식은 Open WebUI 가이드를 따릅니다.
VPS에서 고객 챗봇을 호스팅하는 2인 에이전시
고객에게 상태 페이지를 주고, 봇이 응답을 멈추면 알림을 받고 싶다
고객마다 그 고객의 도메인에 상태 페이지를 두고, 테스트 프롬프트를 보내 응답에 예상 키워드가 있는지 확인하는 모니터를 둡니다. 알림은 Slack으로 가며, 모니터별이나 사용자별 요금은 없습니다.
모델 API를 호출하는 야간 배치 작업을 운영하는 ML 엔지니어
작업이 조용히 멈추면 알고 싶다
푸시 모니터는 각 실행이 끝날 때 작업이 URL을 호출하기를 기다렸다가, 제때 호출이 오지 않으면 알립니다. 배치 서버로 들어오는 접근 권한은 필요 없습니다.
도입 전 확인할 점
- 설정
- 프로젝트의 compose.yaml로 docker compose up -d를 실행하거나 docker run 명령 하나로 띄우며, 포트 3001에서 동작합니다. Docker 없이 설치하려면 Node.js 20.4 이상과 pm2가 필요하고, FreeBSD는 지원하지 않습니다.
- 연동
- HTTP(s), TCP, 키워드, JSON 쿼리, WebSocket, ping, DNS, 푸시, Docker 컨테이너 모니터. Telegram, Discord, Slack, Pushover, SMTP 이메일 등 90개가 넘는 알림 서비스.
- 데이터와 개인정보
- 모든 데이터는 자기 서버에 남습니다. 인스턴스는 알림 토큰과 모니터에 넘긴 헤더나 API 키를 저장하며, 기본적으로 모든 인터페이스에서 수신 대기합니다.
- 대규모 사용 시 비용
- 규모와 상관없이 라이선스나 호스팅 비용이 없습니다. 비용은 실행하는 서버뿐이며, 모니터가 많을 때의 자원 수치는 공개되지 않았습니다.
- 제한
- 열린 이슈와 풀 리퀘스트는 850개이며, README에는 메인테이너가 모든 풀 리퀘스트를 테스트할 시간이 없다고 적혀 있습니다. 1.x에서 2.0 같은 메이저 업그레이드에는 마이그레이션 가이드와 백업이 필요합니다.
좋은 점
- Docker 컨테이너 하나로 몇 분 만에 실행되며 외부 데이터베이스가 필요 없음
- 포트 ping만이 아니라 프롬프트를 보내 응답을 확인하는 모니터
- 90개가 넘는 알림 서비스와 공개 상태 페이지
- 기능을 막아 두는 유료 에디션이 없는 MIT 라이선스
아쉬운 점
- 2026년 10월과 11월에 심각도 높음 보안 권고가 여러 건
- API 키와 알림 토큰을 저장하므로 인스턴스 보호가 필요함
- 모델 호출에 대한 토큰, 비용, 품질 지표가 없음
- 데이터 디렉터리를 NFS에 둘 수 없음
추천 대상
Ollama, Open WebUI 등 AI 서비스를 운영하며 엔드포인트나 모델이 응답을 멈추는 즉시 경보를 받고 싶은 자체 호스팅 사용자와 소규모 팀.
Uptime Kuma: 자주 묻는 질문
- Uptime Kuma, 쓸 만한 가치가 있습니까?
- 자체 호스팅 모델 서버 옆에 두어야 할 감시 도구입니다. 빨리 띄울 수 있고 무료이며 Ollama가 죽으면 알려 주지만, 측정하는 것은 가용성이지 모델 품질이 아닙니다. 평점은 5점 만점에 4.2점입니다.
- Uptime Kuma의 가격은 얼마입니까?
- MIT 라이선스의 무료 오픈 소스입니다. 공식 호스팅이나 유료 요금제는 없으며 직접 운영합니다.
- Uptime Kuma의 단점은 무엇입니까?
- 2026년 10월과 11월에 심각도 높음 보안 권고가 여러 건; API 키와 알림 토큰을 저장하므로 인스턴스 보호가 필요함; 모델 호출에 대한 토큰, 비용, 품질 지표가 없음; 데이터 디렉터리를 NFS에 둘 수 없음.
- Uptime Kuma에 적합한 사람은 누구입니까?
- Ollama, Open WebUI 등 AI 서비스를 운영하며 엔드포인트나 모델이 응답을 멈추는 즉시 경보를 받고 싶은 자체 호스팅 사용자와 소규모 팀.
- 팀이나 프로덕션 환경에서 Uptime Kuma의 비용은 얼마입니까?
- 규모와 상관없이 라이선스나 호스팅 비용이 없습니다. 비용은 실행하는 서버뿐이며, 모니터가 많을 때의 자원 수치는 공개되지 않았습니다.
- Uptime Kuma에 회사 데이터를 맡겨도 안전합니까?
- 모든 데이터는 자기 서버에 남습니다. 인스턴스는 알림 토큰과 모니터에 넘긴 헤더나 API 키를 저장하며, 기본적으로 모든 인터페이스에서 수신 대기합니다.
답변 확인일: 2026년 11월 16일.