search string side menu

ELMA365 On-Premises > ELMA365 On-Premises Enterprise > Установка дополнений для приложения ELMA365 / Установка средств мониторинга

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

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

Установка состоит из четырёх этапов:

  1. Очистка CRD перед установкой (опционально).
  2. Загрузка Helm-чарта и конфигурационного файла.
  3. Заполнение конфигурационного файла.
  4. Установка чарта Monitoring с помощью Helm в Kubernetes-кластер.

Шаг 1: Очистка CRD перед установкой (опционально)

Произведите очистку CRD, если вы ранее устанавливали средства мониторинга или используете версию ELMA365 ниже ELMA365 2023.6.19 или ELMA365 LTS 2023.4.52.

Для очистки старых CRD выполните следующую команду:

kubectl delete crd alertmanagerconfigs.monitoring.coreos.com
kubectl delete crd alertmanagers.monitoring.coreos.com
kubectl delete crd podmonitors.monitoring.coreos.com
kubectl delete crd probes.monitoring.coreos.com
kubectl delete crd prometheusagents.monitoring.coreos.com
kubectl delete crd prometheuses.monitoring.coreos.com
kubectl delete crd prometheusrules.monitoring.coreos.com
kubectl delete crd scrapeconfigs.monitoring.coreos.com
kubectl delete crd servicemonitors.monitoring.coreos.com
kubectl delete crd thanosrulers.monitoring.coreos.com

Шаг 2: Загрузка Helm-чарта и конфигурационного файла

Для установки через интернет получите конфигурационный файл values-monitoring.yaml, выполнив команду:

helm repo add elma365 https://charts.elma365.tech
helm repo update
helm show values elma365/monitoring> values-monitoring.yaml

Шаг 3: Заполнение конфигурационного файла

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

Для этого в параметрах kube-prometheus-stack.namespaceOverride и grafana.namespaceOverride укажите нужный namespace для сервиса мониторинга, например, namespaceOverride: monitoring. Namespace будет создан во время установки, если не был создан ранее.

Для Grafana:

  1. Убедитесь что включён интерфейс, в параметре kube-prometheus-stack.grafana.ingress.enabled задано true.
  2. Задайте адрес, по которому будет доступна Grafana, в параметре kube-prometheus-stack.grafana.ingress.hosts.
  3. Задайте пароль для администратора в параметре kube-prometheus-stack.grafana.adminPassword.

Заполнение конфигурационного файла values-monitoring.yaml для установки мониторинга

# -- Настройки monitoring
kube-prometheus-stack:
  # -- Настройки grafana
  grafana:
    assertNoLeakedSecrets: false
    # -- адрес по которому будет доступна grafana
    ingress:
      enabled: true
      ingressClassName: nginx
      hosts:
        - grafana.mycompany.com
      # -- настройка tls
      # tls:
      #   - secretName: "mycompany-cert"
      #     hosts:
      #       - grafana.mycompany.com
      annotations: {}
    # -- учетные данные администратора
    adminUser: admin
    adminPassword: admin
    # -- список используемых плагинов
    plugins:
    - camptocamp-prometheus-alertmanager-datasource
    - flant-statusmap-panel
    - vonage-status-panel
    sidecar:
      dashboards:
        enabled: true
        label: "grafana_dashboard"
        labelValue: ""
        annotations:
        folderAnnotation: grafana-dashboard-folder
        provider:
          allowUiUpdates: true
          foldersFromFilesStructure: true
  # -- Настройки prometheus
  prometheus:
    prometheusSpec:
      replicas: 1
      serviceMonitorSelectorNilUsesHelmValues: false
      ## -- Как долго хранить метрики
      retention: 1d
      ## -- Максимальный размер метрик
      retentionSize: ""

Заполнение параметров подключения к удалённому хранилищу Mimir

kube-prometheus-stack:
  grafana:
    sidecar:
      # -- включить mimir в качестве источника данных
      datasources:
        enabled: true
        defaultDatasourceEnabled: true
        isDefaultDatasource: true
        uid: prometheus
        url: http://mimir-nginx:80/prometheus
     
  prometheus:
    prometheusSpec:
      # -- включить mimir в качестве долгосрочного хранилища
      remoteWrite:
      - url: http://mimir-nginx:80/api/v1/push

Шаг 4: Установка чарта Monitoring с помощью Helm в Kubernetes-кластер

Выполните установку чарта Monitoring в namespace, наименование которого указали на шаге 2 в конфигурационном файле values-monitoring.yaml. Namespace будет создан во время установки, если не был создан ранее.

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

helm upgrade --install elma365-monitoring elma365/monitoring -f values-monitoring.yaml -n monitoring --create-namespace 

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

Установка компонента дополнений средств мониторинга автоматически не включает мониторинг и дэшборды на стороне приложения ELMA365.

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

Подробнее о включении мониторинга сервисов на стороне приложения ELMA365 читайте в статье «Включение мониторинга в ELMA365 Enterprise».

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

Удалить чарт Monitoring с помощью Helm в Kubernetes-кластере

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

Перед удалением компонента дополнений Monitoring отключите мониторинг на стороне приложения ELMA365.

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

  1. Чтобы удалить чарт elma365-monitoring в namespace monitoring, выполните команду:

helm uninstall elma365-monitoring -n monitoring

  1. CRD, созданные чартом elma365-monitoring, не удаляются по умолчанию и должны быть очищены вручную пользователем с правами cluster-admin:

kubectl delete crd alertmanagerconfigs.monitoring.coreos.com
kubectl delete crd alertmanagers.monitoring.coreos.com
kubectl delete crd podmonitors.monitoring.coreos.com
kubectl delete crd probes.monitoring.coreos.com
kubectl delete crd prometheusagents.monitoring.coreos.com
kubectl delete crd prometheuses.monitoring.coreos.com
kubectl delete crd prometheusrules.monitoring.coreos.com
kubectl delete crd scrapeconfigs.monitoring.coreos.com
kubectl delete crd servicemonitors.monitoring.coreos.com
kubectl delete crd thanosrulers.monitoring.coreos.com

  1. Если при удалении CRD более 5 минут остается в статусе Terminating, произведите патчинг этой CRD командой:

kubectl patch crd/MY_CRD_NAME -p '{"metadata":{"finalizers":[]}}' --type=merge

install-audit-service.html monitoring-databases.html