Proxmox + Home Assistant에서 glances로 하드웨어 모니터링하기

안녕하세요. Home Assistant를 물리 머신에 직접 설치해서 사용하다가, 언젠가부터 Proxmox 위에 VM(가상 머신)으로 운영하게 됐습니다. VM으로 전환하면 스냅샷 백업이 편해지고, 같은 서버에 다른 서비스도 함께 올릴 수 있어서 관리 효율이 높아집니다. 그런데 HA 대시보드에서 Proxmox 서버의 하드웨어 상태(CPU, 메모리, 온도 등)를 직접 확인하고 싶었습니다. 그 해결책으로 찾은 것이 바로 glances입니다.

 

□ glances란 무엇인가

glances는 Python으로 작성된 경량 시스템 모니터링 도구입니다. top, htop 같은 터미널 기반 모니터링과 달리 Web UI와 REST API를 제공해 다른 시스템에서 데이터를 가져올 수 있습니다.

glances가 제공하는 정보는 다음과 같습니다.

- CPU 사용률 및 코어별 사용량
- 메모리 사용량 (RAM, Swap)
- 디스크 I/O 및 사용량
- 네트워크 트래픽 (인터페이스별)
- CPU/마더보드 온도 (센서 지원 시)
- 실행 중인 프로세스 목록

REST API로 JSON 형태의 데이터를 반환하기 때문에 Home Assistant의 REST 센서와 완벽하게 연동됩니다.

 

□ Proxmox에 glances Docker 컨테이너 설치

Proxmox에 glances를 설치하는 가장 간편한 방법은 Docker 컨테이너입니다. Proxmox 서버에 Docker가 설치되어 있다면 다음 명령으로 바로 실행할 수 있습니다.

docker run -d \
  --name glances \
  --restart=unless-stopped \
  --pid=host \
  --network=host \
  -e GLANCES_OPT="-w" \
  -v /var/run/docker.sock:/var/run/docker.sock:ro \
  -v /run/udev/data:/run/udev/data:ro \
  nicolargo/glances:latest

- --pid=host: 호스트 프로세스 정보를 정확히 읽기 위해 필요합니다.
- --network=host: 호스트 네트워크 인터페이스 정보를 가져오기 위해 필요합니다.
- -e GLANCES_OPT="-w": 웹서버 모드로 실행 (기본 포트 61208)

설치 후 브라우저에서 http://{Proxmox-IP}:61208에 접속하면 glances 웹 UI를 바로 확인할 수 있습니다.

 

□ Home Assistant REST 센서 설정

HA에서 glances 데이터를 가져오려면 REST 센서를 설정합니다. configuration.yaml에 다음과 같이 추가합니다.

sensor:
  - platform: rest
    name: "Proxmox CPU"
    resource: http://{Proxmox-IP}:61208/api/3/cpu
    value_template: "{{ value_json.total }}"
    unit_of_measurement: "%"
    scan_interval: 30

  - platform: rest
    name: "Proxmox Memory"
    resource: http://{Proxmox-IP}:61208/api/3/mem
    value_template: "{{ value_json.percent }}"
    unit_of_measurement: "%"
    scan_interval: 30

  - platform: rest
    name: "Proxmox CPU Temp"
    resource: http://{Proxmox-IP}:61208/api/3/sensors
    value_template: >-
      {{ (value_json | selectattr('label', 'equalto', 'Package id 0')
          | map(attribute='value') | first) }}
    unit_of_measurement: "°C"
    scan_interval: 60

API 엔드포인트는 /api/3/{항목명} 형태입니다. cpu, mem, diskio, network, sensors 등 다양한 항목을 개별적으로 가져올 수 있습니다.

 

□ HA 대시보드에 서버 상태 표시

REST 센서가 정상적으로 데이터를 가져오면 HA 대시보드에 게이지 카드나 그래프 카드로 표시합니다.

- Gauge 카드: CPU 사용률, 메모리 사용률을 게이지로 표시. 임계값 색상 설정으로 과부하 시 빨간색으로 표시
- History Graph 카드: 시간에 따른 CPU/메모리 변화를 그래프로 시각화
- Entity 카드: 온도, 디스크 사용량 등 수치 데이터를 나열

저는 "서버 상태" 탭을 별도로 만들어서 Proxmox CPU, 메모리, 온도, 네트워크 트래픽을 한눈에 볼 수 있는 대시보드를 구성했습니다. HA 앱에서 언제 어디서나 서버 상태를 확인할 수 있어서 서버에 문제가 생겼을 때 빠르게 파악할 수 있습니다.

 

□ 활용 팁 — 임계값 알림 설정

단순히 모니터링만 하는 것을 넘어서, 임계값을 초과하면 알림을 받도록 설정하면 더욱 유용합니다.

automation:
  - alias: "Proxmox CPU 과부하 알림"
    trigger:
      - platform: numeric_state
        entity_id: sensor.proxmox_cpu
        above: 85
        for: "00:05:00"
    action:
      - service: notify.mobile_app
        data:
          title: "서버 경고"
          message: "Proxmox CPU 사용률이 85%를 초과했습니다."

CPU 사용률이 5분 이상 85%를 넘으면 스마트폰으로 알림을 보내는 자동화입니다. 마찬가지로 온도가 80도 이상이거나 메모리가 90% 이상일 때 알림을 보내도록 추가 설정해 뒀습니다.

 

□ 마무리

glances를 이용한 Proxmox 모니터링은 설정 방법이 간단하면서도 결과물이 실용적입니다. HA 대시보드 하나에서 스마트홈 기기 상태와 서버 하드웨어 상태를 함께 볼 수 있어서 관리가 훨씬 편해졌습니다. Proxmox 위에 HA를 운영 중인 분이라면 꼭 한 번 적용해 보시길 추천드립니다. 별도의 모니터링 도구 없이도 HA 하나로 서버 상태까지 통합 관리할 수 있습니다.

감사합니다.