uptime-kuma 이용해서 Health Check하기

SUM·2023년 12월 27일

참조 Open Source : https://github.com/louislam/uptime-kuma?ref=it-svr.com

(솔직히 처음에 회사에서 Health Check라고 해서 뭘까 잠시 고민했다. 음 건강체크?하면서. 당연히 서버의 이상 체크인줄은 느낌상으로 알았지만, 처음들은 단어라 ,,)
저와 같은 분들이 있을 수 있기 때문에 잠시 Health Check에 대해서 설명하자면,

  • Health Check란, 서버의 상태를 주기적으로 확인하여 서버의 정상 작동 여부를 판단하는 과정이라고 한다.

  • 본인은 사이트의 응답 시간을 모니터링하기 위하여 작업을 진행하였다.

  • 네트워크 상황마다 결과 값이 다르게 보일 수 있음

1. 환경 세팅

  • Docker를 이용하지 않고, 로컬에서 확인해볼 예정

⚙️ Requirements

  • Platform
    ✅ Major Linux distros such as Debian, Ubuntu, CentOS, Fedora and ArchLinux etc.
    ✅ Windows 10 (x64), Windows Server 2012 R2 (x64) or higher

  • Node.js 14 / 16 / 18 / 20.4

  • npm 9

  • Git

  • pm2 - For running Uptime Kuma in the background
    : PM2는 JavaScript 런타임 Node.js의 프로세스 관리자

node 및 npm 설치를 확인하였고, pm2를 설치하였다.

2. 실행 방법

  • github에 나온대로 그대로 명령어 실행했더니 local에서 실행이 된다.
# Update your npm
npm install npm@9 -g

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

# Option 1. Try it
node server/server.js

# (Recommended) Option 2. Run in the background using PM2 - 나도 이 방법을 썼다.
# Install PM2 if you don't have it: - 위에서 이미 PM2를 설치했으니 패스
npm install pm2 -g && pm2 install pm2-logrotate

# Start Server
pm2 start server/server.js --name uptime-kuma

위의 작업을 완료하면, 로그인창이 뜨고, 로그인 후엔 다음과 같은 설정 창이 뜬다.
다른 건 잘 모르겠어서ㅎㅎ 이름과 url, 하트비트 주기만 120으로 설정하였다.


  • 작업 후엔 다음과 같이 모니터링 창이 뜨고, 시간이 흐름에 따라 정보가 수집된다.

3. 주의점

  • Health Check는 네트워크 상황에 따라 다른 결과값이 나올 수 있습니다.

* 개인적으로 작업한 내용입니다. 궁금한 점이나 조언해주실 부분이 있다면 언제든 댓글 부탁드립니다!

profile
백엔드 개발자 SUM입니다.

0개의 댓글