Grafana Integration

Grafana is an open source platform for data visualization, monitoring, and analysis. You may integrate this software with the Monitoring as a Service for more convenient use.

1. Go to the API reference
2. Install grafana
3. Generate the first token
4. curl -uusername:password https://api.ionos.com/auth/v1/tokens/generate or -n if you use netrc
5. It is also possible to query the metrics using curl:

curl -H "Authorization: Bearer ${TOKEN}" https://api.ionos.com/telemetry/api/v1/query?query=instance\_cpu\_utilization\_average

Add data source to Grafana

• Login to Grafana
• Configuration (on the left side)
• Data source

Integration icon

Data source

HTTP

• URL: https://api.ionos.com/telemetry/

Configuration requirements: Ensure that you update the URL with the required query string parameters and include a valid Authorization header. The Telemetry API is modeled after the Prometheus Query API. For more information, refer to the Prometheus Documentation.

Custom HTTP Headers

• Authorization Value: Bearer eyJ0eXAiOiJK
• HTTP Methods: GET and POST
• Save and test
• Go to Explore (on the left side)
• Choose the new Data source
• In the Metrics Browser, write instance
• Choose one of the metrics
• Run query

Integration icon

You can query on these metrics now:

series whitelist:

- instance_cpu_utilization_average

- instance_network_in_packets

- instance_network_out_bytes

- instance_network_in_bytes

- instance_network_out_packets

- instance_volumes_read_bytes

- instance_volumes_write_bytes

- instance_volumes_read_ops

- instance_volumes_write_ops