Документация Grafana Документация GlaberGraph Источники данных OpenTSDB Устранение неполадок

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

В этом документе приведены решения распространённых проблем, с которыми вы можете столкнуться при настройке или использовании источника данных OpenTSDB. Инструкции по настройке см. в разделе Настройка источника данных OpenTSDB.

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

Эти ошибки возникают, когда Grafana не может подключиться к серверу OpenTSDB.

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

Симптомы:

• Save & test завершается ошибкой
• Запросы возвращают ошибки подключения
• Периодические тайм-ауты

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

Чтобы проверить связность вручную, выполните:

sh Copy

curl http://<OPENTSDB_HOST>:4242/api/version

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

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

«401 Unauthorized» или «403 Forbidden»

Симптомы:

• Save & test завершается ошибкой аутентификации
• Запросы возвращают ошибки авторизации

Решения:

1. Убедитесь, что учётные данные базовой аутентификации верны в конфигурации источника данных.
2. Проверьте, что сервер OpenTSDB настроен на приём указанных учётных данных.
3. Если для аутентификации используются cookie, убедитесь, что нужные cookie перечислены в Allowed cookies.

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

Эти ошибки возникают при выполнении запросов к OpenTSDB.

Данные не возвращаются

Симптомы:

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

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

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

Симптомы:

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

Решения:

1. Уменьшите диапазон времени запроса.
2. Добавьте более конкретные фильтры тегов, чтобы уменьшить объём данных.
3. Увеличьте настройку Timeout в конфигурации источника данных.
4. Включите прореживание (downsampling), чтобы уменьшить количество возвращаемых точек данных.
5. Проверьте производительность сервера OpenTSDB и состояние HBase.

Автодополнение не работает

Симптомы:

• При вводе имён метрик, имён тегов или значений тегов не появляются подсказки
• Раскрывающиеся списки пусты

Решения:

1. Убедитесь, что конечная точка OpenTSDB /api/suggest доступна. Проверьте её вручную с помощью curl http://<OPENTSDB_HOST>:4242/api/suggest?type=metrics.
2. Увеличьте настройку Lookup limit, если у вас много метрик или тегов.
3. Проверьте, что подключение источника данных работает, нажав Save & test.
4. Проверьте, что метрики существуют в OpenTSDB. API suggest возвращает только те метрики, которые были записаны в базу данных.

Переменные шаблонов не заполняются

Симптомы:

• Раскрывающиеся списки переменных шаблонов пусты
• Preview of values не показывает результатов

Решения:

1. Включите отслеживание метаданных в реальном времени в OpenTSDB, установив tsd.core.meta.enable_realtime_ts в true в вашей конфигурации OpenTSDB.
2. Синхронизируйте существующие метаданные, выполнив tsdb uid metasync на сервере OpenTSDB.
3. Убедитесь, что синтаксис запроса переменной верен. Обратитесь к разделу Переменные шаблонов за правильным синтаксисом.
4. Проверьте, что подключение источника данных работает.

Проблемы производительности

Эти проблемы связаны с медленными запросами или высоким потреблением ресурсов.

Медленные запросы

Симптомы:

• Дашборды загружаются долго
• Запросы медленные даже для небольших диапазонов времени

Решения:

1. Включите прореживание (downsampling) в редакторе запросов, чтобы уменьшить объём данных.
2. Используйте более конкретные фильтры тегов, чтобы ограничить количество возвращаемых временных рядов.
3. Уменьшите диапазон времени.
4. Проверьте метрики производительности OpenTSDB и HBase.
5. Рассмотрите увеличение размера кучи (heap) OpenTSDB, если память ограничена.

Проблемы производительности HBase

OpenTSDB использует HBase для хранения данных. Проблемы производительности в HBase напрямую влияют на производительность запросов OpenTSDB.

Решения:

1. Следите за состоянием региона-серверов HBase и статусом компакции.
2. Убедитесь, что региона-серверам HBase выделено достаточно памяти кучи.
3. Проверьте наличие горячих точек (hot spots) регионов и при необходимости перераспределите регионы.
4. Обратитесь к руководству по устранению неполадок OpenTSDB для проблем, специфичных для HBase.

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

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

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

   ini Copy

   [log]
   level = debug

2. Просмотрите журналы в /var/log/grafana/grafana.log (или в настроенном вами расположении журналов).

3. Найдите записи, специфичные для OpenTSDB, которые содержат сведения о запросах и ответах.

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

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

Если вы испробовали решения из этого документа, но проблемы сохраняются:

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

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

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