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

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

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

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

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

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

Симптомы:

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

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

«request failed: 404 Not Found»

Симптомы:

• Save & test возвращает ошибку 404
• Запросы завершаются сообщениями «request failed»

Решения:

1. Убедитесь, что URL Jaeger не содержит завершающего пути, такого как /api. Правильный URL — это базовый адрес, например http://localhost:16686.
2. Убедитесь, что служба запросов Jaeger запущена и прослушивает ожидаемый порт.
3. Если используется обратный прокси, убедитесь, что прокси перенаправляет запросы на корректную конечную точку Jaeger.

Ошибки TLS

Симптомы:

• Ошибки проверки сертификата во время Save & test
• Ошибки с упоминанием x509 или проверки сертификата

Решения:

1. Убедитесь, что ваши сертификаты TLS действительны и не истекли.
2. Если используется приватный CA, убедитесь, что сертификат CA настроен в Additional settings источника данных.
3. Для тестирования вы можете временно включить Skip TLS verify в настройках источника данных. Не используйте это в продакшене.
4. Убедитесь, что параметр Server name соответствует Common Name или Subject Alternative Name сертификата.

Ошибки тайм-аута

Симптомы:

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

Решения:

1. Увеличьте значение тайм-аута в Additional settings > Timeout.
2. Убедитесь, что сетевая задержка между Grafana и Jaeger приемлема.
3. Проверьте, что служба запросов Jaeger не перегружена.

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

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

«401 Unauthorized» или «403 Forbidden»

Симптомы:

• Save & test завершается с ошибками авторизации
• Запросы возвращают сообщения об отказе в доступе
• Сервисы и операции не загружаются в раскрывающихся списках

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

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

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

«traceID is empty»

Симптомы:

• Запрос завершается с ошибкой «traceID is empty» при использовании типа запроса TraceID

Решения:

1. Введите действительный идентификатор трассировки в поле Trace ID.
2. Убедитесь, что идентификатор трассировки является корректной шестнадцатеричной строкой.
3. Если используется переменная шаблона, убедитесь, что переменная имеет непустое значение.

Нет данных в результатах поиска

Симптомы:

• Запрос поиска не возвращает трассировок
• Список трассировок пуст

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

«The JSON file uploaded is not in a valid Jaeger format»

Симптомы:

• Импорт файла трассировки завершается ошибкой формата

Решения:

1. Убедитесь, что файл JSON соответствует формату трассировки Jaeger с массивом data на верхнем уровне.
2. Убедитесь, что файл содержит хотя бы один объект трассировки в массиве data.
3. Проверьте синтаксис JSON с помощью линтера JSON.

Ожидаемый формат:

JSON Copy

{
  "data": [
    {
      "traceID": "<TRACE_ID>",
      "spans": [...],
      "processes": {...}
    }
  ]
}

Ошибки графа зависимостей

Эти ошибки связаны с типом запроса dependency graph.

Пустой граф зависимостей

Симптомы:

• Запрос графа зависимостей не возвращает узлов или рёбер
• Панель Node Graph пуста

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

Ошибки конечной точки gRPC

Эти ошибки возникают при использовании конечной точки запросов gRPC.

Запросы gRPC завершаются ошибкой

Симптомы:

• Запросы не используют конечную точку gRPC
• Запросы поиска, сервисов и операций по-прежнему используют REST API

Решения:

1. Убедитесь, что флаг функции jaegerEnableGrpcEndpoint включён в Grafana. Эта функция является экспериментальной.
2. Клиентам Grafana Cloud следует обратиться в службу поддержки, чтобы запросить доступ.
3. Обратите внимание, что запросы поиска и графа зависимостей в настоящее время используют конечную точку REST даже при включённом флаге функции. Только поиск сервисов, поиск операций и запросы по идентификатору трассировки используют gRPC.

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

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

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

   ini Copy

   [log]
   level = debug

2. Воспроизведите проблему.

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

4. Ищите записи, относящиеся к Jaeger, которые содержат URL запросов, коды состояния ответов и сведения об ошибках.

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

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

Если вы испробовали решения в этом документе и всё ещё сталкиваетесь с проблемами:

1. Проверьте форумы сообщества Grafana на предмет похожих проблем.
2. Просмотрите проблемы на GitHub Grafana на предмет известных ошибок, связанных с источником данных Jaeger.
3. Обратитесь к документации Jaeger за рекомендациями по конкретным сервисам.
4. Свяжитесь со службой поддержки Grafana, если вы являетесь пользователем Enterprise, Cloud Pro или Cloud Advanced.
5. При сообщении о проблемах укажите:
   • Версию Grafana
   • Версию Jaeger
   • Сообщения об ошибках (отредактируйте конфиденциальную информацию)
   • Шаги воспроизведения
   • Соответствующую конфигурацию источника данных (отредактируйте учётные данные)