Документация Grafana Документация GlaberGraph Визуализация данных Explore Редактор корреляций в Explore

Редактор корреляций в Explore

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

Создание корреляции

1. В Grafana перейдите на страницу Explore.
2. Выберите источник данных, который должен стать исходным источником данных для новой корреляции.
3. Выполните запрос, возвращающий данные в поддерживаемой визуализации.
4. Нажмите + Add на верхней панели инструментов и выберите Add correlation (также можно выбрать Correlations Editor в палитре команд).
5. Теперь Explore находится в режиме редактора корреляций, на что указывают синяя рамка и верхняя панель. Выйти из редактора корреляций можно, нажав Exit на верхней панели.
6. Теперь вы можете создать следующие новые корреляции для визуализации со ссылками, привязанными к данным, которые можно использовать для построения нового запроса:
   • Logs: ссылки отображаются рядом со значениями полей в сведениях о журнале для каждой строки журнала
   • Table: каждая ячейка таблицы является ссылкой
7. Нажмите на ссылку, чтобы добавить новую корреляцию. Ссылки связаны с полем, которое используется как поле результата корреляции.
8. В открывшемся разделённом представлении используйте правую панель, чтобы настроить целевой источник запроса корреляции.
9. Постройте целевой запрос, используя синтаксис переменных, с переменными из списка, предоставленного в верхней части панели. Список содержит примеры значений из выбранной строки данных.
10. Укажите метку и описание (необязательно). Метка будет использоваться как имя ссылки внутри визуализации и может содержать переменные.
11. Укажите преобразования (необязательно; подробности см. ниже).
12. Нажмите Save на верхней панели инструментов, чтобы сохранить корреляцию и выйти из режима редактора корреляций. Ссылка, использованная для создания корреляции, заменяется ссылкой на данные в каждой строке. При нажатии на ссылку определённый вами запрос выполнится на другой панели, а переменные будут динамически заменены значениями из выбранной строки.

Преобразования

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

После нажатия на одну из сгенерированных ссылок в режиме редактора вы можете добавить преобразования, нажав Add transformation в раскрывающемся меню Transformations.

Вы можете использовать преобразование в своей корреляции, выполнив следующие шаги:

1. Выберите поле, к которому нужно применить преобразование. Выберите часть поля, которую хотите использовать для преобразования. Например, строку журнала. После выбора значение этого поля будет использоваться, чтобы помочь вам построить преобразование.
2. Выберите тип преобразования. Параметры и соответствующие настройки см. в разделе корреляции.
3. В зависимости от выбора вы можете увидеть заполнение одной или нескольких переменных или вам может потребоваться указать дополнительные сведения в отображаемых параметрах.
4. Выберите Add transformation to correlation, чтобы добавить указанные переменные в список доступных переменных.

Примечания по регулярным выражениям

Для регулярных выражений в этом диалоговом окне mapValue, упоминаемый в другой документации, здесь называется Variable Name. Grafana подсвечивает любой текст, соответствующий выражению в значении поля. Используйте группы захвата регулярного выражения, чтобы выбрать, какую часть совпадения следует извлечь. Когда указано допустимое регулярное выражение, переменная и значение этой переменной появляются под полем Variable Name.

Примеры корреляций

Следующие примеры показывают, как создавать корреляции с помощью редактора корреляций в Explore. Если вы хотите повторить эти примеры, обязательно настройте тестовый источник данных.

Создание корреляции «текст — график»

Этот пример показывает, как создать корреляцию с помощью редактора корреляций в Explore.

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

Чтобы повторить этот пример, убедитесь, что у вас настроен тестовый источник данных.

1. В Grafana перейдите на Explore.

2. Выберите тестовый источник данных в раскрывающемся меню в левом верхнем углу страницы.

3. Нажмите + Add в раскрывающемся меню справа и выберите Add correlation.

4. Теперь Explore находится в режиме редактора корреляций, на что указывает синяя рамка.

5. Выберите следующий сценарий в раскрывающемся меню сценариев: CSV File.

6. Выберите файл population_by_state.csv. Каждая ячейка — это ссылка, нажав на которую можно начать создание новой корреляции.

7. Нажмите на любую ячейку в столбце State, чтобы создать новую корреляцию, которая привязывает ссылку на данные к этой записи. Например, выберите «California».

8. В разделённом представлении выберите тот же источник данных, который вы выбрали на левой панели. Помощник над редактором запросов содержит все доступные переменные, которые можно использовать в целевом запросе. Переменные содержат все поля данных (столбцы таблицы) из выбранной строки.

9. В меню Scenario выберите CSV Metric Values. Поле String Input в редакторе запросов предоставляет переменные со значениями численности населения для каждого года: ${1980},${2000},${2020}. Это создаст график с использованием значений переменных.

10. В поле Alias редактора запросов введите «${State}».

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

11. Нажмите Save, чтобы сохранить корреляцию и выйти из редактора корреляций.

    После сохранения корреляции Explore повторно выполнит запрос на левой панели. При нажатии на название штата запрос справа выполняется заново со значениями из строки, вставляемыми в CSV, что изменяет график. Запрос выполняется заново с обновлёнными значениями каждый раз, когда вы нажимаете на название штата.

Ту же последовательность шагов можно применить к любому источнику данных. Корреляции позволяют создавать ссылки в визуализациях для выполнения динамических запросов на основе выбранных данных. В этом примере мы использовали данные, возвращённые запросом, для построения нового запроса, создающего другую визуализацию с использованием того же источника данных. Однако вы можете создавать корреляции между любыми источниками данных, чтобы создавать собственные сценарии исследования.

Создание корреляции «журналы — таблица»

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

Чтобы повторить этот пример, убедитесь, что у вас настроен тестовый источник данных.

1. В Grafana перейдите на Explore.

2. Выберите тестовый источник данных в раскрывающемся меню в левом верхнем углу страницы.

3. Нажмите + Add в раскрывающемся меню справа и выберите Add correlation.

4. Теперь Explore находится в режиме редактора корреляций, на что указывает синяя рамка.

5. В меню Scenario выберите Logs.

6. Разверните строку журнала, чтобы увидеть ссылки корреляции. Выберите Correlate with hostname.

7. Explore открывается в разделённом представлении. Выберите тот же источник данных, который вы выбрали на левой панели. Помощник над редактором запросов содержит все доступные переменные, которые можно использовать в целевом запросе.

8. Разверните раздел преобразований и нажмите Add transformation.

9. В раскрывающемся меню Field выберите message. Строка журнала отображается как пример данных.

10. В разделе Type выберите Logfmt. Это заполнит список переменных.

11. Нажмите Add transformation to correlation.

12. Снова нажмите Add transformation и в разделе Field выберите hostname.

13. В разделе Type выберите Regular expression.

14. В разделе Expression введите следующее: -([0-9]\*) Это выбирает любые числа справа от дефиса.

15. В разделе Variable Name введите следующее: hostNumber Это заполнит список переменных.

16. Нажмите Add transformation to correlation, чтобы добавить её к остальным переменным.

17. В редакторе источника данных откройте раскрывающееся меню Scenario и выберите CSV Content.

18. В текстовом поле ниже укажите следующее и сохраните корреляцию:

    csv Copy

    time,msg,hostNumber,status
    ${time},${msg},${hostNumber},${status}

    Это закрывает разделённое представление и повторно выполняет запрос слева. Разверните любую строку журнала, чтобы увидеть кнопку корреляции. Нажатие кнопки корреляции открывает разделённое представление с time (поле), msg (извлечено с помощью logfmt из строки журнала), номером хоста (извлечён с помощью regex из hostname) и status (извлечено с помощью logfmt из строки журнала).