Конфигурационные параметры

Елизавета Вайсман
Содержание

В этой статье описаны параметры сервисов ADM, которые можно настроить через интерфейс ADCM. Подробнее о самом процессе конфигурирования читайте в статьях по установке online и offline.

ПРИМЕЧАНИЕ
Некоторые из перечисленных параметров становятся доступны в UI ADCM после установки флага Show advanced.

Grafana

Параметр Описание Значение по умолчанию

Grafana data path

Путь к хранилищу данных сервиса Grafana на хосте, где развернут сервис. При изменении пути новые настройки применятся только после выполнения действий Uninstall, а затем Install для сервиса Grafana

/opt/adm/grafana/data

Grafana provisioning path

Путь к provisioning-файлам для сервиса Grafana на хосте, где развернут сервис. При изменении пути новые настройки применятся только после выполнения действий Uninstall, а затем Install для сервиса Grafana

/opt/adm/grafana/provisioning

Grafana port

HTTP-порт для доступа к веб-интерфейсу Grafana

3000

Admin username

Логин администратора Grafana для входа в веб-интерфейс

admin

Admin password

Пароль администратора Grafana. ADCM использует его, чтобы автоматически создать учетные данные (системного пользователя и его API-токен) для синхронизации дашбордов

 — 

VictoriaMetrics

Replication Settings
Параметр Описание Значение по умолчанию

Replication Factor

Количество хостов c установленным компонентом VictoriaMetrics Storage, на которые реплицируется каждая метрика.

Подробнее о расчете фактора репликации в зависимости от количества хостов читайте в статьях Добавление компонентов (online-установка) или Добавление компонентов (offline-установка).

2

Deduplication Interval

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

Рекомендуется оставить значение по умолчанию (1ms), чтобы обеспечить стабильную репликацию в кластере "из коробки". При необходимости это значение можно изменить так, чтобы оно совпадало с интервалом сбора метрик (scrape interval) вашего источника данных.

Большие интервалы дедупликации (например, 1m или выше) увеличивают нагрузку на оперативную память хостов, на которых установлены компоненты VictoriaMetrics Storage и VictoriaMetrics Select, поскольку системе приходится буферизировать больше данных для сравнения и удаления дубликатов.

Используйте единицы времени: ms (миллисекунды), s (секунды), m (минуты) или h (часы). Пример: 1ms. Комбинированные значения не поддерживаются (например, значение 1s500ms невалидно). Ввод некорректного значения приведет к тому, что сервис VictoriaMetrics не сможет запуститься

1ms
Storage Settings
Параметр Описание Значение по умолчанию

Retention Period

Срок хранения метрик. Метрики старше этого значения автоматически удаляются из хранилища.

Минимальный срок хранения, который поддерживает VictoriaMetrics, составляет 1 день (1d) или 24 часа (24h).

Бесконечное хранение данных в VictoriaMetrics не поддерживается. Для долгосрочного хранения укажите произвольно большое значение, например 100 лет (100y).

Используйте единицы времени: d (дни), w (недели), M (месяцы) или y (годы). Комбинированные значения также поддерживаются. Примеры: 7d, 2w, 1M, 1y, 1M2w.

Если вы уменьшите срок хранения, то данные старше нового лимита не удалятся мгновенно при перезапуске сервиса. VictoriaMetrics очищает устаревшие метрики постепенно в фоновом режиме

1M

Storage Data Path

Путь к данным VictoriaMetrics Storage на хосте, где развернут компонент VictoriaMetrics Storage.

Если вы измените этот путь, новые настройки применятся только после перезапуска компонента VictoriaMetrics Storage. Подробности доступны в статье Управление сервисом VictoriaMetrics через ADCM.

Чтобы изменить расположение хранилища и не потерять историю метрик, остановите компонент VictoriaMetrics Storage и скопируйте директорию с данными в новое место (например, с помощью утилиты rsync). Затем обновите параметр Storage Data Path в интерфейсе ADCM и запустите компонент VictoriaMetrics Storage. VictoriaMetrics автоматически найдет и загрузит исторические данные из новой директории

/opt/adm/vmstorage/data
Ports Configuration
Параметр Описание Значение по умолчанию

vminsert HTTP Port

HTTP-порт, через который компонент VictoriaMetrics Insert принимает входящие метрики от таких агентов, как vmagent или Prometheus, по протоколу remote_write (совместимому с Prometheus)

8480

vmselect HTTP Port

HTTP-порт, через который компонент VictoriaMetrics Select принимает PromQL-запросы от инструментов визуализации (например, Grafana)

8481

vmstorage HTTP Port

HTTP-порт, через который компонент VictoriaMetrics Storage принимает запросы на проверку работоспособности сервиса (health check) и сбор метрик самомониторинга

8482

vmstorage vminsert RPC Port

TCP-порт, через который компонент VictoriaMetrics Storage принимает данные от компонента VictoriaMetrics Insert по внутреннему RPC-протоколу

8400

vmstorage vmselect RPC Port

TCP-порт, через который компонент VictoriaMetrics Storage принимает запросы на чтение данных от компонента VictoriaMetrics Select по внутреннему RPC-протоколу

8401
Security settings
Параметр Описание Значение по умолчанию

pprof_authkey

Ключ аутентификации для ограничения доступа к эндпойнтам встроенного профайлера Go (/debug/pprof/) для компонентов VictoriaMetrics Insert, VictoriaMetrics Select и VictoriaMetrics Storage.

ADCM всегда хранит этот ключ зашифрованным с помощью Ansible Vault, поэтому в веб-интерфейсе ADCM он отображается как строка, начинающаяся с $ANSIBLE_VAULT;1.1;AES256. Вы можете управлять ключом следующим образом:

  • Аутентификация. Для аутентификации запросов к профайлеру передайте расшифрованный ключ в HTTP-заголовке Authorization или в качестве URL-параметра authKey. Параметр в URL имеет более высокий приоритет.

    Шаблон URL:

    http://<host>:<port>/debug/pprof/?authKey=<decrypted_key>

    Пример: http://10.92.40.169:8482/debug/pprof/?authKey=xLUPib7YKNQuz0l6X9TrbncF

    Где:

    • <host> — адрес хоста, на котором развернут соответствующий компонент VictoriaMetrics.

    • <port> — номер порта соответствующего компонента VictoriaMetrics (список портов можно посмотреть в разделе Ports Configuration).

    • <decrypted_key> — расшифрованное значение ключа. Чтобы узнать его, подключитесь к хосту по SSH и выполните команду ps aux | grep pprofAuthKey.

  • Изменение ключа. Введите любую текстовую строку, которую хотите использовать в качестве нового ключа аутентификации. ADCM зашифрует ее с помощью Ansible Vault автоматически.

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

 — 
Нашли ошибку? Выделите текст и нажмите Ctrl+Enter чтобы сообщить о ней