search string side menu

BRIX On-Premises > BRIX On-Premises Enterprise > Administering BRIX Enterprise / Enable monitoring parameters in BRIX Enterprise

Enable monitoring parameters in BRIX Enterprise

The process of enabling monitoring for the BRIX application consists of three steps:

  1. Install monitoring tools.
  2. Make changes to the configuration file values-elma365.yaml.
  3. Apply monitoring parameters for BRIX Enterprise.

Step 1: Install monitoring tools

The installation of monitoring tools implies the deployment in the Kubernetes cluster of Prometheus for time series storage and Grafana for visualization. If you already have Prometheus and Grafana deployed, you can skip this step.

You can install monitoring tools in your Kubernetes cluster. For more details, see Install monitoring tools.

Step 2: Make changes to the configuration file values-elma365.yaml

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

Before editing the values-elma365.yaml file, make a backup copy of it, as incorrect parameter settings may cause BRIX application malfunction.

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

Fill out the values-elma365.yaml configuration file to enable monitoring:

  1. To enable monitoring support, specify true in parameter global.monitoring.enabled.
  2. Enable the installation in the Kubernetes cluster of ServiceMonitor for BRIX application services by specifying true in parameter global.monitoring.metrics.enabled. By default, only the basic metrics of BRIX services are given. Providing all metrics is disabled to prevent the monitoring system from being overwhelmed by too many metrics. To enable the provision of a significantly larger number of metrics by the BRIX application services, specify true in parameter global.monitoring.metrics.all. Within the scope of this article, enabling the provision of all metrics is not required.
  3. If the Kubernetes cluster is deployed on the Deckhouse platform, set the value to deckhouse in parameter global.monitoring.provisioner. This will configure the supplied monitoring tools for the target platform.
  4. To install Dashboards (ConfigMap) in the Kubernetes cluster for BRIX application services, specify true in parameter global.monitoring.dashboard.enabled.
  5. If the installation of alerts is needed, set true for global.monitoring.alerts.enabled. This will start the installation of PrometheusRule (CRD) in the Kubernetes cluster for BRIX application services.
  6. To enable export of system performance metrics to the Prometheus storage for data visualization using Grafana, set true for global.monitoring.lowcode.metricExportEnabled.

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

Step 3: Apply monitoring parameters for BRIX Enterprise

You can update monitoring parameters for BRIX Enterprise in two ways: online and offline.

Update parameters online

  1. Determine the version of the chart with which the BRIX application was installed or updated:

helm show chart elma365/elma365

Example of command execution:

enable-monitoring-enterprise-1

After the command execution, you see the chart version information in the version string. Save this value for the next step.

  1. Update the parameters using the values-elma365.yaml configuration file. To do this, execute the following command specifying the installed chart version for the --version flag instead of <elma365-chart-version>:

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

Update parameters offline

Go to directory with downloaded BRIX chart and run the following command:

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

It takes about 10-30 minutes to update the parameters. Wait for it to complete.

autoscaling-service-enterprise.html enterprise-troubleshooting.html