Dashboard & Panel

Một dashboard được ghép từ các thành phần sau, từ ngoài vào trong:

Trên thanh đầu dashboard, từ trái sang phải bạn thường thấy: tên dashboard, các dropdown biến, nút Save, Share, time range picker và nút refresh. Toàn bộ trạng thái này (kể cả giá trị biến đang chọn) có thể mã hoá vào URL để chia sẻ đúng bối cảnh đang xem.

Mở một panel và bấm Edit, bạn vào panel editor với các tab chính:

Tab Query: chọn data source và viết một hoặc nhiều query (refId A, B, C...). Đây là nơi định nghĩa dữ liệu đầu vào cho panel.

Tab Transform: xử lý dữ liệu sau khi query trả về, ngay trong Grafana mà không đụng tới nguồn. Các transform hay dùng:

Field config & Overrides: ở cột phải, bạn cấu hình cách hiển thị. Các nhóm quan trọng:

• Standard options: Unit (bytes, %, req/s, ms...), Decimals, Min/Max, display name. Chọn đúng unit là khác biệt giữa "12000000000" và "12 GB".
• Thresholds: đặt ngưỡng màu (vd <70 xanh, 70–90 vàng, >90 đỏ) — tô màu Stat/Gauge/Table và vẽ đường ngưỡng trên đồ thị.
• Value mappings: ánh xạ giá trị thô sang nhãn dễ đọc (vd 1 → "Up", 0 → "Down", kèm màu).
• Overrides: áp cấu hình riêng cho một chuỗi/cột cụ thể — vd đổi màu đường "errors" sang đỏ, đổi unit riêng cột doanh thu.
• Legend & Tooltip: chú giải hiện ở đáy/phải panel (có thể kèm min/max/mean); tooltip điều khiển thông tin hiện khi rê chuột (Single / All / Hidden).

Variable biến một dashboard tĩnh thành công cụ động: thay vì tạo 10 dashboard cho 10 server, bạn tạo một dashboard với biến $instance và chọn server qua dropdown. Các loại biến:

Ví dụ biến Query kiểu Prometheus — lấy danh sách tất cả instance:

label_values(node_cpu_seconds_total, instance)

Sau khi khai báo biến $instance, dùng nó thẳng trong query lẫn tiêu đề panel:

# dùng trong PromQL
rate(node_cpu_seconds_total{instance="$instance"}[5m])

Các tính năng nâng cao của biến:

• Multi-value: cho phép chọn nhiều giá trị cùng lúc; Grafana tự chèn dạng regex (a|b|c) — kết hợp với =~ trong PromQL: {instance=~"$instance"}.
• "All" option: thêm mục "All" để chọn tất cả trong một cú bấm.
• Trong tiêu đề: đặt $var vào title panel, vd "CPU của $instance" — tiêu đề đổi theo lựa chọn.
• Chained variables: biến này lọc theo biến kia. Ví dụ $namespace chọn trước, rồi $pod chỉ liệt kê pod trong namespace đó: label_values(kube_pod_info{namespace="$namespace"}, pod).

Annotations là những dấu mốc dọc trên đồ thị, đánh dấu sự kiện đã xảy ra tại một thời điểm — giúp tương quan "biểu đồ nhảy vọt vì cái gì". Ví dụ: một lần deploy, một sự cố, hay một alert được kích hoạt.

• Thủ công: Ctrl/Cmd + click lên đồ thị để thêm ghi chú kèm mô tả & tag.
• Từ query: annotation tự động sinh từ một data source (vd bảng deploys trong SQL, hoặc sự kiện từ Loki) — mỗi hàng thành một mốc.
• Từ alert: Grafana có thể tự chấm annotation mỗi khi một alert rule chuyển trạng thái.

Links giúp điều hướng: Dashboard links (nút ở đầu dashboard trỏ sang dashboard/URL liên quan) và Panel/Data links (bấm vào một điểm dữ liệu để nhảy sang dashboard chi tiết, mang theo giá trị biến & time range — nền tảng của "drill-down").

Mỗi dashboard thực chất là một tài liệu JSON. Đây là "source of truth" — mọi panel, query, biến, layout đều nằm trong đó. Bạn xem/sửa nó ở Settings → JSON Model.

// trích lược một dashboard JSON
{
  "title": "API Overview",
  "uid": "api-overview",
  "schemaVersion": 39,
  "templating": { "list": [ { "name": "instance" } ] },
  "panels": [
    {
      "id": 1,
      "type": "timeseries",
      "title": "Request rate",
      "gridPos": { "x": 0, "y": 0, "w": 12, "h": 8 },
      "targets": [ { "refId": "A", "expr": "rate(http_requests_total[5m])" } ]
    }
  ]
}

Các điểm cần biết khi làm việc với JSON model: