Перейти к содержанию

Инструкция по подключению к внешней системе мониторинга

Назначение документа

В данном документе описана настройка интеграции мониторинга следующими способами:

  1. Передача метрик во внешнюю ситему мониторинга (PUSH) -- компонент системы мониторинга vmagent отправляет данные в систему мониторинга заказчика.
  2. Сбор метрик внешней системой мониторинга (PULL) -- система заказчика забирает метрики из VictoriaMetrics посредством механизма Prometheus Federation.

Документ предназначен для использования системными администраторами.

Дополнительная документация

Мониторинг Мессенджер и ВКС — в документе мониторинг параметров инсталляции при помощи встроенных сервисов мониторинга (VictoriaMetrics Мессенджер и ВКС и Grafana Мессенджер и ВКС).

Настройка передачи метрик во внешнюю систему мониторинга (PUSH)

Поддерживается передача метрик в Prometheus-подобные системы.

Для этого необходимо, чтобы endpoint для приема метрик был доступен с серверов Мессенджер и ВКС:

  • Для VictoriaMetrics stack это может быть актуальный порт компонента vminsert.
  • Для Prometheus stack это может быть настроенный pushgateway.

Выполните следующие настройки для передачи метрик во внешнюю систему:

  1. В конфигурационном файле /usr/local/etc/k8s/helmwave/store/monitoring.yml установите следующие значения:

    remoteWriteEnabled: true
remoteWriteUrl: https://адрес.для.приёма.метрик/вашей/системой
    2. Примените изменения:

    im_deployer --no-init --skip-check --install -m helmwave --hw-project monitoring

Настройка сбора метрик внешней системой мониторинга (PULL)

Сбор метрик осуществляется при помощи стандарта Prometheus Federate.

Настройку сбора метрик внешней системой мониторинга можно произвести как во время установки Мессенджер и ВКС, так и после завершения установки.

Перед установкой/настройкой сбора метрик внешней системой мониторинга разрешите доступ с сервера мониторинга до инсталляции Мессенджер и ВКС:

  1. Укажите в файле /usr/local/etc/premsetup/defaults.yaml IP-адрес сервера мониторинга, к которому будет обращаться сервис Prometheus Мессенджер и ВКС. Управление осуществляется через параметр myteam_admin_acl:

    myteam_admin_acl: 
  - '10.11.12.102'

  2. Примените изменения: 

    im_deployer --install -m myteam-admin

  3. Перезапустите балансировщик: 
    kubectl -n vkteams delete pod -l app=apigwv2
  4. Проверьте наличие доступа с сервера мониторинга: 
    curl https://admin.<домен_Мессенджер_и_ВКС>/mon/prometheus/federate -d 'match[]=vm_http_request_errors_total'

  5. После появления доступа настройте периодический опрос и забор метрик вашей системой.

    Для Prometheus (пример включения в prometheus/prometheus.yml): 

    scrape_configs:
  - job_name: onpremise-federate-ДОМЕНVKTEAMS'
    scheme: https
    static_configs:
      - targets: ["admin.ДОМЕНVKTEAMS"]
    metrics_path: /mon/prometheus/federate
    params:
      match[]:
        - '{job=~".+"}'
    Ссылка на документацию prometheus: https://prometheus.io/docs/prometheus/latest/federation/.

    Для VictoriaMetrics (настройки в конфигурационном файле vmagent): 

    scrape_configs:
  - job_name: 'big-federate'
    stream_parse: true
    static_configs:
    - targets:
        - big-prometheus1
        - big-prometheus2
    honor_labels: true
    metrics_path: /federate
    params:
      'match[]': ['{__name__!=""}']
    В секции match вы можете выставить фильтр, который будет включать только необходимые метрики. Ссылка на документацию VictoriaMetrics:

Способ добавления конфигурации опроса и состав параметров будет зависеть от вида системы мониторинга и способа её установки (ознакомьтесь с соответствующими разделами документации установленной системы мониторинга).