side menu

ELMA365 On-Premises > Администрирование ELMA365 Enterprise / Включение параметров мониторинга в ELMA365 Enterprise

Включение параметров мониторинга в ELMA365 Enterprise

Процесс включения мониторинга для приложения ELMA365 состоит из трёх этапов:

  1. Установка средств мониторинга.
  2. Внесение изменений в конфигурационный файл values-elma365.yaml.
  3. Применение параметров мониторинга для ELMA365 Enterprise.

Шаг 1. Установка средств мониторинга

Под установкой средств мониторинга подразумевается развёртывание в Kubernetes-кластере Prometheus для хранения временных рядов, а также Grafana для их визуализации. Если у вас уже есть развёрнутые Prometheus и Grafana, этот этап можно пропустить.

Вы можете установить средства мониторинга в Kubernetes-кластере. Подробнее об этом читайте в статье «Установка средств мониторинга».

Шаг 2. Внесение изменений в конфигурационный файл values-elma365.yaml

Изменения вносятся в конфигурационный файл values-elma365.yaml, заполненный при установке ELMA365.

Начало внимание

Перед редактированием файла values-elma365.yaml создайте его резервную копию, поскольку некорректная настройка параметров может привести к сбоям в работе приложения ELMA365.

Конец внимание

Заполните конфигурационный файл values-elma365.yaml для включения мониторинга:

  1. Чтобы включить поддержку мониторинга, укажите true в параметре global.monitoring.enabled.
  2. Включите установку в Kubernetes-кластере ServiceMonitor для сервисов приложения ELMA365, указав в параметре global.monitoring.metrics.enabled значение true.
     
    По умолчанию передаются только основные метрики сервисов ELMA365. Предоставление всех метрик отключено для предотвращения нарушения работы мониторинга из-за слишком большого количества данных. Чтобы включить все доступные метрики по сервисам приложения ELMA365, укажите в параметре global.monitoring.metrics.all значение true.
     
    В рамках статьи включение всех метрик не требуется.

Дополнительные параметры для ServiceMonitor

 
По умолчанию при мониторинге используются все ServiceMonitor. Вы можете исключить сбор данных с определённых ServiceMonitor или настроить перенаправление данных в разные экземпляры Prometheus с помощью меток (labels). Для этого используйте параметры:

  • labels — позволяет добавить или перезаписать метки (labels) для ServiceMonitor;
  • relabelings — применяется перед сканированием целей (targets) к их меткам, чтобы:
    • отфильтровать цели, например, оставить только те, у которых есть определённая метка;
    • отредактировать метки цели, например добавить, удалить или изменить метки __meta_*, полученные из инструмента Service Discovery;
    • динамически определить параметры scrape, например, путь или порт;
  • metricRelabelings — применяется к меткам метрик после их сбора, но до их сохранения в Prometheus, чтобы:
    • удалить ненужные метрики;
    • изменить метки собранных метрик, например, для агрегации или упрощения;
    • отфильтровать чувствительные данные.
  1. Если Kubernetes-кластер развёрнут на платформе Deckhouse, выставите в параметре global.monitoring.provisioner значение deckhouse. Это настроит поставляемые средства мониторинга под целевую платформу.
  2. Чтобы установить Dashboards (ConfigMap) в Kubernetes-кластер для сервисов приложения ELMA365, укажите в параметре global.monitoring.dashboard.enabled значение true.
  3. Если нужна установка оповещений, выставите для global.monitoring.alerts.enabled значение true. Начнётся установка PrometheusRule (CRD) в Kubernetes-кластер для сервисов приложения ELMA365.
  4. Для настройки маршрутизации трейсов используйте параметр global.monitoring.jaegerCollectorEndpoint (наивысший приоритет, прямая отправка в коллектор) либо global.monitoring.jaegerAgentAddress (отправка через агент Jaeger), а при отсутствии этих настроек трейсы автоматически будут направлены на порт 5775 локального узла.

global:
  ...
  monitoring:
    enabled: true
    metrics:
      enabled: true
      all: false
    provisioner: "k8s"
    dashboard:
      enabled: true
    alerts:
      enabled: false
    jaegerAgentAddress: "jaeger-agent.monitoring.svc.cluster.local:5775"
    jaegerCollectorEndpoint: "http://tempo.monitoring.svc.cluster.local:14268/api/traces"

  1. Чтобы включить экспорт метрик производительности системы в хранилище Prometheus для визуализации данных с помощью Grafana, в global.monitoring.lowcode.metricExportEnabled укажите true.

global:
  ...
  monitoring:
    enabled: true
    metrics:
      enabled: true
      all: false
    provisioner: "k8s"
    dashboard:
      enabled: true
    alerts:
      enabled: false
    lowcode
      metricExportEnabled: true
...

Шаг 3. Применение параметров мониторинга для ELMA365 Enterprise

Вы можете обновить параметры мониторинга для ELMA365 Enterprise двумя способами: через интернет или без доступа к сети.

Обновление параметров через интернет

  1. Определите версию чарта, с помощью которого было установлено или обновлено приложение ELMA365:

helm show chart elma365/elma365

Пример выполнения команды:

enable-monitoring-enterprise-1

В результате выполнения команды информация о версии чарта будет указана в строке version. Сохраните это значение для выполнения следующего шага.

  1. Обновите параметры приложения ELMA365 с применением конфигурационного файла values-elma365.yaml. Для этого используйте следующую команду, указав в ней для флага --version установленную версию чарта вместо <elma365-chart-version>:

helm upgrade --install elma365 elma365/elma365 -f values-elma365.yaml --version <elma365-chart-version> --timeout=30m --wait [-n namespace]

Обновление параметров без доступа в интернет

Перейдите в каталог с загруженным чартом ELMA365 и выполните команду:

helm upgrade --install elma365 ./elma365 -f values-elma365.yaml --timeout=30m --wait [-n namespace]

Обновление параметров занимает 10–30 минут. Дождитесь его завершения.

worker-pools.html enterprise-troubleshooting.html