Setting up On-Premise Metrics
Setting up prometheus and grafana (Starting from installer 2022-08.02)
Copy sample file fromconfig-sample/prometheus/prom.ymltoFrom the
Installer'sprometheussub-directoryIntegrationswithinpage,yourclickconfig"Install"folderunder "Prometheus"-
If you want to write prometheus data to a remote prometheus instance, please define these 4 variables :
-
remote_write_url
: The URL of the endpoint to which to push remote writes -
remote_write_external_labels
: The labels to add to your data, to identify the writes from this cluster -
remote_write_username
: The username to use to push the writes -
remote_write_password
: The password to use to push the writes
-
-
You can configure which prometheus components you want to deploy :
-
deploy_prometheus
:true
to deploy prometheus -
deploy_node_exporter
: requires prometheus deployment. Set totrue
to gather data about the k8s nodes. -
deploy_kube_control_plane_monitoring
: requires prometheus deployment. Set totrue
to gather data about the kube controle plane. -
deploy_kube_state_metrics
: requires prometheus deployment. Set totrue
to gather data about kube metrics. -
deploy_element_service_monitors
: Set totrue
to createServiceMonitor
resources into the K8S cluster. Set it totrue
if you want to monitor your element services stack using prometheus. -
You can choose to deploy grafana on the cluster :
-
deploy_grafana
:true
-
grafana_fqdn
: The FQDN of the grafana application -
grafana_data_path
:/mnt/data/grafana
-
grafana_data_size
: 1G
-
-
If doing a POC with self-signed certificates:
-
verify_tls
: Optional. If doing a POC with self-signed certificates, set this to 0. Defaults to 1.
-
For the provided prom.yml, see the following descriptions of the parameters:
For the specified grafana_fqdn
, you will need to provide a crt/key PEM encoded key pair in ~/.element-enterprise-server/config/legacy/certs
prior to running the installer. If our hostname were metrics.airgap.local
, the installer will expect to find metrics.airgap.local.crt
and metrics.airgap.local.key
in the ~/.element-enterprise-server/config/legacy/certs` directory. If you are using Let's Encrypt, you do not need to add these files.
After running the installer, open the FQDN of Grafana. The initial login user is admin
and password is admin
. You'll be required to set a new password, please define one secured and keep it in a safe place.
~