Панели и источники данных не подхватываются при запуске
Описания источников данных и панелей читаются при запуске из отдельного каталога. Служба при ошибке в них либо не запускается вовсе, либо запускается без части описаний — и разница между этими случаями зависит от вида ошибки.
Вероятные причины
По порядку: сверху то, что встречается чаще.
-
Каталог описаний недоступен пользователю службы
Служба работает от своего пользователя. Без права чтения описания не применяются.
-
Ошибка в описании останавливает запуск
Неверная структура описания приводит к отказу при запуске, а не к пропуску одного файла.
-
Описания конфликтуют с созданными вручную
Описания применяются при каждом запуске и перекрывают изменения, сделанные через интерфейс.
Диагностика
Команды идут в том порядке, в котором их стоит выполнять: каждая следующая проверяет то, что осталось после предыдущей.
Что служба сделала с описаниями при запуске.
journalctl -u grafana-server -n 40 --no-pager | grep -iE "provisioning|datasource"Каталог описаний, его содержимое и права.
sudo ls -lR /etc/grafana/provisioning/ | head -20Пользователь и изоляция службы.
systemctl show grafana-server -p User -p ProtectSystem -p ReadWritePathsРешение
Решение своё для каждой причины. Сначала определите, какая из них ваша, — иначе правки наложатся друг на друга.
- Почему происходит
- Служба работает от своего пользователя. Без права чтения описания не применяются.
- Как проверить
-
Посмотрите права каталога и пользователя службы.
sudo ls -lR /etc/grafana/provisioning/ 2>/dev/null | head -15 systemctl show grafana-server -p User 2>/dev/null
- Как исправить
- Дайте пользователю службы право чтения каталога описаний. Права на запись ему не нужны: описания он только читает.
- Почему происходит
- Неверная структура описания приводит к отказу при запуске, а не к пропуску одного файла.
- Как проверить
-
Посмотрите сообщение при запуске.
journalctl -u grafana-server -n 30 --no-pager | grep -iE "provisioning|failed"
- Как исправить
- Исправьте описание по сообщению. Проверять описания стоит на тестовой машине: ошибка в них означает недоступную панель наблюдения.
- Почему происходит
- Описания применяются при каждом запуске и перекрывают изменения, сделанные через интерфейс.
- Как проверить
-
Посмотрите, что задано описаниями.
sudo ls /etc/grafana/provisioning/datasources/ /etc/grafana/provisioning/dashboards/ 2>/dev/null
- Как исправить
- Выберите один способ управления: описаниями или через интерфейс. Смешение приводит к потере правок при каждом перезапуске.
Пример вывода
Описание источника данных с ошибкой останавливает запуск. Пример показательный: он собран на тестовой машине специально для этой страницы, а не взят из чужого журнала.
grafana[12200]: logger=provisioning t=2026-09-15T19:40:02 level=error msg="Failed to provision data sources" error="Datasource provisioning error: invalid type \"prometheous\""
systemd[1]: grafana-server.service: Main process exited, code=exited, status=1/FAILURE
Связанные ошибки
- Grafana: расширение не загружается из-за подписи Расширение не появляется в интерфейсе: не подписано или подпись не совпадает. Как разрешить осознанно.
- Prometheus не собирает метрики: цель недоступна Цель в состоянии down: служба не слушает нужный адрес, закрыт порт или обрывается по таймауту сбора.
- Permission denied в журнале службы Отказ в доступе у службы systemd: права на файл, каталоги по пути, пользователь службы, параметры изоляции, SELinux и AppArmor.
- Configuration file is marked executable Предупреждение о правах: unit-файл помечен исполняемым. Откуда берётся и почему это стоит исправить.
- Configuration file is marked world-inaccessible Предупреждение о правах на unit-файл: служба работает, но файл недоступен для чтения другим.
- Агент наблюдения не может прочитать нужные данные Проверки возвращают отказ доступа: агент работает от непривилегированного пользователя и ограничен изоляцией.
- Apache: Invalid command — не включён модуль Apache не запускается: директива требует модуль, который не подключён. Как найти нужный модуль и включить.
- Apache: правила .htaccess не действуют Файл .htaccess игнорируется: запрещён параметром AllowOverride, нет нужного модуля, файл не читается.
Где встречается чаще всего
Источники
- Документация Grafana: описания ресурсов
-
Воспроизведено на тестовой машине, systemd 255 (Ubuntu 24.04)
Воспроизведено описанием источника данных с неверным типом.