---
title: "FreeBSD 홈 NAS에 VictoriaMetrics + Grafana 모니터링 스택 구축하기"
published: 2026-02-12T22:48:06.000Z
canonical: https://jeff.news/article/727
---
# FreeBSD 홈 NAS에 VictoriaMetrics + Grafana 모니터링 스택 구축하기

FreeBSD 홈 NAS에 VictoriaMetrics, Grafana, VMAlert, Alertmanager를 Kubernetes 없이 호스트에 직접 설치하는 과정을 정리한 글임. vmutils 패키지의 rc.d 스크립트 누락이나 Grafana VM 플러그인의 FreeBSD 미지원 같은 실전 삽질 포인트도 함께 다룸.

## 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`으로 계산함

> [!TIP]
> FreeBSD에서 VictoriaMetrics 스택을 구성할 때 vmutils 패키지에 vmalert용 rc.d 스크립트가 빠져있다는 점, Grafana VM 플러그인이 FreeBSD를 지원하지 않는다는 점을 미리 알아두면 삽질을 줄일 수 있음

## 핵심 포인트

- VictoriaMetrics, node_exporter, VMAgent, Grafana, Alertmanager 모두 FreeBSD pkg로 설치 가능
- vmutils 패키지에 vmalert용 rc.d 스크립트가 빠져있어 직접 작성 필요
- VictoriaMetrics Grafana 플러그인은 FreeBSD 바이너리 미지원으로, 기본 Prometheus datasource 사용
- ntfy.sh를 webhook으로 연동해 알림 수신 구성
- FreeBSD 메모리 메트릭은 Linux과 다르므로 Grafana 대시보드 쿼리 커스터마이징 필요

## 인사이트

Kubernetes 없이 호스트에 직접 모니터링 스택을 올리는 과정이 FreeBSD 특유의 포트/패키지 구조와 맞물려 실전 트러블슈팅 레퍼런스로 가치가 있음.