This guide shows the necessary steps to deploy the Grafana monitoring for SwyxWare

Installation:

All config files are in this .zip file: swyxware-monitoring.zip

On the SwyxWare Server

1. Install Sonar (optional: Modify the Sonar.dll.config to fit your environment)
2. Modify the Sonar.config file, by replacing it with the one from the .zip package
3. If you want to install Prometheus and Grafana with Docker, you can skip the next steps
4. Download the Prometheus Windows Files: https://prometheus.io/download/
5. Unpack the files an modify the prometheus.yml by pasting the contents of the prometheus-local.yml into it
6. Start prometheus.exe
7. Install Grafana as described in the docs: 
   https://grafana.com/grafana/download?platform=windows
   http://docs.grafana.org/installation/windows/

On the Monitoring Server

Skip this if you installed it on the SwyxWare Server

1. Install the Docker Community Edition for the Operating System of your choice. For detailed and updated instructions please visit the official documentation.
2. Install Docker Compose for your chosen operating system (https://docs.docker.com/compose/install/)

3. Extract the swyxware-monitoring.zip 

4. Modify the prometheus-docker.yml to fit into your infrastructure

5. Add a firewall rule for port 3000 on your monitoring server. If you want to use a different port to access the Grafana you need to modify the docker-compose.yml file as well. At the Grafana section with port 3000:3000 defined you have to modify it like e.g 8443:3000 if you want to use the port 8443
   
   
6. Start the containers in command line. Remember to navigate into the swyxware-monitoring folder with: 

   docker-compose up -d

Configuration:

Only the Grafana needs to be configured:

1. Navigate to <swyxware-server>:<port>, localhost:<port> or <monitoring-server>:<port> (Grafana requires a current browser like Chrome or Firefox)
2. Log in with the default credentials admin/admin
3. Grafana will ask you to add a datasource. Follow it's instructions. If not, then click on the gear icon on the left and then on datasources.
4. Select Prometheus
   1. URL: http://localhost:9090 or http://prometheus:9090 if you used the Docker method
   2. Confirm with save & test
5. Import the swyxware-dashboard by hovering over the plus icon on the left and pressing import
6. Copy the following ID 10098 in the field or paste the content of the swyxware-dashboard.json file and hit load
7. That's it. Remember to save by clicking on the save icon