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

> [HTML Version](enable-monitoring-enterprise.html)

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

1. [Установка средств мониторинга](#installation-tools-monitoring).

2. [Внесение изменений в конфигурационный файл values-elma365.yaml](#alteration-config-file).

3. [Применение параметров мониторинга для ELMA365 Enterprise](#applying-parameters-monitoring).

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

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

Вы можете установить средства мониторинга в Kubernetes-кластере. Подробнее об этом читайте в статье [«Установка средств мониторинга»](install-monitoring-tools.md).

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

Изменения вносятся в конфигурационный файл \[OBJECT\], заполненный при установке ELMA365.

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

````
Перед редактированием файла \[OBJECT\] создайте его резервную копию, поскольку некорректная настройка параметров может привести к сбоям в работе приложения ELMA365.

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

````
Заполните конфигурационный файл \[OBJECT\] для включения мониторинга:

1. Чтобы включить поддержку мониторинга, укажите \[OBJECT\] в параметре \[OBJECT\].

2. Включите установку в Kubernetes-кластере ServiceMonitor для сервисов приложения ELMA365, указав в параметре \[OBJECT\] значение \[OBJECT\].  
  
По умолчанию передаются только основные метрики сервисов ELMA365. Предоставление всех метрик отключено для предотвращения нарушения работы мониторинга из-за слишком большого количества данных. Чтобы включить все доступные метрики по сервисам приложения ELMA365, укажите в параметре \[OBJECT\] значение \[OBJECT\].   
  
В рамках статьи включение всех метрик не требуется.

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

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

- \[OBJECT\] — позволяет добавить или перезаписать метки (labels) для ServiceMonitor;

- \[OBJECT\] — применяется перед сканированием целей (targets) к их меткам, чтобы:

	- отфильтровать цели, например, оставить только те, у которых есть определённая метка;

	- отредактировать метки цели, например добавить, удалить или изменить метки \[OBJECT\], полученные из инструмента Service Discovery;

	- динамически определить параметры \[OBJECT\], например, путь или порт;

- \[OBJECT\] — применяется к меткам метрик после их сбора, но до их сохранения в Prometheus, чтобы:

	- удалить ненужные метрики;

	- изменить метки собранных метрик, например, для агрегации или упрощения;

	- отфильтровать чувствительные данные.

3. Если Kubernetes-кластер развёрнут на платформе Deckhouse, выставите в параметре \[OBJECT\] значение \[OBJECT\]. Это настроит поставляемые средства мониторинга под целевую платформу.

4. Чтобы установить Dashboards (ConfigMap) в Kubernetes-кластер для сервисов приложения ELMA365, укажите в параметре \[OBJECT\] значение \[OBJECT\].

5. Если нужна установка оповещений, выставите для \[OBJECT\] значение \[OBJECT\]. Начнётся установка PrometheusRule (CRD) в Kubernetes-кластер для сервисов приложения ELMA365.

6. Для настройки маршрутизации трейсов используйте параметр \[OBJECT\] (наивысший приоритет, прямая отправка в коллектор) либо \[OBJECT\] (отправка через агент Jaeger), а при отсутствии этих настроек трейсы автоматически будут направлены на порт \[OBJECT\] локального узла.

````
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"

7. ````
Чтобы включить [экспорт метрик производительности системы](export-monitoring-enterprise.md) в хранилище Prometheus для визуализации данных с помощью Grafana, в \[OBJECT\] укажите \[OBJECT\].

````
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 двумя способами: через интернет или [без доступа к сети](#offline-update).

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

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

````
helm show chart elma365/elma365

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

**(enable-monitoring-enterprise-1.png)**

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

2. Обновите параметры приложения ELMA365 с применением конфигурационного файла \[OBJECT\]. Для этого используйте следующую команду, указав в ней для флага \[OBJECT\] установленную версию чарта вместо \[OBJECT\]:

````
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 минут. Дождитесь его завершения.