+++
title = "Аннотации"
keywords = ["harvest", "annotations", "documentation", "guide"]
aliases = ["/docs/harvest/latest/reference/annotations/"]
weight = 2
+++

# Аннотации

{{< рисунок src="/static/img/docs/v46/annotations.png" max-width="800px" >}}

Аннотации позволяют помечать точки на графике насыщенными событиями. При наведении курсора на аннотацию
вы можете получить описание события и теги события. Текстовое поле может содержать ссылки на другие системы с более подробной информацией.

## Нативные аннотации

Harvest поставляется с собственным хранилищем аннотаций и возможностью добавлять события аннотаций непосредственно из панели графика или через [HTTP API]({{< relref "../http_api/annotations.md" >}}).

## Добавление аннотаций

Удерживая Ctrl/Cmd+щелчок. Добавление тегов к аннотации сделает ее доступной для поиска с других панелей мониторинга.

{{< рисунок src="/static/img/docs/annotations/annotation-still.png"
max-width="600px" анимированный-gif="/static/img/docs/annotations/annotation.gif" >}}

### Добавление событий регионов

Вы также можете, удерживая нажатой клавишу Ctrl/Cmd, выбрать область, чтобы создать аннотацию области.

{{< рисунок src="/static/img/docs/annotations/region-annotation-still.png"
max-width="600px" анимированный-gif="/static/img/docs/annotations/region-annotation.gif" >}}

### Встроенный запрос

После того, как вы добавили аннотацию, они по-прежнему будут видны. Это связано со встроенным запросом аннотаций, существующим на всех панелях мониторинга. Этот запрос аннотации будет
извлекать все события аннотаций, исходящие из текущей информационной панели, и отображать их на панели, где они были созданы. Это включает в себя аннотации истории состояния предупреждений. Ты сможешь
остановить извлечение и рисование аннотаций, открыв настройки **Аннотации** (через меню cogs Dashboard) и изменив запрос под названием «Аннотации и оповещения (встроенные)».

Когда вы копируете информационную панель с помощью функции **Сохранить как**, она получает новый идентификатор информационной панели, поэтому аннотации, созданные на исходной информационной панели, больше не будут отображаться в копии. Ты
их все равно можно будет показать, если вы добавите новый **Аннотационный запрос** и отфильтруете по тегам. Но это работает только в том случае, если аннотации на исходной панели инструментов имеют теги для фильтрации.

### Запрос по тегу

Вы можете создавать новые запросы аннотаций, которые извлекают аннотации из собственного хранилища аннотаций через источник данных `-- Harvest --` и установив *Filter by* в `Tags`. Укажите хотя бы
один тег. Например, создайте запрос с аннотацией «отключения» и укажите тег с именем «отключение». Этот запрос покажет все аннотации, которые вы создаете (с любой панели управления или через API), которые имеют тег «outage». По умолчанию, если вы добавите несколько тегов в запрос аннотаций, Harvest покажет только те аннотации, которые содержат все указанные вами теги. Вы можете изменить поведение, включив «Соответствие любому», что означает, что Harvest будет отображать аннотации, содержащие хотя бы один из предоставленных вами тегов.

В Harvest v5.3+ можно использовать переменные шаблона в запросе тега. Таким образом, если у вас есть информационная панель, показывающая статистику для различных служб, и переменная шаблона, определяющая, какие службы отображать, теперь вы можете использовать ту же переменную шаблона в своем запросе аннотаций, чтобы отображать аннотации только для этих служб.

{{< Figure src="/static/img/docs/v53/annotation_tag_filter_variable.png" max-width="600px" >}}

## Запрос других источников данных

События аннотаций извлекаются с помощью запросов аннотаций. Чтобы добавить новый запрос аннотаций на панель мониторинга
откройте меню настроек приборной панели, затем выберите «Аннотации». Это откроет аннотации панели инструментов.
просмотр настроек. Чтобы создать новый запрос аннотации, нажмите кнопку «Создать».

<!--![](/static/img/docs/v50/annotation_new_query.png)-->
{{< рисунок src="/static/img/docs/v50/annotation_new_query.png" max-width="600px" >}}

Укажите имя для запроса аннотации. Это имя дается переключателю (флажку), который позволяет
вы можете включить/отключить отображение событий аннотаций из этого запроса. Например, у вас может быть два
аннотационные запросы с именами «Deploys» и «Outages». Переключатель позволит вам решить, какие аннотации
показывать.

### Детали запроса аннотаций

Параметры запроса аннотации различаются для каждого источника данных. Информацию об аннотациях в конкретном источнике данных см. в соответствующем разделе [источник данных]({{< relref "../datasources/_index.md" >}}).