L.7.4 Customize configuration files
Before you can use Grafana and Prometheus, you must specify in the Prometheus configuration how to access the Swyx Core HealthMonitor.
The "Monitoring" directory is part of the Swyx Core HealthMonitor file package.
1 Copy the contents of the "Monitoring" directory to the Linux VM where you have set up Docker.
2 Open "Monitoring/prometheus/prometheus.yml" in a text editor and search for the "SwyxWare Job":
# Swyx.Core.HealthMonitor
- job_name: "SwyxWare"
static_configs:
- targets:
- <swyxware ip>:5000
3 Replace <swyxware ip> with the IP address of the SwyxServer.
4 If you have configured the HealthMonitor on a port other than 5000, adjust it accordingly.
5 If you want to monitor multiple Swyx systems, add each one on a separate line below "targets."
Example:
# Swyx.Core.HealthMonitor
- job_name: "SwyxWare"
static_configs:
- targets:
- 10.0.0.1:5000
- 10.0.0.2:5000
6 If you want to monitor Windows performance counters and install "sonar-perfmon" for this purpose (see below), remove the comment characters from the "sonar" job and enter the IP address and the "sonar-perfmon" port of the Swyx system there as well:
# sonar-perfmon windows performance counter
- job_name: sonar
static_configs:
- targets:
- 10.0.0.1:5001
7 Save the file.
The supplied configuration sets port 3000 for Grafana. If you want to use a different port, change "docker-compose.yml" as follows:
8 Open "Monitoring/docker-compose.yml" with a text editor.
9 To set the port to 8080, for example, change the port configuration for the Grafana service from
- "3000:3000"
to
- "8080:3000"
10 In the delivery state of the docker-compose.yml file, the Prometheus service is configured so that it is only accessible from the Grafana container, not from the host and not from other systems.
11 If you want to access the Prometheus web interface e.g. for troubleshooting, add a "Ports:" definition in the file.
Example:
ports:
- "9090:9090"