Victoria Metrics / Prometheus

Последняя версия: 1.3.0

Дистрибутив: образ плагина Victoria Metrics / Prometheus

Описание

Плагин Victoria Metrics / Prometheus предназначен для подключения Графини к VictoriaMetrics и Prometheus, получения метрик и построения временных рядов. В интерфейсе Графини этот источник данных отображается под названием Victoria Metrics / Prometheus.

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

Настройка

Ниже приведены скриншоты формы создания источника данных Victoria Metrics / Prometheus из интерфейса Графини в тёмной теме.

Базовая форма

Поля источника данных

Название в UI	Код поля	Тип	Обязательность	Примечание
URL	url	text	обязательно	Адрес VictoriaMetrics или Prometheus, валидируется как URL
Пользователь	login	text	необязательно	Логин для Basic Auth
Пароль	pass	password	необязательно	Пароль для Basic Auth
Пропустить проверку TLS	skipTls	radio	обязательно	Триггерное поле
Режим ввода запросов пользователем	codeMode	radio	необязательно	Включает или отключает ручной ввод пользовательских запросов
Код языка запросов	codeLang	text	необязательно	Только для чтения, значение по умолчанию promql

Динамические поля и зависимости

Дополнительные поля появляются в зависимости от выбранного значения поля Пропустить проверку TLS.

• Если выбрано Проверять, отображается поле TLS-сертификат.
• Если выбрано Игнорировать, поле TLS-сертификат скрывается.
• Поле TLS-сертификат используется для вставки сертификата в текстовом виде и отображается как многострочное поле.

Триггерное поле	Значение	Что меняется
Пропустить проверку TLS	Проверять	Появляется поле TLS-сертификат
Пропустить проверку TLS	Игнорировать	Поле TLS-сертификат скрывается

Форма без TLS-проверки

Форма с Basic Auth и разрешённым пользовательским вводом запросов

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

• Обязательно заполните поле URL.
• В поле URL указывайте базовый адрес VictoriaMetrics или Prometheus, например http://prometheus.example.local:9090 или https://vm.example.local.
• Не добавляйте в URL путь вида /api/v1/query: плагин формирует служебный запрос к API самостоятельно.
• Для успешной проверки соединения указанный адрес должен быть доступен из сервиса плагина.
• Если на стороне VictoriaMetrics или Prometheus используется Basic Auth, заполните Пользователь и при необходимости Пароль.
• Если выбрано Проверять, при работе с собственным сертификатом заполните поле TLS-сертификат.
• Поле Код языка запросов заполнять не требуется: оно предустановлено значением promql и доступно только для чтения.
• Проверка соединения выполняется только после того, как заполнены обязательные поля формы.

Порядок создания источника данных

1. Откройте раздел Источники данных и нажмите Добавить источник данных.
2. В поле Источник данных укажите понятное имя подключения.
3. В поле Тип выберите Victoria Metrics / Prometheus.
4. Заполните поле URL.
5. При необходимости заполните поля Пользователь и Пароль.
6. В поле Пропустить проверку TLS выберите один из режимов: Проверять, если сертификат должен валидироваться; Игнорировать, если проверка TLS не требуется.
7. Если выбрано Проверять, вставьте сертификат в поле TLS-сертификат.
8. При необходимости включите Режим ввода запросов пользователем.
9. Нажмите Проверить соединение.
10. После успешной проверки нажмите Сохранить.

Пример заполнения без аутентификации

• Источник данных: Prometheus Production
• URL: http://prometheus.example.local:9090
• Пропустить проверку TLS: Игнорировать
• Режим ввода запросов пользователем: Запрещен
• Код языка запросов: promql

Такой вариант подходит для открытого Prometheus или VictoriaMetrics внутри доверенного сегмента сети.

Пример заполнения с Basic Auth

• Источник данных: Prometheus Secure
• URL: https://prometheus.example.local:9090
• Пользователь: prometheus_user
• Пароль: пароль пользователя
• Пропустить проверку TLS: Игнорировать или Проверять в зависимости от схемы подключения
• Режим ввода запросов пользователем: Разрешен
• Код языка запросов: promql

Этот вариант подходит для инсталляций, где доступ к API защищён Basic Auth.

Пример заполнения с TLS-сертификатом

• Источник данных: VictoriaMetrics TLS
• URL: https://vm.example.local
• Пропустить проверку TLS: Проверять
• TLS-сертификат: сертификат в текстовом виде, начиная с --- BEGIN CERTIFICATE ---
• Режим ввода запросов пользователем: Запрещен или Разрешен по вашему сценарию

Этот вариант подходит для подключений, где требуется явная проверка TLS-сертификата сервера.