Если коллеги видят один график со сдвигом на несколько часов, сначала не правьте SQL. Grafana может использовать Browser time, а значит каждый viewer получает зону своего устройства. Зафиксируйте абсолютные from/to и покажите один и тот же timestamp в Query inspector — так станет видно, изменились данные или только отображение.
Устойчивое решение начинается с договорённости: дежурные dashboards обычно фиксируют в UTC или зоне сервиса, а персональная аналитика может следовать браузеру. Смешивать эти режимы на соседних панелях нельзя без явной подписи.
Сдвиг сам подсказывает слой
| Симптом | Чаще всего | Контроль |
|---|---|---|
| Разница равна зонам устройств | Dashboard = Browser time | Открыть Settings → Time options |
| Сдвинута только SQL-панель | Конвертация в query или driver | Сравнить raw timestamp |
| График верен, annotation сдвинута | Источник annotation использует другую zone | Inspect обоих запросов |
| Ошибка появляется около DST | Локальное wall time без offset | Проверить IANA zone и instant |
| Scheduled report отличается от UI | Renderer работает в другой zone | Зафиксировать dashboard zone |
Паспорт делает спор воспроизводимым
range_from_utc: 2026-10-03T08:00:00Z
range_to_utc: 2026-10-03T09:00:00Z
browser_zone: Europe/Moscow
profile_zone: default
dashboard_zone: browser
sample_epoch_ms: 1791016200000Значения условные и служат формой протокола, а не результатом измерения. Для реального инцидента сохраните dashboard UID/version, Grafana version, viewer profile zone и один epoch из ответа. Персональные данные пользователя в протокол не включают.
У Grafana есть несколько источников timezone
В настройках dashboard доступны Default, Browser time, UTC и стандартные IANA zones. При Default Grafana учитывает настройки user profile, team и organization; если они не заданы, используется локальное время браузера. Поэтому одинаковая ссылка не гарантирует одинаковые подписи оси у двух пользователей.
Переменная $__timezone возвращает выбранную зону dashboard: utc или IANA-имя, а при Browser time Grafana пытается определить зону браузера. Используйте её для диагностики и явных запросов только там, где data source действительно требует имя зоны.
Query inspector отделяет данные от картинки
- Открыть Query inspector для конкретной panel.
- Сохранить raw request, from, to и datasource UID.
- Посмотреть raw response до transformations.
- Сравнить epoch/offset с подписью на оси.
- Повторить на втором viewer без изменения диапазона.
- Проверить panel time override и transformations.
Если raw epochs совпадают, а подписи различаются, источник отдаёт один и тот же instant — проблема в отображении. Если уже raw rows различаются, ищите timezone conversion в SQL, datasource macro, session timezone базы или template variable.
UTC instant и local wall time нельзя хранить одинаково
Событие должно нести однозначный instant: Unix epoch либо ISO 8601 с Z/offset. Строка 2026-10-03 12:00:00 без offset двусмысленна. Если бизнес-смысл зависит от местного расписания, храните отдельно IANA zone, потому что фиксированный +03:00 не описывает исторические и будущие переходы правил.
Исправление выбирают по назначению dashboard
Для общего NOC-экрана установите UTC или зону наблюдаемого сервиса и добавьте её в заголовок. Для персонального dashboard оставьте Browser time, но явно показывайте zone в ссылках и экспортируемых данных. Не делайте двойную конвертацию: если driver уже вернул UTC instant, SQL не должен повторно считать его локальным.
- Зафиксировать dashboard timezone через review.
- Проверить profile/team/org defaults.
- Убрать лишнюю конвертацию в одном data source.
- Сравнить один epoch в UI и Query inspector.
- Проверить дату около DST для используемой IANA zone.
- Открыть dashboard в двух браузерных zones.
- Сверить scheduled report с тем же абсолютным range.
Что нужно для разбора временного сдвига
Нужны Grafana version, dashboard JSON без secrets, выбранные zones, абсолютные from/to, raw request/response одной panel и тип timestamp в источнике. Screenshots без диапазона и зоны почти бесполезны.