쿨라: 의존성 없이 독립적으로 실행되는 리눅스 서버 모니터링

Kula의 기능

Kula는 /proc와 /sys에서 직접 읽어 시스템 메트릭을 매초 수집하고, 내장된 계층형 링 버퍼 스토리지 엔진에 저장하며, 실시간 웹 UI 대시보드와 터미널 TUI를 통해 제공합니다.

수집되는 메트릭

• CPU: 총 사용량(사용자, 시스템, iowait, irq, softirq, steal) + 코어 수
• 부하: 1/5/15분 평균, 실행 중 및 총 작업 수
• 메모리: 총량, 여유, 사용 가능, 사용 중, 버퍼, 캐시, shmem
• 스왑: 총량, 여유, 사용 중
• 네트워크: 인터페이스별 처리량(Mbps), 패킷/초, 오류, 드롭; TCP 오류/초, 재설정/초, 확립된 연결; 소켓 수
• 디스크: 장치별 I/O(읽기/쓰기 바이트/초, 읽기/초, 쓰기/초 IOPS); 파일 시스템 사용량
• 시스템: 업타임, 엔트로피, 클록 동기, 호스트명, 로그인된 사용자 수
• 프로세스: 실행 중, 대기 중, 차단됨, 좀비 수
• 자체: Kula 자체의 CPU%, RSS 메모리, 열린 파일 디스크립터

스토리지 엔진

데이터는 계층별로 고정된 최대 크기의 사전 할당된 링 버퍼 파일에 지속 저장됩니다. 파일이 가득 차면 새로운 데이터가 가장 오래된 항목을 덮어씁니다.

• 계층 1: 원본 1초 샘플(기본 250 MB)
• 계층 2: 1분 집계: 평균 CPU 및 네트워크, 최종 값 게이지(기본 150 MB)
• 계층 3: 5분 집계, 동일한 로직(기본 50 MB)

대시보드 기능

HTTP 서버는 실시간 스트리밍을 위한 REST API와 WebSocket 엔드포인트를 노출합니다. 인증은 선택 사항이며, 활성화 시 Argon2id 해싱과 솔트 및 세션 쿠키를 사용합니다. 프론트엔드는 바이너리에 내장된 단일 페이지 애플리케이션으로 다음 기능을 포함합니다:

• 드래그 선택으로 상호작용적 줌(실시간 스트림 자동 일시정지)
• 선택한 그래프만 표시하는 포커스 모드
• 그리드 / 스택 목록 레이아웃 전환
• 클록 동기, 엔트로피 문제, 과부하에 대한 경고 시스템

설치

amd64(x86_64) GNU/Linux용 설치 방법 예시입니다. ARM 및 RISC-V 패키지는 릴리즈를 확인하세요.

독립 실행형

wget https://github.com/c0m4r/kula/releases/download/0.7.1/kula-0.7.1-amd64.tar.gz
echo " 6baff6bee9f9bbf56adc6e264e7ff9e1dfa763e7bab76a21dbc1e7d4be0397f4 kula-0.7.1-amd64.tar.gz " | sha256sum -c || rm kula-0.7.1-amd64.tar.gz
tar -xvf kula-0.7.1-amd64.tar.gz
cd kula
./kula

Debian/Ubuntu

wget https://github.com/c0m4r/kula/releases/download/0.7.1/kula_0.7.1_amd64.deb
echo " bbcd6ee65441c85f5bc835c40a1afaabc78b78d976c25e535c051b29ad514185 kula_0.7.1_amd64.deb " | sha256sum -c || rm kula_0.7.1_amd64.deb
sudo dpkg -i kula_0.7.1_amd64.deb
systemctl status kula

소스 빌드

git clone https://github.com/c0m4r/kula.git
cd kula
bash addons/build.sh

사용법

빠른 시작

# 1. 설정 파일 복사 및 편집(선택 사항)
cp config.example.yaml config.yaml
# 2. 서버 시작
./kula serve
# 대시보드는 http://127.0.0.1:8080에서 확인 가능
# 3. 또는 터미널 UI 사용
./kula tui

인증(선택 사항)

# 비밀번호 해시 생성
./kula hash-password
# 출력을 config.yaml의 web.auth 아래에 추가

이 프로젝트는 현재 버전 0.7.1이며, 저자는 아직 몇 가지 미완성 부분이 있고 성숙해야 하지만 이미 여러 서버에서 프로덕션 환경에서 사용되고 있다고 언급했습니다.