Grafana Metrics Example

This README will give instructions on how to run the demonstration on how the NGINX agent can be used to report metrics using prometheus and grafana servers.

Run Grafana Example

Run the following command from the root directory, to start up the agent grafana metrics example. This will create all the services listed in List of Services.

make clean-grafana-example build-grafana-example run-grafana-example

List of Services

The services run by this example are listed below

Service	Port
Grafana	3000
NGINX	8080
AGENT API	8081
Prometheus	9090

Accessing Grafana Dashboard

Grafana Dashboard can be accessed locally via the url http://localhost:3000 with the "admin" as both username and password. On the home screen, select the NGINX Agent dashboard.

Generate traffic for Dashboard

To generate data for the dashboard you can curl the NGINX instance. This will increase nginx_http_status_2xx on

ab -k -c 10 -n 10000 127.0.0.1:8080/

If you monitor the dashboard you'll see the graphs being populated.

Teardown Example

Run the following command from the root directory to shut down example services.

make clean-grafana-example