Документацияbreadcrumb arrow Grafanabreadcrumb arrow Документация GlaberGraphbreadcrumb arrow Источники данныхbreadcrumb arrow PostgreSQL
Последнее обновление: августа 10, 2026

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

Запрашивайте и визуализируйте данные из любой совместимой с PostgreSQL базы данных. Создавайте дашборды с помощью визуального конструктора запросов или сырого SQL, исследуйте таблицы в реальном времени, накладывайте аннотации и создавайте алерты из одного и того же подключения. Источник данных работает как с самостоятельно размещённым PostgreSQL, так и с управляемыми сервисами, такими как Amazon RDS, Amazon Aurora, Azure Database for PostgreSQL и Google Cloud SQL.

Grafana поставляется с источником данных PostgreSQL «из коробки». Он предустановлен в Grafana OSS и Enterprise, поэтому вам не нужно устанавливать плагин, чтобы добавить его. Источник данных упакован как отдельный плагин, который может обновляться независимо от релизов Grafana.

Поддерживаемые базы данных

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

  • PostgreSQL 9.0 и более новые
  • Amazon RDS for PostgreSQL
  • Amazon Aurora PostgreSQL
  • Azure Database for PostgreSQL
  • Google Cloud SQL for PostgreSQL

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

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

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

  • Запросы временных рядов: визуализируйте метрики во времени с помощью встроенных макросов группировки по времени.
  • Табличные запросы: отображайте результаты запросов в табличном формате для любого допустимого SQL-запроса.
  • Запросы EXPLAIN: изучайте планы выполнения запросов прямо в редакторе запросов.
  • Переменные шаблонов: создавайте динамические дашборды с запросами, управляемыми переменными, используя встроенный редактор запросов переменных.
  • Аннотации: накладывайте события из PostgreSQL на панели вашего дашборда.
  • Алертинг: создавайте алерты на основе результатов запросов PostgreSQL (только формат временных рядов).
  • Макросы: упрощайте запросы с помощью встроенных макросов для фильтрации по времени и группировки.

Поддерживаемые типы данных PostgreSQL

Плагин PostgreSQL использует драйвер PGX для подключения к базе данных. Поддерживаются следующие типы данных PostgreSQL:

  • Числовые типы: int2, int4, int8, float4, float8, numeric
  • Строковые типы: text, varchar, char, bpchar
  • Типы даты/времени: timestamp, timestamptz, date, time, timetz, interval
  • Логический тип: bool
  • Типы JSON: json, jsonb
  • Перечисляемые типы: пользовательские типы enum возвращаются как строковые значения.
  • Другие типы: типы, не сопоставленные явно (например, массивы, составные типы или пользовательские домены), возвращаются как строковые значения.

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

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

Дополнительные возможности

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

  • Добавить аннотации для наложения событий PostgreSQL на ваши графики.
  • Настроить правила алертинга на основе ваших запросов временных рядов.
  • Использовать Explore для исследования данных PostgreSQL без построения дашборда.
  • Добавлять преобразования для обработки результатов запросов.

Чтобы увидеть источник данных PostgreSQL в действии, изучите демонстрационный дашборд на Grafana Play:

Give it a try using Grafana Play
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 PostgreSQL Overview.

Try it

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

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

Чтобы настроить это поведение:

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

Отдельный плагин требует Grafana 12.3.0 или более поздней версии. Источник данных PostgreSQL, встроенный в Grafana 13.1 и более ранние версии, продолжает работать как раньше. Эти версии не затрагиваются вынесением во внешний плагин.

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

ini 
[plugin.grafana-postgresql-datasource]
as_external = true

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

Следующие базы данных используют сетевой протокол PostgreSQL и могут работать с этим источником данных: