Posted inHomeLab

Triển khai Netdata trên Docker: Giám sát Hệ thống, Container và Mạng theo Thời gian Thực cho HomeLab

HomeLab tutorial - IT technology blog
HomeLab tutorial - IT technology blog

Bối cảnh & Lý do: Khi Bạn Cần Câu Trả Lời trong Vài Giây, Không Phải Vài Phút

Vận hành HomeLab có nghĩa là bạn liên tục đặt ra cùng một câu hỏi: tại sao dịch vụ này lại chậm ngay lúc này? Tôi đã từng trải qua đúng khoảnh khắc đó — stream Jellyfin bắt đầu giật cục lúc 11 giờ đêm, và tôi cần biết ngay là do CPU, RAM, disk I/O hay mạng.

Tôi đã chạy TIG Stack (Telegraf + InfluxDB + Grafana) cho các số liệu hạ tầng, và Grafana Loki cho log. Cả hai đều tốt. Nhưng khởi động chúng mất thời gian, và bạn cần xây dựng dashboard từ đầu. Khi thêm máy mới vào lab, tôi không muốn phải cấu hình Telegraf agent và kết nối các panel Grafana trước khi nhìn thấy bất cứ thứ gì.

Đó là lúc Netdata lấp đầy khoảng trống trong stack của tôi. Nó triển khai bằng một lệnh docker compose up duy nhất, bắt đầu thu thập số liệu ngay lập tức — CPU, memory, disk, mạng, container đang chạy, dịch vụ systemd — và hiển thị tất cả trên dashboard đầy đủ tại cổng 19999 trong khoảng 30 giây. Không cần thiết kế schema, không cần xây dựng panel.

Netdata cũng chạy rất nhẹ. Nó dùng khoảng 100 MB RAM và 1–2% CPU trên hầu hết các máy HomeLab. Trên Raspberry Pi 4 chạy 15 container, nó hầu như không gây ảnh hưởng gì.

Từ kinh nghiệm thực tế của tôi, đây là một trong những kỹ năng cốt lõi cần nắm vững — biết công cụ giám sát nào phù hợp với vấn đề nào. Netdata lấp đầy khoảng trống giữa “không có gì” và một stack quan sát đầy đủ. Nó trả lời câu hỏi tức thì một cách nhanh chóng, trong khi Grafana xử lý phân tích dài hạn.

Cài đặt: Thiết lập Docker Compose

Tạo thư mục cho Netdata và thêm file docker-compose.yml:

mkdir -p ~/homelab/netdata && cd ~/homelab/netdata
version: "3.8"

services:
  netdata:
    image: netdata/netdata:latest
    container_name: netdata
    hostname: homelab-monitor   # Hiển thị trên tiêu đề dashboard
    restart: unless-stopped
    pid: host
    network_mode: host          # Cần thiết để lấy số liệu giao diện mạng thực
    cap_add:
      - SYS_PTRACE
      - SYS_ADMIN
    security_opt:
      - apparmor:unconfined
    volumes:
      - netdataconfig:/etc/netdata
      - netdatalib:/var/lib/netdata
      - netdatacache:/var/cache/netdata
      - /etc/passwd:/host/etc/passwd:ro
      - /etc/group:/host/etc/group:ro
      - /proc:/host/proc:ro
      - /sys:/host/sys:ro
      - /etc/os-release:/host/etc/os-release:ro
      - /var/run/docker.sock:/var/run/docker.sock:ro

volumes:
  netdataconfig:
  netdatalib:
  netdatacache:

Có một vài điều đáng giải thích trước khi bạn chỉ sao chép và chạy:

  • pid: host — cho phép Netdata nhìn thấy tất cả tiến trình của host. Nếu thiếu, số liệu CPU và memory theo từng tiến trình sẽ biến mất.
  • network_mode: host — nếu thiếu, Netdata chỉ thấy NIC ảo của container, không phải các giao diện thực như eth0, ens3 hay bond interface.
  • /var/run/docker.sock — đây là cách Netdata tự động phát hiện các container khác và báo cáo CPU, memory và I/O theo từng container, không cần cấu hình thêm.
  • SYS_PTRACE — cần thiết cho các số liệu dựa trên eBPF như kết nối TCP đang hoạt động và các thao tác VFS.

Khởi động và xem log ngắn gọn để xác nhận khởi tạo thành công:

docker compose up -d
docker logs -f netdata   # Sẽ sẵn sàng trong vòng 30 giây

Mở http://<your-host-ip>:19999. Dashboard tải ngay lập tức.

Cấu hình: Lưu trữ, Kiểm soát Truy cập và Cảnh báo

Chỉnh sửa Cấu hình Chính

Netdata đi kèm với công cụ hỗ trợ sao chép các file cấu hình mặc định vào volume cố định trước khi chỉnh sửa. Hãy dùng nó thay vì tạo file từ đầu:

docker exec -it netdata bash
./edit-config netdata.conf

Các cài đặt quan trọng tôi thay đổi trên mỗi node HomeLab:

[global]
  # Tăng cửa sổ lịch sử trong bộ nhớ
  history = 7200   # 2 giờ tính bằng giây

[web]
  # Giới hạn dashboard chỉ trong mạng LAN — không để lộ ra internet
  allow connections from = localhost 192.168.1.*

[db]
  # Lưu số liệu ra đĩa để giữ trong nhiều ngày
  mode = dbengine
  storage tiers = 1

Với mode = dbengine, Netdata nén số liệu vào volume netdatacache. Mặc định giữ khoảng 2 ngày dữ liệu, đủ để xử lý hầu hết các sự cố HomeLab. Nếu cần lưu trữ lâu hơn trên nhiều máy, Netdata Cloud (gói miễn phí) tổng hợp tất cả vào một nơi.

Cảnh báo Telegram trong Dưới 2 Phút

Netdata đi kèm với các quy tắc cảnh báo có sẵn cho CPU cao, dung lượng đĩa thấp, áp lực RAM, lỗi mạng và nhiều hơn nữa. Kết nối chúng với Telegram chỉ mất khoảng 2 phút:

docker exec -it netdata bash
./edit-config health_alarm_notify.conf

Tìm phần Telegram và điền thông tin xác thực của bạn:

SEND_TELEGRAM="YES"
TELEGRAM_BOT_TOKEN="123456789:ABCdefGHIjklMNOpqrSTUvwxYZ"
DEFAULT_RECIPIENT_TELEGRAM="-1001234567890"   # ID chat hoặc nhóm của bạn

Kiểm tra ngay mà không kích hoạt cảnh báo thực:

/usr/libexec/netdata/plugins.d/alarm-notify.sh test telegram

Tin nhắn kiểm tra sẽ đến Telegram trong vài giây.

Tắt Cảnh báo Không Phù hợp với Thiết lập của Bạn

Trên các máy mà swap bị tắt có chủ đích, cảnh báo sử dụng swap liên tục kích hoạt. Hãy tắt nó thay vì để nó làm nhiễu:

docker exec -it netdata bash
./edit-config health.d/swap.conf

Thêm enabled: no vào bất kỳ quy tắc nào không áp dụng. Nâng ngưỡng để phù hợp với kỳ vọng thực tế của bạn (thay vì dùng mặc định chung) thường là lựa chọn tốt hơn so với vô hiệu hóa hoàn toàn các quy tắc.

Kiểm tra & Giám sát: Đọc Dashboard

Những Điều Cần Kiểm tra Đầu tiên Sau Khi Cài đặt

Thanh bên trái liệt kê mọi hệ thống con mà Netdata phát hiện được. Trên một server HomeLab thông thường bạn sẽ thấy:

  • System Overview — CPU, RAM, swap, load average ở một nơi
  • Disk — I/O, utilization, latency theo từng đĩa. Nếu NAS hay media server của bạn chậm chạp, hãy bắt đầu từ đây
  • Network Interfaces — traffic, packet, lỗi theo từng giao diện. Với network_mode: host, bạn thấy các giao diện thực bao gồm VPN tunnel (wg0, tun0)
  • Containers — CPU và memory theo từng container, sắp xếp theo mức sử dụng. Đây là phần tôi mở đầu tiên khi có gì đó không ổn

Khả năng Hiển thị ở Mức Container

Nhấp vào Containers ở thanh bên. Mỗi container đang chạy hiển thị như một nhóm biểu đồ riêng — CPU usage, memory consumption, disk reads/writes và network I/O, tất cả được phân tách rõ ràng.

Khi lần đầu triển khai Netdata trên lab, tôi nhận ra Uptime Kuma đang ghi đĩa với tốc độ 15 MB/s cứ vài phút một lần. Nó đang ghi log liên tục vào cơ sở dữ liệu SQLite. Hoàn toàn vô hình trước khi có Netdata. Mất khoảng 90 giây để tìm ra nguyên nhân sau khi mở dashboard — trước đó, tôi chỉ chấp nhận tình trạng thắt cổ chai đĩa thỉnh thoảng như một sự cố không giải thích được.

Xác nhận Docker Metrics Đang Hoạt động

Nếu phần Containers bị thiếu hoặc trống, hãy kiểm tra socket mount và tìm lỗi:

# Kiểm tra lỗi Docker plugin
docker exec netdata cat /var/log/netdata/error.log | grep -i docker

# Đếm biểu đồ đang hoạt động — cài đặt bình thường với 20-30 container hiện 300-500+
curl -s http://localhost:19999/api/v1/charts | python3 -c "
import sys, json
data = json.load(sys.stdin)
print(f'Biểu đồ đang hoạt động: {len(data[\"charts\"])}')
"

Xây dựng Đường cơ sở Trước Khi Cần Đến

Dành 10 phút nhấp qua các biểu đồ ngay sau khi cài đặt, trong khi hệ thống đang hoạt động ở tải bình thường. Ghi chú phần trăm CPU nhàn rỗi, RAM trống thông thường và disk I/O cơ sở. Khi có sự cố lúc 2 giờ sáng, bạn cần có mô hình tâm trí về trạng thái bình thường là như thế nào — mã màu của Netdata (xanh/vàng/đỏ) cũng phản ánh điều này tự động dựa trên ngưỡng cảnh báo.

Xem Nhiều Node với Netdata Cloud

Nếu HomeLab của bạn trải rộng trên nhiều máy — một NAS, một host Proxmox, một Raspberry Pi — Netdata Cloud cung cấp một URL duy nhất cho tất cả. Đăng ký gói miễn phí, chạy lệnh claim trên mỗi node, và tất cả dashboard sẽ xuất hiện ở một nơi:

# Chạy bên trong mỗi container Netdata sau khi đăng ký tại app.netdata.cloud
docker exec -it netdata netdata-claim.sh -token=YOUR_CLAIM_TOKEN -rooms=YOUR_ROOM_ID -url=https://app.netdata.cloud

Nó kết nối ra ngoài thông qua cloud agent của Netdata — không cần mở thêm port inbound, không cần VPN.

Tại thời điểm này, HomeLab của bạn có khả năng hiển thị theo thời gian thực cho mọi tài nguyên quan trọng. Thêm máy mới, triển khai container, và nó bắt đầu báo cáo ngay lập tức. Không cần xây dựng dashboard YAML, không cần cấu hình Prometheus scrape, không cần chờ số liệu đến muộn 15 giây vì khoảng thời gian polling chậm.

Share:
Tags: