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

Метод 1: использование функции «псевдоним» в редакторах запросов
В Grafana большинство редакторов запросов предоставляют опцию «псевдоним». С помощью этой функции вы можете добавить текст к названию метрики или серии. Например, если ваш запрос возвращает метрику «cpu_usage», вы можете использовать псевдоним «Загрузка ЦП – {{text}}» для добавления пользовательского текста.

Пример:

SELECT cpu_usage FROM cpu_metrics

Псевдоним: Загрузка ЦП – {{text}}

Метод 2: использование функции «Преобразование» в Grafana
Функция преобразования в Grafana позволяет изменять результаты запроса с помощью JavaScript. Вы можете использовать эту функцию для динамического добавления текста к результатам.

Пример:

SELECT cpu_usage FROM cpu_metrics

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

return series.renameByTag("cpu_usage", "CPU Usage - " + text);

Метод 3: использование панели «Текст» в Grafana
Панель «Текст» — это универсальная панель в Grafana, которая позволяет отображать статический текст или динамические значения. Вы можете создать панель «Текст» и использовать переменные шаблона для добавления текста на основе выбора пользователя.

Пример:
Создайте панель «Текст» и используйте следующую переменную шаблона в поле «Текст»:

CPU Usage - $text

Метод 4: использование аннотаций Grafana
Аннотации в Grafana полезны для добавления маркеров событий на ваши графики. Вы можете использовать эту функцию для добавления текста в виде аннотаций, предоставляя дополнительный контекст вашим данным.

Пример:

// Assuming you have an annotation query that returns events
SELECT * FROM events

Добавьте столбец в результаты запроса:

AS description, 'CPU Usage - ' + text AS text

Метод 5: использование панели «Таблица» в Grafana
Панель «Таблица» позволяет отображать результаты запроса в табличном формате. Вы можете добавить в таблицу новый столбец и использовать средство визуализации «Текст», чтобы добавить собственный текст в определенные строки.

Пример:
Создайте панель «Таблица» и добавьте новый столбец со следующими настройками:
Столбец: Текст
Значение: «Загрузка ЦП – ‘ + текст

Метод 6. Использование переменных Grafana
Переменные Grafana — это заполнители, которые можно использовать в запросах и информационных панелях. Вы можете создать переменную и динамически добавлять к ее значению текст, предоставляя гибкий способ настройки результатов.

Пример:
Создайте переменную с настраиваемым текстовым параметром:
Переменная: text
Параметры: [Нет, «Пользовательский текст»]
По умолчанию: Нет

Метод 7: настройка панелей Grafana с помощью плагинов
Grafana имеет обширную экосистему плагинов, которая позволяет расширять ее функциональные возможности. Вы можете использовать такие плагины, как «Текстовая панель с переменными» или «Пользовательская панель», чтобы программно добавлять текст к результатам запроса.

Добавление текста к результатам запроса в Grafana может повысить ясность и контекст ваших визуализаций. В этой статье мы рассмотрели семь различных методов достижения этой цели, включая использование функций псевдонимов, преобразования, панели «Текст», «Аннотации», панели «Таблица», переменных и пользовательских плагинов. Используя эти методы, вы можете создавать более информативные и настраиваемые информационные панели в Grafana.