Визион.Прокси

vlagent_proxy#

Сервис приёма логов ПАК и отправки их в базу данных логов.

Компонент Визиона: Прокси.

Способ установки: Интерфейс Визион.Сервера через plagent.

Расположение журналов:

  • системный журнал;

  • /opt/skala-r/var/log/vision/proxy/vlagent_proxy/vlagent.log.

Порт по умолчанию: 29511.

Учётная запись ОС для запуска сервиса: vision.

Используемые учётные записи компонентов Визиона: VictoriaLogs BasicAuth.

Файлы конфигурации:

  • /etc/systemd/system/vision_vlagent_proxy.service;

  • /opt/skala-r/etc/vision/proxy/vlagent_proxy/environment.env.

Компонент устанавливается на узел из интерфейса Визиона компонентом vision_core с параметрами, указанными в конфигурационном файле vision_core/config.yml.

Настройка параметров TLS и аутентификации для доступа к компоненту по HTTPS производится ключами запуска в файле environment.env.

В ключах запуска компонента в файле environment.env указывается адрес назначения логов с указанием BasicAuth и сертификатов VictoriaLogs.

Ключи запуска#

  • -audit.componentName

    Название компонента.

    Значение по умолчанию: vision_vlagent_proxy.

  • -audit.filePath

    Путь к файлу для сохранения журнала аудита.

    Значение по умолчанию: /opt/skala-r/var/log/vision/vision/audit/proxy/vlagent_proxy/audit.log.

  • -httpAuth.password

    Пароль для BasicAuth HTTP-сервера.

  • -httpAuth.username

    Имя пользователя для BasicAuth HTTP-сервера.

    Значение по умолчанию: vision.

  • -httpListenAddr

    Адрес для прослушивания входящих HTTP-запросов.

    Значение по умолчанию: :29511 (компонент слушает порт 29511 на всех адресах).

  • -http.pathPrefix

    Необязательный префикс для добавления ко всем путям, обрабатываемым HTTP-сервером.

    Значение по умолчанию: /.

  • -loggerFileName

    Путь к файлу записи логов.

    Значение по умолчанию: /opt/skala-r/var/log/vision/vision/proxy/vlagent_proxy/vlagent.log.

  • -loggerOutput

    Тип логирования.

    Возможные значения:

    • file;

    • stdout;

    • stderr.

    Значение по умолчанию: file.

  • -remoteWrite.basicAuth.password

    Пароль BasicAuth, используемый для подключения к -remoteWrite.url.

  • -remoteWrite.basicAuth.username

    Имя пользователя BasicAuth, используемое для подключения к -remoteWrite.url.

    Значение по умолчанию: vision.

  • -remoteWrite.maxDiskUsagePerURL

    Ограничение на размер файла журнала для каждого URL.

    Значение по умолчанию: 10GB (10 ГБ).

  • -remoteWrite.showURL

    Отображение -remoteWrite.url в экспортируемых метриках.

  • -remoteWrite.tlsCAFile

    Путь к файлу TLS CA, который будет использоваться для проверки подключений к -remoteWrite.url.

    Значение по умолчанию: /opt/skala-r-/vision/cert/components_default.crt.

  • -remoteWrite.tlsCertFile

    Путь к файлу сертификата TLS на стороне клиента, который будет использоваться при подключении к -remoteWrite.url.

    Значение по умолчанию: /opt/skala-r/vision/cert/components_default.crt.

  • -remoteWrite.tlsInsecureSkipVerify

    Пропуск проверки TLS при подключении к -remoteWrite.url.

    Значение по умолчанию: True (проверка сертификата выключена).

  • -remoteWrite.tlsKeyFile

    Путь к ключу сертификата TLS на стороне клиента, который будет использоваться при подключении к -remoteWrite.url.

    Значение по умолчанию: /opt/skala-r/vision/cert/components_default.key.

  • -remoteWrite.url

    URL-адрес VictoriaMetrics или vminsert, где сохраняется состояние оповещений и результаты правил записи.

  • -tls

    Использование TLS для входящих HTTP-запросов по заданному -httpListenAddr.

    Значение по умолчанию: True (включено).

  • -tlsCertFile

    Путь к файлу с сертификатом TLS для соответствующего -httpListenAddr.

    Значение по умолчанию: /opt/skala-r/vision/cert/components_default.crt.

  • -tlsKeyFile

    Путь к файлу с ключом TLS для соответствующего -httpListenAddr.

    Значение по умолчанию: /opt/skala-r/vision/cert/components_default.key.

  • -tlsMinVersion

    Минимальная версия TLS для использования для соответствующего -httpListenAddr.

    Значение по умолчанию: TLS13.

vmagent_proxy#

Сервис приёма метрик ПАК и отправки их в базу данных временных рядов.

Компонент Визиона: Прокси.

Способ установки: Интерфейс Визион.Сервера через plagent.

Расположение журналов:

  • системный журнал;

  • /opt/skala-r/var/log/vision/proxy/vmagent_proxy/vmagent.log.

Порт по умолчанию: 8430.

Учётная запись ОС для запуска сервиса: vision.

Используемые учётные записи компонентов Визиона: VictoriaMetrics BasicAuth.

Файлы конфигурации:

  • /etc/systemd/system/vision_vmagent_proxy.service;

  • /opt/skala-r/etc/vision/proxy/vmagent_proxy/environment.env;

  • /opt/skala-r/etc/vision/proxy/vmagent_proxy/vmagent.yml.

Компонент устанавливается на узел из интерфейса Визиона компонентом vision_core с параметрами, указанными в конфигурационном файле vision_core/config.yml.

Настройка параметров TLS и аутентификации для доступа к компоненту по HTTPS производится ключами запуска в файле environment.env.

Параметры скрепинга метрик этого компонента устанавливаются с помощью файла vmagent.yml.

В ключах запуска компонента в файле environment.env указывается адрес назначения метрик с указанием BasicAuth и сертификатов VictoriaMetrics.

Ключи запуска#

Все доступные ключи запуска описаны в https://docs.victoriametrics.com/vmagent/#advanced-usage[ документации VictoriaMetrics].

  • --audit.componentName

    Название компонента, используемое при ведении журнала аудита.

  • --audit.filePath

    Путь к файлу лога аудита.

    Пустое значение отключает аудит.

  • --http.pathPrefix

    Необязательный префикс для добавления ко всем путям, обрабатываемым HTTP-сервером.

  • --httpAuth.password

    Пароль для BasicAuth HTTP-сервера.

  • --httpAuth.username

    Имя пользователя для BasicAuth HTTP-сервера.

  • --httpListenAddr

    Адрес для прослушивания входящих HTTP-запросов.

  • --loggerFileName

    Путь к файлу записи логов.

  • --loggerOutput

    Тип логирования.

    Возможные значения:

    • file;

    • stdout;

    • stderr.

    Значение по умолчанию: file.

  • --promscrape.config

    Путь к файлу конфигурации Prometheus с разделом scrape_configs, содержащим цели для очистки.

  • --promscrape.configCheckInterval

    Периодичность проверки файла конфигурации Prometheus на наличие изменений.

  • --promscrape.maxScrapeSize

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

  • --remoteWrite.basicAuth.password

    Пароль BasicAuth к --remoteWrite.url.

  • --remoteWrite.basicAuth.username

    Имя пользователя BasicAuth к --remoteWrite.url.

  • --remoteWrite.maxDiskUsagePerURL

    Ограничение на размер буфера, используемого для хранения метрик, полученных по каждому URL.

  • --remoteWrite.showURL

    Отображение --remoteWrite.url в экспортируемых метриках.

  • --remoteWrite.tlsCAFile

    Путь к файлу TLS CA, который будет использоваться для проверки подключений к --remoteWrite.url.

  • --remoteWrite.tlsCertFile

    Путь к файлу сертификата TLS на стороне клиента, который будет использоваться при подключении к --remoteWrite.url.

  • --remoteWrite.tlsInsecureSkipVerify

    Пропуск проверки TLS при подключении к --remoteWrite.url.

  • --remoteWrite.tlsKeyFile

    Путь к ключу сертификата TLS на стороне клиента, который будет использоваться при подключении к --remoteWrite.url.

  • --remoteWrite.url

    URL-адрес VictoriaMetrics или vminsert, где сохраняется состояние оповещений и результаты правил записи.

  • --tls

    Использование TLS для входящих HTTP-запросов по заданному --httpListenAddr.

  • --tlsCertFile

    Путь к файлу с сертификатом TLS для соответствующего --httpListenAddr.

  • --tlsKeyFile

    Путь к файлу с ключом TLS для соответствующего --httpListenAddr.

  • --tlsMinVersion

    Минимальная версия TLS для использования для соответствующего --httpListenAddr.