Документацияbreadcrumb arrow Grafanabreadcrumb arrow Документация GlaberGraphbreadcrumb arrow Источники данныхbreadcrumb arrow General troubleshooting
Последнее обновление: марта 10, 2026

Устранение общих неполадок источников данных

Эта страница содержит решения распространённых проблем, которые применимы к источникам данных в Grafana в целом. Об устранении неполадок, специфичных для конкретного источника данных, см. страницу устранения неполадок в документации каждого источника данных.

Ошибки подключения

Эти ошибки возникают, когда Grafana не может достичь бэкенда источника данных.

«Connection refused» или ошибки тайм-аута

Симптомы:

  • Save & test завершается неудачно с ошибкой подключения или тайм-аутом
  • Панели показывают «error» или не загружают данные
  • Периодические проблемы со связностью

Возможные причины и решения:

Причина Решение
Неверный URL Убедитесь, что URL источника данных верен, включая протокол (http:// или https://) и номер порта.
Правила сети или брандмауэра Убедитесь, что сервер Grafana может достичь конечной точки источника данных. Проверьте, что правила брандмауэра разрешают исходящий трафик на требуемом порту.
Источник данных не работает Убедитесь, что служба источника данных запущена и принимает подключения.
Сбой разрешения DNS Подтвердите, что имя хоста правильно разрешается с сервера Grafana.
Доступ к приватной сети Если источник данных находится в приватной сети и вы используете Grafana Cloud, настройте Private data source connect.

Ошибки TLS/SSL

Симптомы:

  • Ошибки, упоминающие «certificate», «TLS handshake» или «x509»
  • Save & test завершается неудачно с сообщениями, связанными с SSL

Решения:

  1. Убедитесь, что источник данных использует действительный TLS-сертификат.
  2. Если вы используете самоподписанный сертификат, включите Skip TLS Verify в конфигурации источника данных (не рекомендуется для продакшена) или добавьте сертификат CA в список доверенных сертификатов в Grafana.
  3. Убедитесь, что срок действия сертификата не истёк.
  4. Подтвердите, что Common Name или Subject Alternative Name сертификата соответствует имени хоста в URL источника данных.

Ошибки аутентификации

Эти ошибки возникают, когда учётные данные недействительны, отсутствуют или не имеют требуемых разрешений.

«Unauthorized» или «Access denied»

Симптомы:

  • Save & test завершается неудачно с 401 Unauthorized или 403 Forbidden
  • Запросы возвращают сообщения об отказе в доступе
  • Раскрывающиеся меню не заполняются

Возможные причины и решения:

Причина Решение
Недействительные учётные данные Перепроверьте имя пользователя, пароль, API-ключ или токен. При необходимости создайте учётные данные заново.
Истёкшие учётные данные Создайте новые учётные данные и обновите конфигурацию источника данных.
Недостаточные разрешения Убедитесь, что у учётной записи или API-ключа есть разрешения, требуемые источником данных. Обязательные разрешения см. в документации конкретного источника данных.
Неверный метод аутентификации Убедитесь, что вы выбрали правильный тип аутентификации для вашей настройки.

Ошибки запросов

Эти ошибки возникают при выполнении запросов к правильно подключённому источнику данных.

«No data» или пустые результаты

Симптомы:

  • Запросы выполняются без ошибок, но не возвращают данные
  • Панели показывают «No data»
  • Графики пусты

Возможные причины и решения:

Причина Решение
Диапазон времени не содержит данных Расширьте диапазон времени на дашборде или проверьте, что данные существуют в источнике данных за выбранный период.
Неверный запрос Проверьте синтаксис запроса. Используйте редактор запросов источника данных, чтобы построить или проверить запрос.
Выбран неверный источник данных Убедитесь, что вы выбрали правильный источник данных на панели или в Explore.
Проблема с разрешениями Убедитесь, что у учётных данных есть доступ на чтение к конкретному запрашиваемому ресурсу или индексу.

Тайм-аут запроса

Симптомы:

  • Запросы выполняются долго, а затем завершаются неудачно
  • Сообщения об ошибках упоминают тайм-аут или лимиты запросов

Решения:

  1. Сузьте диапазон времени дашборда, чтобы уменьшить объём данных.
  2. Добавьте фильтры в запрос, чтобы уменьшить набор результатов.
  3. Разбейте сложные запросы на меньшие части.
  4. Увеличьте настройку тайм-аута источника данных, если вашему источнику данных действительно нужно больше времени.

Ошибки конфигурации источника данных

«Save & test» завершается неудачно после провижининга

Симптомы:

  • Провижиненные источники данных не проходят проверку подключения
  • Ошибки появляются после развёртывания файлов YAML провижининга

Решения:

  1. Убедитесь, что синтаксис YAML провижининга верен. Ожидаемый формат см. в разделе Провижининг источников данных.
  2. Убедитесь, что значения secureJsonData (такие как пароли, API-ключи и токены) заданы правильно. Эти значения нельзя прочитать обратно после сохранения.
  3. Проверьте, что файл провижининга находится в правильном каталоге и что у Grafana есть доступ на чтение.
  4. Перезапустите Grafana после внесения изменений в файлы провижининга.

Источник данных исчезает или сбрасывается

Симптомы:

  • Изменения источника данных откатываются после перезапуска Grafana
  • Конфигурацию источника данных не удаётся сохранить через интерфейс

Решения:

  1. Провижиненные источники данных нельзя редактировать через интерфейс. Вносите изменения в файл YAML провижининга вместо этого.
  2. Убедитесь, что никакой другой файл провижининга не перезаписывает конфигурацию вашего источника данных.

Включение журналирования отладочного уровня

Чтобы получить подробную информацию об ошибках для устранения неполадок:

  1. Установите уровень журнала Grafana в debug в файле конфигурации:

    ini 
    [log]
level = debug

  2. Перезапустите Grafana, чтобы изменение вступило в силу.

  3. Воспроизведите проблему и просмотрите журналы в /var/log/grafana/grafana.log (или в настроенном вами расположении журналов).

  4. Найдите записи, связанные с вашим источником данных, которые содержат сведения о запросах и ответах.

  5. Сбросьте уровень журнала на info после устранения неполадок, чтобы избежать чрезмерного объёма журналов.

Получение дополнительной помощи

Если решения на этой странице не устраняют вашу проблему:

  1. Проверьте страницу устранения неполадок для вашего конкретного источника данных.
  2. Поищите на форумах сообщества Grafana похожие проблемы.
  3. Просмотрите проблемы Grafana на GitHub на предмет известных ошибок.
  4. Свяжитесь с поддержкой Grafana, если вы пользователь Grafana Enterprise, Cloud Pro или Cloud Advanced.

При сообщении о проблемах указывайте:

  • Версию Grafana и версию плагина источника данных
  • Точные сообщения об ошибках (удалите конфиденциальную информацию)
  • Шаги для воспроизведения проблемы
  • Соответствующую конфигурацию (удалите учётные данные)