FreeBSD 홈 NAS에 VictoriaMetrics + Grafana 모니터링 스택 구축하기

FreeBSD 홈 NAS에 모니터링 스택 구축하기

• FreeBSD 홈 NAS 시리즈 10편으로, VictoriaMetrics + Grafana + VMAlert + Alertmanager 조합을 Kubernetes 없이 호스트에 직접 설치하는 과정을 다룸

VictoriaMetrics & node_exporter 설치

• pkg install -y victoria-metrics로 설치하고, sysrc victoria_metrics_enable="yes"로 서비스 등록하면 8428 포트에서 바로 동작함
• node_exporter도 동일하게 pkg install -y node_exporter로 설치, 9100 포트에서 메트릭 수집 시작됨
• VMAgent는 별도 포트가 없고 pkg install -y vmutils 패키지에 vmagent, vmalert, vmauth, vmbackup 등이 한꺼번에 포함되어 있음
• VMAgent의 scrape 설정은 /usr/local/etc/prometheus/prometheus.yml에 Prometheus 형식 그대로 작성하면 됨

Grafana 설정과 VictoriaMetrics 플러그인 삽질

• Grafana도 pkg install -y grafana로 설치 가능하지만, VictoriaMetrics 전용 datasource 플러그인은 FreeBSD용 바이너리가 없어서 실패함
• victoriametrics_metrics_backend_plugin_freebsd_amd64: no such file or directory 에러가 발생하는데, 결국 기본 내장된 Prometheus datasource를 사용하면 문제없이 동작함

알림 설정: VMAlert + Alertmanager + ntfy.sh

• Alertmanager는 pkg install -y alertmanager로 설치하고, webhook으로 ntfy.sh에 알림을 보내도록 설정함
• VMAlert용 rc.d 스크립트는 vmutils 패키지에 포함되어 있지 않아서 직접 /usr/local/etc/rc.d/vmalert 셸 스크립트를 작성해야 함
• 알림 규칙은 /usr/local/etc/vmalert/node-alerts.yml에 정의하며, up{job="node_exporter"} == 0 같은 표현식으로 exporter 다운 감지가 가능함
• ntfy.sh는 웹 인터페이스와 모바일 앱 모두 지원하는 알림 서비스로, Telegram 대신 간편하게 사용할 수 있음

FreeBSD 메모리 메트릭 커스터마이징

• 기본 Grafana 대시보드는 Linux 기준이라 FreeBSD에서는 메모리 그래프 쿼리를 수정해야 함
• FreeBSD의 핵심 메모리 메트릭은 node_memory_active_bytes(실사용), node_memory_wired_bytes(커널/드라이버, 해제 불가), node_memory_free_bytes(순수 여유)로 구분됨
• 실제 사용률은 (node_memory_active_bytes + node_memory_wired_bytes) / node_memory_size_bytes * 100으로 계산함