Трассировки в Explore
Вы можете использовать Explore для запроса и визуализации трассировок из источников данных трассировки. Поддерживаемые источники данных включают:
Ниже приведены некоторые материалы, которые помогут узнать больше о трассировках и о том, как их использовать:
- Введение в трассировку
- Структура трассировки
- Трассировки и телеметрия
- Использование трассировок для поиска решений проблем
Редакторы запросов
Вы можете создавать запросы и искать данные трассировки с помощью редактора запросов источника данных. Обратите внимание, что источники данных в Grafana имеют уникальные редакторы запросов.
Информацию о том, как использовать редактор запросов для создания запросов к источникам данных трассировки, см. в документации по каждому отдельному источнику данных.
Представление трассировки
Представление трассировки даёт обзор запроса по мере его прохождения через вашу систему. В следующих разделах подробно описаны различные элементы представления трассировки.
Заголовок
Заголовок представления трассировки включает следующее:
- Header title — Показывает имя корневого интервала и идентификатор трассировки.
- Search — Подсвечивает интервалы, содержащие искомый текст.
- Metadata — Различные метаданные о трассировке.
Мини-карта
Minimap отображает сжатое представление временной шкалы трассировки. Проведите мышью по мини-карте, чтобы приблизить меньший диапазон времени. Это также обновляет основную временную шкалу, что упрощает просмотр коротких интервалов. При приближении наведение курсора на мини-карту отображает Reset selection, что сбрасывает масштаб.
Временная шкала
Временная шкала показывает список интервалов в пределах трассировки. Каждая строка интервала состоит из следующих компонентов:
- Expand children — Разворачивает или сворачивает все дочерние интервалы выбранного интервала.
- Service name — Имя службы, зарегистрировавшей интервал.
- Operation name — Имя операции, которую представляет этот интервал.
- Span duration bar — Визуальное представление продолжительности операции в пределах трассировки.
Нажмите в любом месте строки интервала, чтобы показать сведения об интервале.
Span duration bar выделяет критический путь трассировки более тёмным сегментом. Этот более тёмный сегмент означает, что интервал лежит на критическом пути трассировки, согласно алгоритму CRISP (Critical Path for Service Performance).
Используйте подсветку, чтобы сосредоточиться на интервалах, определяющих сквозную задержку. Интервалы вне критического пути не увеличивают продолжительность трассировки.
Вы также можете сосредоточиться на этом пути, нажав кнопку Show critical path only в параметрах Span filters.
Сведения об интервале
Трассировки состоят из одного или нескольких интервалов. Интервал — это единица работы в рамках трассировки, имеющая время начала относительно начала трассировки, продолжительность и имя операции для этой единицы работы. Обычно он содержит ссылку на родительский интервал, если только это не первый интервал — корневой интервал — в трассировке. Он часто включает атрибуты «ключ/значение», относящиеся к самому интервалу, например используемый в запросе метод HTTP, а также другие метаданные, такие как имя службы, события подынтервалов или ссылки на другие интервалы.
Вы можете развернуть любой интервал в трассировке и просмотреть сведения, включая атрибуты интервала и ресурса.
Дополнительную информацию об интервалах и трассировках см. в разделе Введение в трассировку в документации Tempo.
Сведения об интервале включают атрибуты интервала, атрибуты ресурса, события и ссылки.
Атрибуты интервала и ресурса
Span attributes — это пары «ключ-значение», предоставляющие метаданные о конкретном интервале. Они дают контекст выполняемой операции, например информацию о запросе, ответе или любые соответствующие операционные сведения. Например, если интервал связан с вызовом другой службы по HTTP, атрибут может включать URL HTTP (возможно, как ключ атрибута интервала http.url) и возвращённый код состояния HTTP (как атрибут интервала http.status_code).
Resource attributes — это пары «ключ-значение», описывающие среду или сущность, создающую трассировку. Они фиксируют статическую информацию об источнике трассировок, например имя приложения или версию службы.
Атрибуты интервала относятся к конкретной операции, тогда как атрибуты ресурса связаны со всей трассировкой или всей службой, создающей интервалы. Подробнее см. в разделе Атрибуты интервала и ресурса.
События
События — это записи, похожие на журнальные, привязанные к интервалу и представляющие происшествие во время его выполнения. Они фиксируют заметные моменты или происшествия в жизненном цикле интервала, такие как ошибки, предупреждения или контрольные точки. Если во время операции возникает ошибка, к интервалу можно добавить событие, указывающее, что пошло не так и когда. События включают временную метку, имя и атрибуты в виде пар «ключ-значение», предоставляющие дополнительный контекст или сведения о событии.
Ссылки
Ссылки показывают связи между интервалами, которые не находятся в прямом отношении «родитель-потомок». Они представляют ассоциации между интервалами, происходящими одновременно или в разных деревьях трассировок, связывая трассировки, возникшие из разных источников, но логически связанные, например обработка фоновой задачи, инициированная веб-запросом. Ссылки можно использовать, когда трассировка проходит через асинхронную очередь или при сопоставлении трассировок из разных служб.
Фильтры интервалов
Фильтры интервалов позволяют уточнить интервалы, отображаемые в средстве просмотра временной шкалы трассировки. Чем больше фильтров вы добавите, тем более конкретными становятся отфильтрованные интервалы. Нажмите на трассировку, чтобы получить доступ к фильтрам интервалов.
Вы можете добавить один или несколько из следующих фильтров:
- Service name — Фильтрация путём выбора имени службы в раскрывающемся списке.
- Span name — Фильтрация путём выбора имени интервала в раскрывающемся списке.
- Duration — Фильтрация по продолжительности. Принимаемые единицы включают ns, us, ms, s, m, h.
- Tags — Фильтрация по тегам, тегам процесса или полям журнала в вашем интервале.
Чтобы показать только совпавшие интервалы, переключите Show matches only.
Более подробную информацию см. в разделе Фильтры интервалов.
Переход от трассировки к журналам
Вы можете перейти от интервала в представлении трассировки непосредственно к журналам, относящимся к этому интервалу. Эта функция доступна для источников данных Tempo, Jaeger и Zipkin. Инструкции по настройке см. в документации по каждому отдельному источнику данных.
Нажмите значок документа, чтобы открыть разделённое представление в Explore с настроенным источником данных и запросить соответствующие журналы для интервала.
Переход от трассировки к метрикам
Вы можете перейти от интервала в представлении трассировки непосредственно к метрикам, относящимся к этому интервалу. Эта функция доступна для источников данных Tempo, Jaeger и Zipkin.
Инструкции по настройке см. в документации по каждому отдельному источнику данных. Для Tempo см. раздел Настройка перехода от трассировки к метрикам.
Переход от трассировки к профилям
Используя переход от трассировки к профилям, вы можете задействовать способность Grafana сопоставлять разные сигналы, добавив возможность связывать трассировки и профили.
Для Tempo инструкции по настройке см. в разделе Переход от трассировки к профилям.
Корреляции трассировок
Вы можете использовать корреляции для определения пользовательских ссылок, появляющихся в представлении трассировки на основе информации о трассировке и интервале.
Для Tempo инструкции по настройке см. в разделе Корреляции трассировок.
Граф узлов
Вы также можете развернуть граф узлов для отображаемой трассировки. Если источник данных это поддерживает, он отображает интервалы трассировки как узлы графа или предоставляет дополнительный контекст, например граф служб на основе текущей трассировки.
Дополнительную информацию см. в разделе Граф узлов.
Note
Для корректного отображения граф узлов требует, чтобы данные возвращались из источника данных в определённом формате. Дополнительную информацию и инструкции по настройке см. в разделах Data API, Структура фрейма данных узлов и Требования к данным графа узлов.
Граф служб
Граф служб визуализирует частоту запросов, частоту ошибок и длительности (RED), а также связи между службами. После настройки требований это предварительно настроенное представление становится сразу доступным.
Дополнительную информацию см. в следующей документации:
- Граф служб и представление графа служб
- Представление графа служб в документации Tempo
