Stat и Gauge

Тема дорожной карты · Grafana

Панель Stat отображает одно агрегированное значение — например, последнее, среднее или сумму результата запроса — крупным текстом, что идеально подходит для KPI-дашбордов, где оператор должен увидеть ключевое число с первого взгляда. Grafana позволяет настраивать пороговые цвета на панели Stat так, что фон или текст меняет цвет (зелёный, жёлтый, красный) при пересечении заданных границ, обеспечивая мгновенную визуальную обратную связь без необходимости точного считывания числа. Панель Gauge отображает те же однозначные данные в виде полукруглой дуги, где стрелка или заливка указывает, где значение находится между настраиваемым минимумом и максимумом — удобно для метрик вроде процента занятого дискового пространства или заполненности очереди. Обе панели — Stat и Gauge — поддерживают мини-графики: небольшой временной ряд, отрисованный внутри панели, показывает тренд за отображаемым значением. В редакторе панели Grafana раздел Value options управляет тем, какое вычисление (last, mean, max и т.д.) применяется к результату запроса перед отображением, а поле Unit форматирует число с подходящим суффиксом — bytes, ms или %.

Как это работает

Stat и Gauge: типы панелей — Time series (дефолт), Bar chart, Pie, Heatmap, Stat, Gauge, Table, Logs, Trace view, Geomap, Node graph. У каждого свои опции: legend, axes, thresholds, color schemes, value mappings. Field overrides применяют конкретные опции к конкретным series (например "сделать error-series красной"). Transformations обрабатывают результаты запросов до визуализации. Repeat panel/row по переменной — генерация N панелей из одного определения.

Когда применять

Time series — для любой over-time метрики; рабочая лошадка. Stat или Gauge — для заметного "текущего значения". Table — для структурированных сравнений по измерениям. Heatmap — для распределений (latency over time). Избегайте Pie charts в дашбордах — плохо читаются на маленьких размерах.

Типичные ошибки

Ловушки Stat и Gauge: legend с 50+ series (нечитаемо — фильтруйте, агрегируйте или Top N); auto-scaling Y-оси прячет маленькие изменения (задавайте min/max); неверные thresholds для gauge (max gauge сильно выше реалистичного значения делает цвета бессмысленными).

Связанные понятия

Полезные ресурсы