Документацияbreadcrumb arrow Grafanabreadcrumb arrow Документация GlaberGraphbreadcrumb arrow Источники данныхbreadcrumb arrow Graphitebreadcrumb arrow Настройка

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

В этом документе приведены инструкции по настройке источника данных Graphite и описаны доступные параметры конфигурации. Общую информацию об управлении источниками данных см. в разделе Data source management.

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

  • Для настройки источника данных Graphite вам необходима роль Organization administrator. Администраторы организации также могут настроить источник данных через YAML с помощью системы провижининга Grafana.

  • Grafana поставляется со встроенным плагином источника данных Graphite, поэтому устанавливать плагин не требуется.

  • Ознакомьтесь с вашей конфигурацией безопасности Graphite и подготовьте необходимые сертификаты безопасности и клиентские ключи.

Добавление источника данных Graphite

Чтобы настроить базовые параметры источника данных, выполните следующие шаги:

  1. В меню слева нажмите Connections.
  2. Нажмите Add new connection.
  3. Введите Graphite в строке поиска.
  4. Выберите Graphite data source.
  5. В правом верхнем углу нажмите Add new data source.

Grafana откроет вкладку Settings, где вы выполните настройку Graphite.

Параметры конфигурации в интерфейсе

Ниже приведён список параметров конфигурации для Graphite.

Параметр Описание
Name Отображаемое имя источника данных. Именно так вы будете ссылаться на него в панелях и запросах.
Примеры: graphite-1, graphite-metrics.
Default Если включено, назначает этот источник данных источником по умолчанию для панелей дашборда. Он будет автоматически выбран при создании новых панелей.

HTTP:

Параметр Описание
URL Задаёт протокол HTTP, IP-адрес и порт вашей установки graphite-web или graphite-api.
Поскольку метод доступа установлен в Server, URL должен быть доступен из бэкенда Grafana.
Allowed cookies По умолчанию Grafana удаляет пересылаемые cookie. Укажите здесь имена cookie, чтобы разрешить их пересылку источнику данных.
Timeout Задаёт тайм-аут HTTP-запроса в секундах.

Auth:

Параметр Описание
Basic Auth Включите, чтобы активировать базовую аутентификацию для источника данных.
  User Задаёт имя пользователя, используемое для базовой аутентификации.
  Password Введите пароль, используемый для базовой аутентификации.
With Credentials Включите, чтобы включать cookie и заголовки аутентификации в межсайтовые запросы.
TLS Client Auth Включите, чтобы активировать клиентскую аутентификацию TLS (проверяются и сервер, и клиент).
  ServerName Имя сервера, используемое для проверки имени хоста в сертификате, возвращённом сервером.
  Client Cert Клиентский сертификат, выданный удостоверяющим центром (CA) или самоподписанный.
  Client Key Закрытый ключ, используемый для шифрования обмена данными между клиентом и сервером. Также выданный CA или самоподписанный.
With CA Cert Включите, чтобы выполнять аутентификацию с помощью сертификата CA.
  CA Cert Сертификат CA, используемый для проверки сертификата сервера.
Skip TLS Verify Включите, чтобы обойти проверку сертификата TLS. Не рекомендуется, если в этом нет необходимости или для целей тестирования.
Forward OAuth Identity Включите, чтобы пересылать восходящую идентичность OAuth пользователя источнику данных. Grafana включает токен доступа в запрос.

Custom HTTP Headers:

Передавайте дополнительную информацию и метаданные о запросе или ответе.

Параметр Описание
Header Добавьте пользовательский заголовок. Это позволяет передавать пользовательские заголовки в соответствии с потребностями вашего экземпляра Graphite.
Value Значение заголовка.

Graphite details:

Параметр Описание
Version Выберите вашу версию Graphite в выпадающем списке. Это определяет, какие функции доступны в редакторе запросов Graphite. Для Graphite в Grafana Cloud используйте 1.1.x.
Graphite backend type Выберите тип бэкенда Graphite. Выбор Metrictank включает дополнительные возможности, такие как метаданные обработки запроса. (Metrictank — это многопользовательский движок временных рядов, совместимый с Graphite.) Для Graphite в Grafana Cloud используйте Default.
Rollup indicator Включите, чтобы отображать значок информации в заголовках панелей, когда происходит агрегирование данных (rollup). Доступно только при выборе Metrictank.

Label mappings:

Сопоставления меток — это правила, которые вы определяете, чтобы указать Grafana, как извлекать части пути метрики Graphite в метки Loki при переключении источников данных. В настоящее время они поддерживаются только между запросами Graphite и Loki.

Когда вы меняете источник данных с Graphite на Loki, ваши запросы автоматически сопоставляются на основе заданных вами правил. Чтобы создать сопоставление, укажите полный путь метрики и замените узлы, которые нужно сопоставить, именами меток, используя круглые скобки. Соответствующие значения меток извлекаются из вашего запроса Graphite во время переключения источника данных.

Grafana автоматически сопоставляет все теги Graphite с метками, даже если вы не определили явных сопоставлений. При использовании шаблонов сопоставления с {} (например, metric.{a,b}.value) Grafana преобразует их в синтаксис сопоставления по регулярным выражениям Loki. Если ваши запросы включают функции, Graphite извлекает соответствующие метрики и теги, а затем сопоставляет их с вашими правилами.

Запрос Graphite Сопоставляется с запросом Loki
alias(servers.west.001.cpu,1,2) {cluster="west", server="001"}
alias(servers.*.{001,002}.*,1,2) {server=~"(001,002)"}
interpolate(seriesByTag('foo=bar', 'server=002'), inf) {foo="bar", server="002"}
Параметр Описание
Private data source connect Только для пользователей Grafana Cloud. Устанавливает приватное защищённое соединение между стеком Grafana Cloud и источниками данных внутри приватной сети. Используйте выпадающий список, чтобы найти URL PDC. Инструкции по настройке см. в разделах Private data source connect (PDC) и Configure PDC. Нажмите Manage private data source connect, чтобы открыть страницу соединения PDC и просмотреть детали конфигурации.

|

После настройки параметров источника данных Graphite нажмите Save & test внизу, чтобы проверить соединение. Должно появиться диалоговое окно с подтверждением:

Data source is working

Провизьонинг источника данных

Вы можете определить и настроить источник данных в YAML-файлах в рамках системы провижининга Grafana. Дополнительные сведения о провижининге, а также списки общих параметров конфигурации и параметров JSON-данных см. в разделе Provisioning data sources.

Пример YAML-файла провижининга Graphite:

YAML 
apiVersion: 1

datasources:
  - name: Graphite
    type: graphite
    access: proxy
    url: http://localhost:8080
    jsonData:
      graphiteVersion: '1.1'