+++
title = "Трассировка в Исследовании"
description = "Трассировка в Исследовании"
keywords = ["explore", "trace",]
weight = 20
+++

# Отслеживание в исследовании

Исследование позволяет визуализировать трассировки из источников данных отслеживания. Это доступно в Harvest v7.0+.

Поддерживаемые источники данных - это:

- [Jaeger]({{< relref "../datasources/jaeger.md" >}})
- [Tempo]({{< relref "../datasources/tempo.md" >}})
- [Рентгеновский снимок](https://harvest.com/harvest/plugins/harvest-x-ray-datasource )
- [Zipkin]({{< relref "../datasources/zipkin.md" >}})

Для получения информации о том, как настроить запросы для перечисленных выше источников данных, обратитесь к документации для конкретного источника данных.

{{< рисунок src="/static/img/docs/v70/explore-trace-view-full.png" класс="docs-image-no-shadow" максимальная ширина = "900px" подпись="Скриншот просмотра трассировки" >}}

##### Заголовок

{{< рисунок src="/static/img/docs/v70/explore-trace-view-header.png" класс="docs-image-no-shadow" максимальная ширина = "750px" подпись="Скриншот заголовка просмотра трассировки" >}}

- Заголовок заголовка: Показывает имя корневого диапазона и идентификатор трассировки.
- Поиск: Выделяет области, содержащие искомый текст.
- Метаданные: Различные метаданные о трассировке.

##### Миникарта

{{< рисунок src="/static/img/docs/v70/explore-trace-view-minimap.png" класс="docs-image-no-shadow" максимальная ширина = "900px" подпись="Скриншот миникарты с видом трассировки" >}}

Показывает сжатый вид или временную шкалу трассировки. Наведите курсор мыши на миникарту, чтобы увеличить масштаб до меньшего временного диапазона. Масштабирование также обновит основную временную шкалу, так что будет легко увидеть более короткие промежутки времени. При наведении курсора мыши на миникарту при увеличении появится кнопка сброса выбора, которая сбрасывает масштаб.

##### Временная шкала

{{< рисунок src="/static/img/docs/v70/explore-trace-view-timeline.png" класс="docs-image-no-shadow" максимальная ширина = "900px" подпись="Скриншот временной шкалы просмотра трассировки" >}}

Показывает список промежутков внутри трассировки. Каждый ряд пролета состоит из следующих компонентов:

- Кнопка Развернуть дочерние элементы: разворачивает или сворачивает все дочерние элементы выбранного диапазона.
- Имя службы: Имя службы, зарегистрировавшей интервал.
- Имя операции: Название операции, которую представляет этот интервал.
- Полоса длительности интервала: визуальное представление продолжительности операции в пределах трассировки.

Щелчок в любом месте строки диапазона показывает сведения о диапазоне.

##### Детали пролета

{{< рисунок src="/static/img/docs/v70/explore-trace-view-span-details.png" class="docs-image-no-shadow" max-width= "900px" заголовок="Скриншот подробных сведений о просмотре трассировки" >}}

- Название операции
- Метаданные диапазона
- Теги: Любые теги, связанные с этим диапазоном.
- Метаданные процесса: Метаданные о процессе, который зарегистрировал этот интервал.
- Журналы: Список журналов, зарегистрированных в этом диапазоне, и связанных с ними значений ключей. В случае раздела журналов Zipkin отображаются аннотации Zipkin.

##### Трассировка по журналам

> ** Примечание: ** Доступно в Harvest 7.4 и более поздних версиях.

Вы можете перейти от диапазона в представлении трассировки непосредственно к журналам, относящимся к этому диапазону. На данный момент это доступно для источников данных Tempo, Jaeger и Zipkin.  их соответствующая документация содержит инструкции по настройке этой функции.

{{< рисунок src="/static/img/docs/explore/trace-to-log-7-4.png" class="docs-image--no-shadow" max-width= "600 пикселей" заголовок="Снимок экрана с видом трассировки в "Explore" со значком рядом с промежутки" >}}

Щелкните значок документа, чтобы открыть разделенное представление в разделе "Исследование" с настроенным источником данных и запросить соответствующие журналы для диапазона.

## API данных

Для корректного отображения этой визуализации требуется определенная форма данных, которые должны быть возвращены из источника данных.

Источник данных должен вернуть фрейм данных и установить `frame.meta.preferredVisualisationType = 'trace".

### Структура фрейма данных

Обязательные поля:

| Имя поля | Тип | Описание |
|------------|---------|-------------|
| traceId | строка | Идентификатор для всей трассировки. Во фрейме данных должна быть только одна трассировка. |
| spanID | строка | Идентификатор для текущего диапазона. Идентификаторы SPANID должны быть уникальными для каждой трассировки. |
| parentSpanID | строка | SPANID родительского диапазона для создания дочерних родительских отношений в представлении трассировки. Может быть `неопределенным` для корневого диапазона без родительского. |
| ServiceName | строка | Имя службы, частью которой является этот диапазон. |
| Servicetags | TraceKeyValuePair[] | Список тегов, относящихся к сервису. |
| startTime | число | Время начала интервала в миллисекундном временном интервале. |
| длительность | число | Продолжительность интервала в миллисекундах. |

Необязательные поля:

| Имя поля | Тип | Описание |
|------------|---------|-------------|
| logs | TraceLog[] | Список журналов, связанных с текущим периодом. |
| tags | TraceKeyValuePair[] | Список тегов, связанных с текущим диапазоном. |
| предупреждения | строка[] | Список предупреждений, связанных с текущим диапазоном. |
| stackTraces | строка[] | Список трассировок стека, связанных с текущим диапазоном. |
| errorIconColor | строка | Цвет значка ошибки в случае, если span помечен как "ошибка: true". |

Дополнительные сведения о типах см. в разделе [TraceSpanRow](https://harvest.com/docs/harvest/latest/packages_api/data/tracespanrow /), [TraceKeyValuePair](https://harvest.com/docs/harvest/latest/packages_api/data/tracekeyvaluepair /) и [TraceLog](https://harvest.com/docs/harvest/latest/packages_api/data/tracelog /)