# 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 [<mark style="color:blue;">API reference</mark>](https://api.ionos.com/docs/monitoring/v1/)
2. Install [<mark style="color:blue;">grafana</mark>](https://grafana.com/docs/grafana/latest/setup-grafana/installation/debian/)
3. Generate the first token
4. curl -uusername:password [<mark style="color:blue;">https://api.ionos.com/auth/v1/tokens/generate</mark>](https://api.ionos.com/auth/v1/tokens/generate) or -n if you use [<mark style="color:blue;">netrc</mark>](https://everything.curl.dev/usingcurl/netrc.html)
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 <a href="#maasapigrafana-adddatasourcetografana" id="maasapigrafana-adddatasourcetografana"></a>

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

![](https://1737632334-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MifAzdGvKLDTtvJP8sm%2Fuploads%2Fgit-blob-f363c2c685557729ccb74031401183ccb5aa612a%2Fgrafana_integration.png?alt=media\&token=474cc297-5271-4dbb-a7e4-4ae53cd574f3)

#### Data source

**HTTP**

* **URL:** `https://api.ionos.com/telemetry/`
*

{% hint style="warning" %}
**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 [<mark style="color:blue;">Prometheus Documentation</mark>](https://prometheus.io/docs/prometheus/latest/querying/api/).
{% endhint %}

**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

![](https://1737632334-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MifAzdGvKLDTtvJP8sm%2Fuploads%2Fgit-blob-daa165fba7952281180dba0a9927f40be7041f0f%2Fgrafana-integration-2.png?alt=media\&token=adbbe862-4e20-4f2c-981f-0a0045621a7f)

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`