Datasource OpenSearch#

data-sources-opensearch

Datasource OpenSearch для Grafana предоставляет возможность отправлять различные типы запросов к OpenSearch, будь то простая выборка данных или сложные аналитические запросы. С его помощью можно строить красивые графики, основанные на журналах и показателях, хранящихся в OpenSearch. Более того, можно совмещать график с событиями из журналов, создавая наглядные отчеты.

Предусловия#

Источника данных должен предустановлен в компоненте GRAF

Правила эксплуатации#

  • Доступ к источнику данных ограничивается на уровне RBAC.

  • Все подключения к источнику фиксируются в системе аудита.

  • Ограничьте объем запрашиваемых данных.

  • Обновления плагина OpenSearch осуществляются только в составе дистрибутива PLUG.

Последовательность выполнения#

Настройка источника данных OpenSearch#

Выполните следующие действия, чтобы настроить новый источник данных OpenSearch:

  • Нажмите Connections в меню слева.

  • Нажмите Add new connection

  • Введите OpenSearch в строке поиска.

  • Выберите источник данных OpenSearch

  • Нажмите Add new data source в правом верхнем углу.

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

opensearch-settings

Основные параметры#

Опция

Описание

Name

укажите имя источника данных (например, OpenSearch-1).

Default

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

Параметры подключения (HTTP)#

Опция

Описание

Url

протокол (HTTP/HTTPS), IP-адрес и порт сервера OpenSearch. Например

Параметры подключения (Access)#

Опция

Описание

Access

режим доступа к источнику данных. Рекомендуется устанавливать Server mode (режим по умолчанию), при котором запросы отправляются с сервера Grafana. Однако при необходимости можно выбрать режим Browser mode*, при котором запросы направляются прямо из браузера пользователя.

Параметры аутентификации (Auth)#

Опция

Описание

Basic auth

укажите имя пользователя и пароль.

TLS Client Auth

для аутентификации с использованием системы безопасности транспортного уровня.

Skip TLS Verify

возможность пропускать проверку по протоколу TLS.

Forward OAuth Identity

для передачи информации аутентифицированного пользователя

With Credentials

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

With CA Cert

позволяет проверять самоподписанные сертификаты TLS.

Параметры подключения (TLS/SSL Auth Details)#

Опция

Описание

CA Cert

укажите CA Cert.

ServerName

укажите имя сервера

Client Cert

укажите путь к клиентскому сертификату.

Client Key

укажите путь к клиенту закрытого ключа.

Параметры подключения (OpenSearch details)#

Опция

Описание

Index name

используйте настройки индекса, чтобы указать имя индекса OpenSearch по умолчанию. можно использовать временную привязку, например [logstash-]ГГГГ.ММ.ДД, или подстановочный знак для названия индекса. При указании временного интервала фиксированные части интервала должны быть заключены в квадратные скобки.

Pattern

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

Time field name

здесь можно указать значение по умолчанию для поля time. Если оно не указано, то по умолчанию будет использоваться @timestamp.

Version

обязательно нажмите кнопку Get Version и «Сохранить». Это очень важно, поскольку существуют различия в том, как составляются запросы.

Min time interval

нижний предел для автоматической группировки по временному интервалу. Рекомендуется установить частоту записи, например, 1 м, если ваши данные записываются каждую минуту.

PPL enabled

означает включение поддержки языка PPL

Параметры (Logs)#

Опция

Описание

Message field name

сообщение

Level field name

уровень поля

Два параметра, Message field name и Level field name, которые можно дополнительно настроить на странице настроек источника данных. Они определяют, какие поля будут использоваться для сообщений журнала и уровней журнала при визуализации журналов в Explore.

Результат#

После настройки источника данных OpenSearch в Grafana:

  • Использовать данные из OpenSearch

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

  • Выполнять сложные запросы

  • Благодаря поддержке языка запросов OpenSearch (например, DSL), можно создавать фильтры, агрегации и другие аналитические операции.