GitHub 오픈소스 탐험

최근에는 웹사이트나 서버의 가용성을 확인하고 관리하는 것이 점점 더 중요해지고 있습니다. 특히, 서비스의 연속성을 유지하기 위해서는 모니터링 도구가 필수적입니다. Uptime Kuma는 이러한 문제를 해결하기 위해 탄생한 오픈소스 프로젝트로, 사용자가 직접 호스팅할 수 있는 간편한 모니터링 도구입니다. 이 글에서는 Uptime Kuma의 주요 기능과 설치 방법, 그리고 실제 활용 사례를 살펴보겠습니다.

Uptime Kuma의 주요 기능

Uptime Kuma는 다양한 기능을 제공하여 사용자에게 편리한 모니터링 환경을 제공합니다. 다음은 그 주요 기능입니다:

다양한 모니터링 옵션: HTTP, TCP, WebSocket, DNS 레코드, Ping, Docker 컨테이너 등 다양한 프로토콜을 지원하여, 사용자는 필요한 모든 서비스를 모니터링할 수 있습니다.
반응형 UI/UX: 우아하고 빠른 사용자 인터페이스를 제공하여, 언제 어디서나 쉽게 접근할 수 있습니다.
다양한 알림 서비스: Telegram, Discord, Slack 등의 플랫폼과 연동하여 실시간으로 알림을 받을 수 있습니다.
다양한 언어 지원: 여러 언어로 제공되어, 글로벌 사용자들이 편리하게 사용할 수 있습니다.
2단계 인증(2FA) 지원: 보안성을 높이기 위한 2단계 인증을 지원합니다.

설치 방법

Uptime Kuma는 Docker를 통해 간편하게 설치할 수 있으며, 비-Docker 환경에서도 설치 가능합니다. 아래는 Docker와 비-Docker 설치 방법을 설명합니다.

Docker Compose를 이용한 설치

새로운 디렉토리를 만들어 줍니다.

    mkdir uptime-kuma
    cd uptime-kuma

Docker Compose 파일을 다운로드합니다.

    curl -o compose.yaml https://raw.githubusercontent.com/louislam/uptime-kuma/master/compose.yaml

Docker Compose를 실행합니다.

    docker compose up -d

이제 Uptime Kuma는 http://localhost:3001 또는 서버의 IP 주소를 통해 접근할 수 있습니다.

Docker 명령어를 이용한 설치

다음 명령어로 Docker를 실행합니다.

    docker run -d --restart=always -p 3001:3001 -v uptime-kuma:/app/data --name uptime-kuma louislam/uptime-kuma:2

- 만약 로컬호스트만 사용하고 싶다면 아래 명령어를 사용합니다.

    docker run -d --restart=always -p 127.0.0.1:3001:3001 -v uptime-kuma:/app/data --name uptime-kuma louislam/uptime-kuma:2

비-Docker 환경에서의 설치

먼저 Node.js와 Git, PM2를 설치합니다.
저장소를 클론합니다.

    git clone https://github.com/louislam/uptime-kuma.git
    cd uptime-kuma
    npm run setup

서버를 시작합니다.

    node server/server.js

PM2를 통해 백그라운드에서 실행하려면 아래 명령어를 사용하세요.

npm install pm2 -g
pm2 start server/server.js --name uptime-kuma

실무에서의 활용 시나리오

Uptime Kuma는 다음과 같은 시나리오에서 활용될 수 있습니다:

웹사이트 모니터링: 주요 웹사이트의 가용성을 24/7 모니터링하고, 문제가 발생할 경우 즉시 알림을 받습니다.
서버 및 서비스 상태 확인: 서버나 서비스의 상태를 주기적으로 체크하여, 서비스 중단을 사전에 예방합니다.
Docker 컨테이너 모니터링: Docker 환경에서 실행되는 여러 서비스의 상태를 통합적으로 관리합니다.

유사 도구와의 비교

Uptime Kuma는 Uptime Robot, Pingdom 등과 같은 상용 모니터링 서비스와 비교할 수 있습니다. 상용 서비스들은 종종 유료이며, 복잡한 설정이 필요할 수 있습니다. 반면, Uptime Kuma는 오픈소스이기 때문에 무료로 사용할 수 있으며, 필요한 기능을 직접 커스터마이즈할 수 있는 장점이 있습니다. 또한, 데이터 보호를 위해 직접 호스팅할 수 있다는 점에서 더 많은 유연성을 제공합니다.

Uptime Kuma로 나만의 모니터링 도구를 만들어보세요