Настройка источника данных Tempo
Источник данных Tempo подключает Grafana к вашей базе данных Tempo и позволяет настраивать функции и интеграции с другими телеметрическими сигналами.
Вы можете настроить источник данных либо через интерфейс источников данных в Grafana, либо с помощью файла конфигурации. На этой странице объясняется, как подключить Grafana к Tempo, настроить аутентификацию и включить потоковую передачу. О функциях корреляции трассировок, провижининге и других настройках см. связанные подстраницы.
В зависимости от вашей среды трассировки у вас может быть более одного экземпляра Tempo. Grafana поддерживает несколько источников данных Tempo.
Перед началом
Чтобы настроить источник данных Tempo, вам нужно:
- Права администратора на ваш экземпляр Grafana.
- Экземпляр Tempo, настроенный на отправку данных трассировки в Grafana.
- Приложение или служба, инструментированные для выдачи трассировок. Если вы ещё не настроили это, обратитесь к разделу Инструментирование для трассировки.
Если вы провижините источник данных Tempo, вам также нужны административные права на сервере, на котором размещён ваш экземпляр Grafana. Инструкции по провижинингу см. в разделе Провижининг источника данных Tempo.
Note
Вы не можете изменить провижиненный источник данных из интерфейса Grafana. Форма настроек доступна только для чтения, а кнопка Save & test заменяется на Test (вы можете проверить подключение, но не сохранить изменения).
Чтобы внести изменения, вы можете либо:
- Клонировать источник данных: создайте новый источник данных того же типа и скопируйте настройки из провижиненного источника данных. См. Клонирование провижиненного источника данных для Grafana Cloud.
- Обновить файл провижининга: отредактируйте файл конфигурации YAML. См. Провижининг источника данных Tempo.
Добавление или изменение источника данных
Вы можете использовать эти процедуры, чтобы настроить новый источник данных Tempo или изменить существующий.
Добавление нового источника данных
Выполните следующие шаги, чтобы настроить новый источник данных Tempo:
-
Выберите Connections в главном меню.
-
Введите
Tempoв строке поиска. -
Выберите Tempo.
-
Выберите Add new data source в правом верхнем углу страницы.
-
На вкладке Settings заполните разделы Name, Connection и Authentication.
- Используйте поле Name, чтобы указать имя, используемое для источника данных на панелях, в запросах и Explore. Переключите переключатель Default, чтобы источник данных был предварительно выбран для новых панелей.
- В разделе Connection введите URL экземпляра Tempo. Примеры формата URL см. в разделе Подключение.
- Заполните раздел Authentication.
-
Необязательно: настройте другие разделы, чтобы добавить возможности к вашим данным трассировки. О доступных параметрах см. разделы Настройка корреляций трассировок и Другие настройки.
-
Выберите Save & test.
Это видео объясняет, как добавлять источники данных, включая Loki, Tempo и Mimir, в Grafana и Grafana Cloud. Настройка источника данных Tempo начинается на 4:58 в видео.
Обновление существующего источника данных
Чтобы изменить существующий источник данных Tempo:
- Выберите Connections в главном меню.
- Выберите Data sources, чтобы просмотреть список настроенных источников данных.
- Выберите источник данных Tempo, который хотите изменить.
- Настройте или обновите дополнительные разделы, чтобы добавить возможности к вашим данным трассировки.
- После завершения обновлений выберите Save & test.
Подключение
Формат URL зависит от вашей среды:
Порт по умолчанию зависит от протокола: 3200 для HTTP, 9095 для gRPC.
Note
Grafana Cloud включает Grafana Cloud Traces, предварительно настроенный источник данных трассировки на базе Tempo. Добавляйте источник данных Tempo вручную, когда вам нужно подключиться к самостоятельно размещённому экземпляру Tempo или требуется пользовательская конфигурация сверх того, что предоставляет Grafana Cloud Traces.
URL в этой таблице предназначены для запросов трассировок из Grafana. Чтобы настроить, как ваши приложения отправляют трассировки в Tempo (конечные точки OTLP), обратитесь к разделу Настройка трассировки для Grafana Cloud или Инструментирование для трассировки для самостоятельно размещённого Tempo.
Аутентификация
Используйте этот раздел, чтобы выбрать метод аутентификации для доступа к источнику данных.
Note
Используйте Transport Layer Security (TLS) для дополнительного уровня безопасности при работе с Tempo. Дополнительную информацию о настройке шифрования TLS с Tempo см. в разделах Настройка связи TLS и Конфигурация Tempo.
[ru] DOCS_SHARED: "docs/grafana/latest/datasources/tempo/configure-tempo-data-source/_index.ru.md" ("/hugo/content/docs/grafana/latest/datasources/tempo/configure-tempo-data-source/_index.ru.md:117:1") shared directory "docs/grafana/latest/shared" not found
Подключение к Grafana Cloud Traces: выберите Basic authentication. Используйте ID экземпляра вашего стека Grafana Cloud (показанный в URL источника данных Tempo на Cloud Portal) в качестве User и токен Cloud Access Policy с областью действия traces:read в качестве Password. Не используйте учётные данные для входа в Grafana.
Самостоятельно размещённый Tempo: если Tempo настроен без аутентификации, выберите No authentication. Если ваш экземпляр Tempo использует базовую аутентификацию, введите учётные данные, настроенные в блоке server Tempo или обратном прокси.
Мультиарендность
Если вы используете мультиарендное развёртывание Tempo, вам нужно отправлять ID арендатора с каждым запросом, чтобы Tempo маршрутизировал запросы к правильному арендатору.
Чтобы настроить мультиарендность:
- В настройках источника данных Tempo прокрутите до раздела Authentication.
- Разверните подраздел HTTP Headers.
- Добавьте заголовок с именем
X-Scope-OrgIDи значением, установленным в ID вашего арендатора.
Этот заголовок задаётся в источнике данных Grafana для запросов. Тот же заголовок также должен быть задан на пути записи (в конфигурации вашего Alloy или OpenTelemetry Collector), чтобы маршрутизировать данные трассировки к правильному арендатору при приёме.
Дополнительную информацию см. в документации о мультиарендности Tempo.
Потоковая передача
Потоковая передача позволяет отображать результаты запросов TraceQL по мере их появления. Без потоковой передачи никакие результаты не отображаются, пока не вернутся все результаты.
Чтобы использовать потоковую передачу, вам нужно:
-
Запускать Tempo версии 2.2 или более поздней, или Grafana Enterprise Traces (GET) версии 2.2 или более поздней, или использовать Grafana Cloud Traces.
-
Grafana Cloud Traces: потоковая передача поддерживается изначально. Дополнительная конфигурация инфраструктуры не требуется.
-
Самостоятельно размещённый Tempo или GET: в конфигурации Tempo должно быть
stream_over_http_enabled: true, чтобы потоковая передача работала. Если ваш экземпляр Tempo или GET находится за балансировщиком нагрузки или прокси, который не поддерживает gRPC или HTTP2, потоковая передача может не работать, и её следует деактивировать.Дополнительную информацию см. в разделе gRPC API Tempo.
Активация потоковой передачи
Потоковая передача доступна в Grafana и Grafana Cloud. Раздел Streaming имеет два переключателя:
- Search queries: передаёт результаты поиска TraceQL по мере их поступления.
- Metrics queries: передаёт результаты запросов метрик TraceQL по мере их поступления.
Включите один или оба в зависимости от того, какие типы запросов вы используете.
Когда потоковая передача активна, она отображается как Enabled в Explore. Чтобы проверить статус, выберите Explore в меню, выберите ваш источник данных Tempo и разверните раздел Options.
Устранение неполадок потоковой передачи
Если потоковая передача не работает, см. Проблемы с потоковой передачей в руководстве по устранению неполадок.
Связывание трассировок с другими сигналами
Grafana предоставляет несколько способов связать трассировки с другими телеметрическими сигналами. Следующая диаграмма показывает доступные механизмы корреляции, направление каждого и место настройки каждого.
Страница настроек источника данных Tempo включает три раздела для связывания от промежутков к другим сигналам. Каждый соответствует разделу в форме настроек:
- Trace to logs: переходите от промежутков к связанным журналам в Loki или другом источнике данных журналов.
- Trace to metrics: связывайте промежутки с запросами метрик в Prometheus или других источниках данных метрик.
- Trace to profiles: связывайте промежутки с данными профилирования в Grafana Pyroscope со встроенными графами пламени.
Для более гибких корреляций на основе правил, которые могут нацеливаться на любой источник данных или внешний URL, используйте Grafana Корреляции трассировок. Корреляции трассировок настраиваются в разделе Configuration > Correlations, а не в настройках источника данных Tempo.
Чтобы связать от журналов или метрик к трассировкам (обратное направление), обратитесь к:
- Производные поля в источнике данных Loki (для журналов к трассировкам). Страница trace to logs также охватывает эту настройку.
- Экземпляры (Exemplars) в источнике данных Prometheus (для метрик к трассировкам).
Другие настройки
- Дополнительные настройки: настройте граф служб, граф узлов, поиск, запрос TraceID, панель промежутков и другие настройки.
- Провижининг источника данных Tempo: настройте источник данных Tempo с помощью файла YAML и клонируйте провижиненные источники данных.
Пользовательские переменные запросов
Чтобы использовать переменную в конфигурации trace to logs, metrics или profiles, вам нужно обернуть её в ${}.
Например, ${__span.name}.