Документация Grafana Документация GlaberGraph Источники данных

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

Источник данных (data source) в Grafana — это подключение к хранилищу, в котором находятся ваши данные, например к серверу Prometheus, экземпляру Loki, базе данных SQL или сервису облачного мониторинга. Grafana запрашивает данные у источников данных, чтобы получить хранимую информацию (например, метрики, логи, трейсы и профили), которую затем визуализирует на дашбордах и в разделе Explore.

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

Каждый источник данных поставляется с редактором запросов (query editor), который формирует пользовательские запросы в соответствии со структурой источника. После добавления и настройки источника данных вы можете использовать его как входные данные для множества операций, включая:

• Запрос данных с помощью Explore.
• Их визуализацию на панелях.
• Создание правил для оповещений.

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

О других доступных плагинах см. список документированных плагинов или просмотрите каталог плагинов. О разработке собственного плагина см. раздел Создание плагина источника данных.

Управление источниками данных

Добавлять и удалять источники данных могут только пользователи с ролью администратора организации. Чтобы как администратор получить доступ к инструментам управления источниками данных в Grafana, перейдите в Connections > Data sources в меню слева.

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

По умолчанию любой пользователь организации может выполнять запросы к любому источнику данных в этой организации. С Grafana Enterprise или Grafana Cloud вы можете настроить разрешения на источники данных, чтобы ограничить доступ на выполнение запросов, редактирование и администрирование для отдельных пользователей, команд или ролей. Подробнее см. в документации по управлению источниками данных.

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

Прежде чем создавать свой первый дашборд, вам нужно добавить источник данных.

Чтобы добавить источник данных:

1. Нажмите Connections в меню слева.
2. Введите имя конкретного источника данных в диалоговом окне поиска. Вы можете отфильтровать по Data source, чтобы видеть только источники данных.
3. Нажмите на источник данных, который хотите добавить.
4. Настройте источник данных в соответствии с инструкциями, специфичными для этого источника данных.

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

Редакторы запросов

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

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

Общую информацию о выполнении запросов в Grafana, а также об общих опциях и элементах интерфейса, характерных для всех редакторов запросов, см. в разделе Запрос и преобразование данных.

Provisioning источников данных

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

Дополнительную информацию см. в разделе Provision data sources.

Специальные источники данных

Grafana включает три специальных источника данных:

Grafana

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

Mixed

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

• Первый запрос использует источник данных, который был выбран до того, как вы выбрали Mixed.
• Вы не можете изменить существующий запрос, чтобы он использовал источник данных Mixed.

Give it a try using Grafana Play

With Grafana Play, you can explore and see how it works, learning from practical examples to accelerate your development. This feature can be seen on Mixed Datasources Example.

Try it

Dashboard

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

Give it a try using Grafana Play

With Grafana Play, you can explore and see how it works, learning from practical examples to accelerate your development. This feature can be seen on Panel as a Data Source.

Try it

Встроенные основные источники данных

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

Метрики и временные ряды

• AWS CloudWatch
• Azure Monitor
• Google Cloud Monitoring
• Graphite
• InfluxDB
• OpenTSDB
• Prometheus

Логи

• Elasticsearch
• Loki

Трейсы

• Jaeger
• Tempo
• Zipkin

Профили

• Parca
• Pyroscope

Базы данных SQL

• Microsoft SQL Server (MSSQL)
• MySQL
• PostgreSQL

Оповещения

• Alertmanager

Тестирование и отладка

• TestData

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

Вы можете добавлять дополнительные источники данных в виде плагинов (которые недоступны в основной сборке Grafana) — их можно установить или создать самостоятельно.

Поиск плагинов источников данных в каталоге плагинов

Чтобы просмотреть доступные плагины источников данных, перейдите в каталог плагинов и выберите фильтр “Data sources”. Подробнее о каталоге плагинов см. в разделе Управление плагинами.

Вы можете дополнительно отфильтровать результаты каталога плагинов по источникам данных, предоставленным сообществом Grafana, Grafana Labs и партнёрами. Если вы используете Grafana Enterprise, вы также можете фильтровать по плагинам, поддерживаемым в Enterprise.

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

Создание плагина источника данных

Чтобы создать собственный плагин источника данных, см. руководство Build a data source plugin и документацию Plugin tools.

Связывание данных между источниками данных

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

Настроить такие связи можно двумя способами:

• Конфигурация источника данных: источники данных трассировки, такие как Tempo, Jaeger и Zipkin, включают встроенные настройки для связей «трейс — логи», «трейс — метрики» и «трейс — профили».
• Корреляции: более гибкая функция общего назначения, позволяющая определять правила связывания данных между любыми источниками данных. Подробнее см. в разделе Корреляции.

Устранение неполадок источников данных

Если у вас возникли проблемы с источником данных, см. раздел Устранение неполадок источников данных с решениями типичных проблем, таких как ошибки подключения, сбои аутентификации и пустые результаты запросов.

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

Дальнейшие шаги

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

• Создать дашборд: нажмите раскрывающийся список Build a dashboard на странице конфигурации источника данных и выберите From suggestions, чтобы открыть диалоговое окно с предлагаемыми дашбордами на основе типа источника данных. Дополнительную информацию см. в разделе Создание дашбордов из предложений или Create a dashboard.
• Изучить свои данные: используйте Explore, чтобы выполнять произвольные запросы без создания дашборда.
• Настроить оповещения: создайте правила оповещений, чтобы получать уведомления, когда данные удовлетворяют определённым условиям.
• Использовать переменные шаблонов: создавайте динамические, многократно используемые дашборды с помощью переменных шаблонов.
• Добавить аннотации: накладывайте аннотации на графики, чтобы отмечать события и сопоставлять их с метриками.
• Преобразовывать результаты запросов: применяйте преобразования, чтобы манипулировать данными из нескольких источников и объединять их.
• Включить кеширование запросов: повышайте производительность дашбордов и снижайте нагрузку на бэкенд с помощью кеширования запросов и ресурсов (доступно в Grafana Enterprise и Grafana Cloud).