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

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

Note
Если вы используете Amazon OpenSearch Service (преемник Amazon Elasticsearch Service), вместо этого используйте источник данных OpenSearch.

Ключевые возможности

Источник данных Elasticsearch поддерживает:

Запросы метрик: агрегирование и визуализация числовых данных с помощью bucket- и metric-агрегаций.
Запросы журналов: поиск, фильтрация и исследование данных журналов с помощью синтаксиса запросов Lucene.
Необработанные запросы DSL: написание нативного Elasticsearch Query DSL в режиме Code.
Запросы ES|QL: запрос данных с помощью конвейерного языка запросов Elasticsearch.
Аннотации: наложение событий Elasticsearch на графики дашборда.
Оповещения: создание правил оповещений на основе результатов запросов Elasticsearch.

Прежде чем начать

Прежде чем настраивать источник данных Elasticsearch, вам потребуются:

Экземпляр Elasticsearch (v7.17+, v8.x или v9.x)
Сетевой доступ из Grafana к вашему серверу Elasticsearch
Подходящие учётные данные пользователя или ключи API с доступом на чтение

Поддерживаемые версии Elasticsearch

Этот источник данных поддерживает следующие версии Elasticsearch:

≥ v7.17
v8.x
v9.x
Elastic Cloud Serverless

Политика сопровождения источника данных Elasticsearch в Grafana соответствует датам окончания поддержки продуктов Elastic. Grafana гарантирует корректную работу только для поддерживаемых версий. Если вы используете версию Elasticsearch с истёкшей поддержкой, запросы всё ещё можно выполнять, но конструктор запросов отобразит предупреждение. Grafana не гарантирует работоспособность и не предоставляет исправления для версий с истёкшей поддержкой.

Начало работы

Следующая документация поможет вам настроить источник данных Elasticsearch и начать его использовать:

Обновления плагина

Начиная с Grafana v13.0 источник данных Elasticsearch — это отдельный плагин, предустанавливаемый как в Grafana OSS, так и в Grafana Enterprise. Это позволяет обновлять его чаще, независимо от выпусков Grafana. Grafana автоматически проверяет каталог плагинов и устанавливает последнюю версию при каждом перезапуске сервера.

Note
В Grafana Cloud плагины обновляются автоматически.

Чтобы изменить это поведение:

Отказаться от автообновления: задайте для параметра preinstall_auto_update значение false в вашем файле конфигурации.
Обновлять вручную: обновляйте в любой момент из раздела Plugins and data > Plugins без перезапуска Grafana.

Отдельный плагин требует Grafana 12.2.0 или более поздней версии. Источник данных Elasticsearch, встроенный в Grafana 12.1 и более ранние версии, продолжает работать как прежде. Эти версии не затронуты вынесением плагина наружу.

Пользователи, работающие с Grafana 12.2.x–12.4.x, могут установить отдельный плагин из каталога плагинов, если хотят получить последние возможности до обновления до Grafana 13.0. Чтобы использовать отдельный плагин с Grafana 12.2.x–12.4.x, добавьте в ваш файл конфигурации:

[plugin.elasticsearch]
as_external = true

[plugins]
; Install the latest version on startup:
preinstall_sync = elasticsearch
; Or install a specific version:
; preinstall_sync = elasticsearch@<version>

Дополнительные ресурсы

После настройки источника данных Elasticsearch вы можете:

Использовать Explore для выполнения написанных вручную запросов к данным Elasticsearch.
Настроить и использовать переменные шаблона для динамических дашбордов.
Добавить преобразования для обработки результатов запросов.
Создавать дашборды для визуализации данных Elasticsearch.