Lab Docker

Ba container chạy trên cùng một Docker network (Compose tự tạo). Trong network đó, mỗi service gọi nhau qua tên service (DNS nội bộ), còn ta truy cập từ máy host qua cổng đã publish:

Luồng dữ liệu đi theo hướng:

• Node Exporter phơi metrics tại :9100/metrics (CPU, RAM, filesystem, network của máy host).
• Prometheus định kỳ scrape (kéo) endpoint node-exporter:9100/metrics, và cả chính nó localhost:9090, rồi lưu vào TSDB nội bộ.
• Grafana query Prometheus tại http://prometheus:9090 mỗi khi render panel, rồi vẽ lên dashboard.
• Bạn mở trình duyệt tới http://localhost:3000 để xem.

Tạo một thư mục grafana-lab với bố cục sau. Việc tách file provisioning giúp Grafana tự cấu hình khi khởi động, không cần bấm tay:

Tạo nhanh khung thư mục bằng lệnh (chạy trong thư mục cha):

# Linux / macOS / Git Bash
mkdir -p grafana-lab/prometheus
mkdir -p grafana-lab/grafana/provisioning/datasources
mkdir -p grafana-lab/grafana/provisioning/dashboards

# Windows PowerShell
New-Item -ItemType Directory -Force grafana-lab\prometheus
New-Item -ItemType Directory -Force grafana-lab\grafana\provisioning\datasources
New-Item -ItemType Directory -Force grafana-lab\grafana\provisioning\dashboards

• docker-compose.yml: khai báo 3 service, network, volume và cách mount cấu hình.
• prometheus/prometheus.yml: chu kỳ scrape và danh sách target.
• grafana/provisioning/datasources/datasource.yml: tự thêm Prometheus làm data source.
• grafana/provisioning/dashboards/dashboard.yml: khai báo provider để Grafana nạp dashboard JSON từ thư mục.

Đây là file trung tâm. Lưu vào grafana-lab/docker-compose.yml:

services:
  prometheus:
    image: prom/prometheus:latest
    container_name: prometheus
    restart: unless-stopped
    ports:
      - "9090:9090"
    volumes:
      - ./prometheus/prometheus.yml:/etc/prometheus/prometheus.yml:ro
      - prometheus-data:/prometheus
    command:
      - '--config.file=/etc/prometheus/prometheus.yml'
      - '--storage.tsdb.path=/prometheus'
      - '--web.enable-lifecycle'
    networks:
      - monitoring

  node-exporter:
    image: prom/node-exporter:latest
    container_name: node-exporter
    restart: unless-stopped
    ports:
      - "9100:9100"
    command:
      - '--path.rootfs=/host'
    volumes:
      - /:/host:ro,rslave
    networks:
      - monitoring

  grafana:
    image: grafana/grafana:latest
    container_name: grafana
    restart: unless-stopped
    ports:
      - "3000:3000"
    environment:
      - GF_SECURITY_ADMIN_USER=admin
      - GF_SECURITY_ADMIN_PASSWORD=admin
      - GF_USERS_ALLOW_SIGN_UP=false
    volumes:
      - grafana-storage:/var/lib/grafana
      - ./grafana/provisioning:/etc/grafana/provisioning:ro
    depends_on:
      - prometheus
    networks:
      - monitoring

volumes:
  prometheus-data:
  grafana-storage:

networks:
  monitoring:
    driver: bridge

Prometheus cần biết kéo metrics từ đâu và bao lâu một lần. Lưu vào grafana-lab/prometheus/prometheus.yml:

global:
  scrape_interval: 15s        # mặc định kéo mỗi 15 giây
  evaluation_interval: 15s    # đánh giá rule mỗi 15 giây

scrape_configs:
  # 1) Prometheus tự giám sát chính nó
  - job_name: 'prometheus'
    static_configs:
      - targets: ['localhost:9090']

  # 2) Node Exporter — gọi qua tên service trong Docker network
  - job_name: 'node-exporter'
    static_configs:
      - targets: ['node-exporter:9100']

Data source. Thay vì vào UI bấm tay, ta khai báo Prometheus bằng file YAML để Grafana tự nạp khi khởi động. Lưu vào grafana-lab/grafana/provisioning/datasources/datasource.yml:

apiVersion: 1

datasources:
  - name: Prometheus
    type: prometheus
    access: proxy
    url: http://prometheus:9090
    isDefault: true
    editable: true

Chú ý url là http://prometheus:9090 — dùng tên service, vì Grafana container gọi Prometheus container qua DNS nội bộ của Docker network, không phải qua localhost của máy host.

Dashboard provider. File này bảo Grafana quét một thư mục và tự nạp mọi file dashboard .json trong đó. Lưu vào grafana-lab/grafana/provisioning/dashboards/dashboard.yml:

apiVersion: 1

providers:
  - name: 'default'
    orgId: 1
    folder: ''
    type: file
    disableDeletion: false
    updateIntervalSeconds: 30
    allowUiUpdates: true
    options:
      path: /etc/grafana/provisioning/dashboards

• Khởi động stack. Trong thư mục grafana-lab, chạy:

  docker compose up -d

  Docker sẽ tải image và bật cả 3 container ở chế độ nền. Kiểm tra bằng docker compose ps — cả ba phải ở trạng thái Up.
• Kiểm tra Prometheus. Mở http://localhost:9090 → menu Status → Targets. Cả prometheus và node-exporter phải hiện UP. Nếu node-exporter DOWN, xem lại tên target trong prometheus.yml.
• Mở Grafana. Truy cập http://localhost:3000.
• Đăng nhập bằng admin / admin (theo biến môi trường đã đặt trong compose).
• Đổi mật khẩu. Grafana yêu cầu đổi ngay lần đầu — đặt mật khẩu mới (hoặc bấm Skip nếu chỉ là lab local).
• Kiểm tra data source. Vào Connections → Data sources → Prometheus (đã có sẵn nhờ provisioning) → cuộn xuống bấm Save & test. Phải hiện "Successfully queried the Prometheus API".
• Import dashboard "Node Exporter Full". Vào Dashboards → New → Import, ở ô Import via grafana.com nhập ID 1860, bấm Load, chọn data source Prometheus, rồi Import. Bạn sẽ thấy ngay dashboard đầy đủ CPU, RAM, disk, network của máy.

Grafana cấu hình rất tốt qua biến môi trường, theo quy tắc GF_<SECTION>_<KEY>. Vài biến hữu ích:

- GF_AUTH_ANONYMOUS_ENABLED=true
- GF_AUTH_ANONYMOUS_ORG_ROLE=Viewer

Dừng và dọn dẹp lab:

# Dừng nhưng GIỮ dữ liệu (volume còn nguyên)
docker compose down

# Dừng và XOÁ luôn dữ liệu (volume bị xoá)
docker compose down -v

Vài lệnh chẩn đoán nhanh:

# Xem trạng thái các container
docker compose ps

# Xem log của một service (theo dõi realtime)
docker compose logs -f grafana
docker compose logs -f prometheus

# Vào trong container Prometheus để test kết nối tới node-exporter
docker compose exec prometheus wget -qO- http://node-exporter:9100/metrics | head