+++
title = "Зипкин"
description = "Руководство по использованию Zipkin в Harvest"
keywords = ["harvest", "zipkin", "guide", "tracing"]
aliases = ["/docs/harvest/latest/datasources/zipkin"]
weight = 1600
+++

# Источник данных Zipkin

Harvest поставляется со встроенной поддержкой Zipkin, распределенной системы трассировки с открытым исходным кодом.
Просто добавьте его в качестве источника данных, и вы готовы запрашивать свои трассировки в [Исследовать]({{< relref "../explore" >}}).

## Добавление источника данных

Чтобы получить доступ к настройкам Zipkin, нажмите значок **Конфигурация** (шестеренка), затем нажмите **Источники данных** > **Zipkin**.

| Имя         | Описание                                                          |
| ------------ | --------------------------------------------------------------------- |
| `Name`       | Имя источника данных в панелях, запросах и Исследовании.                |
| `Default`    |Предварительно выбранный источник данных для новой панели.                       |
| `URL`        | URL-адрес экземпляра Zipkin. Например, `http://localhost:9411`. |
| `Basic Auth` | Включите базовую аутентификацию для источника данных Zipkin.               |
| `User`       | Укажите имя пользователя для базовой аутентификации.                        |
| `Password`   | Укажите пароль для базовой аутентификации. |
### Трассировка к логам

> **Примечание.** Эта функция доступна в Harvest 7.4+.

Это конфигурация для [функции трассировки журналов]({{< relref "../explore/trace-integration" >}}). Выберите целевой источник данных (на данный момент ограниченный источниками данных Loki) и укажите, какие теги будут использоваться в запросе журналов.

- **Источник данных -** Целевой источник данных.
- **Теги -** Теги, которые будут использоваться в запросе Loki. По умолчанию это `'кластер', 'имя хоста', 'пространство имен', 'модуль'`.

![Параметры трассировки журналов](/static/img/docs/explore/trace-to-logs-settings-7-4.png "Скриншот настроек трассировки журналов")

## Трассировки запросов

Запрашивать и отображать трассировки из Zipkin можно через [Explore]({{< relref "../explore" >}}).

{{< Figure src="/static/img/docs/v70/zipkin-query-editor.png" class="docs-image--no-shadow" caption="Снимок экрана редактора запросов Zipkin" >}}

Редактор запросов Zipkin позволяет запрашивать идентификатор трассы напрямую или выбирать трассу из селектора трасс. Чтобы выполнить запрос по идентификатору трассировки, вставьте идентификатор в текстовый ввод.

{{< Figure src="/static/img/docs/v70/zipkin-query-editor-open.png" class="docs-image--no-shadow" caption="Снимок экрана редактора запросов Zipkin с селектором трассировки развернуто" >}}

Используйте селектор трасс, чтобы выбрать конкретную трассу из всех трасс, зарегистрированных в диапазоне времени, который вы выбрали в Исследовании. Селектор трассировки имеет три уровня вложенности:

1. Интересующая вас услуга.
1. Конкретная операция является частью выбранной услуги
1. Конкретная трассировка, в которой произошла выбранная операция, представленная именем корневой операции и продолжительностью трассировки.
                   |
## Отображение данных в пользовательском интерфейсе трассировки

Аннотации Zipkin отображаются в представлении трассировки в виде журналов со значением аннотации, отображаемым под ключом аннотации.

## Связывание идентификатора трассировки из журналов

Вы можете связать трассировку Zipkin из журналов в Loki, настроив производное поле с внутренней ссылкой. Подробнее см. в [документации Loki]({{< relref "loki#derived-fields" >}}).