GitHub 오픈소스 탐험

최근에는 웹 서비스의 가용성을 모니터링하는 것이 매우 중요해졌습니다. 서비스 장애가 발생하면 사용자 경험이 저하되고, 결과적으로 비즈니스에도 큰 영향을 미칠 수 있기 때문입니다. 이러한 문제를 해결하기 위해 효과적으로 사용할 수 있는 도구가 바로 Uptime Kuma입니다. Uptime Kuma는 자가 호스팅이 가능한 모니터링 도구로, 사용자가 직접 서버를 운영할 수 있는 장점을 가지고 있습니다. 이 글에서는 Uptime Kuma의 주요 기능, 설치 방법, 그리고 실무에서의 활용 방안에 대해 자세히 알아보겠습니다.

Uptime Kuma의 주요 기능

Uptime Kuma는 다양한 기능을 제공하여 사용자가 쉽게 웹 서비스의 상태를 모니터링할 수 있도록 도와줍니다. 주요 기능은 다음과 같습니다:

다양한 모니터링 옵션: HTTP(S), TCP, WebSocket, Ping, DNS 레코드 등 여러 프로토콜을 지원합니다.
다양한 알림 서비스: Telegram, Discord, Slack, Email 등 90개 이상의 알림 서비스를 제공하여 문제가 발생했을 때 즉시 알림을 받을 수 있습니다.
반응형 사용자 인터페이스: 빠르고 직관적인 UI/UX를 제공하여 사용자가 쉽게 모니터링할 수 있도록 설계되었습니다.
지속적인 상태 페이지: 여러 개의 상태 페이지를 관리할 수 있으며, 각 페이지를 특정 도메인에 매핑할 수 있습니다.
2단계 인증 지원: 보안성을 높이기 위한 2FA(2-Factor Authentication)를 지원합니다.

Uptime Kuma는 이처럼 다양한 기능을 통해 사용자에게 편리한 서비스 모니터링 환경을 제공합니다.

Uptime Kuma 설치하기

Uptime Kuma는 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에 접속하여 대시보드를 확인해보세요.

Docker 명령어로 설치하기

Docker를 이용하여 직접 명령어로 설치할 수도 있습니다.

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

로컬에서 http://localhost:3001에 접속하면 Uptime Kuma 대시보드에 접근할 수 있습니다.

비-Docker 환경에서 설치하기

Docker를 사용하지 않으려면 Node.js를 통해 설치할 수 있습니다.

Uptime Kuma를 클론합니다.

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

Node.js 패키지를 설치합니다.

   npm run setup

서버를 실행합니다.

   node server/server.js

(추천) PM2를 통해 백그라운드에서 실행합니다.

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

이제 Uptime Kuma가 로컬에서 실행되며, 웹 브라우저를 통해 대시보드에 접근할 수 있습니다.

실무에서의 활용 방안

Uptime Kuma는 다양한 상황에서 유용하게 사용할 수 있습니다. 예를 들어, 웹 서비스를 운영하고 있는 기업에서는 이 도구를 통해 서비스의 가용성을 24시간 모니터링할 수 있습니다. 문제가 발생했을 경우, 즉각적인 알림을 통해 빠르게 대응할 수 있습니다.

또한, 개인 블로그나 프로젝트 웹사이트를 운영하는 개발자에게도 유용합니다. 서비스가 중단되었을 때, 손쉽게 알림을 받아 빠르게 문제를 해결할 수 있습니다.

비슷한 도구와의 비교

Uptime Kuma와 비슷한 도구로는 StatusCake, Pingdom, Grafana 등이 있습니다. 이들 도구는 클라우드 기반으로 제공되며, 별도의 서버 설정 없이도 즉시 사용할 수 있는 장점이 있습니다. 하지만 Uptime Kuma는 자가 호스팅이라는 점에서 유연성을 제공하며, 데이터 보안 측면에서도 이점을 지닙니다. 또한, 무료로 제공되는 오픈소스 프로젝트라는 점도 큰 장점입니다.

자가 호스팅 모니터링 도구, Uptime Kuma의 매력은 무엇일까?