Build a custom Grafana dashboard

Add a Grafana panel that plots Real-Time Metrics data through the Azion data source, map its response fields, and save the dashboard.

Last updated

View as Markdown Agent setup

You can build a Grafana dashboard of your own, with panels that send GraphQL queries to Real-Time Metrics through the Azion data source plugin. Each panel plots the data you choose in its query. To import the ready-made Data Transferred dashboard instead, refer to Import the pre-built Grafana dashboard.

Prerequisites

Add a panel that queries Real-Time Metrics

A panel holds one GraphQL query, and the Azion data source sends it to the Real-Time Metrics API. The query on this page reads the httpMetrics dataset, which records the requests of your applications. It returns the data transferred per minute over 24 hours:

GraphQL
01query DataTransferredOverTime {
02 httpMetrics(
03 limit: 2000
04 filter: { tsRange: { begin: "2026-01-01T12:00:00.000Z", end: "2026-01-02T12:00:00.000Z" } }
05 groupBy: [ts]
06 orderBy: [ts_ASC]
07 ) {
08 ts
09 dataTransferredIn
10 dataTransferredOut
11 dataTransferredTotal
12 }
13}

Replace the begin and end values with the range you want to plot. Without limit, the API returns 10 rows, so limit: 2000 keeps every minute of a 24-hour range.

The query returns one row for each minute that had traffic, in time order:

JSON
01{
02 "data": {
03 "httpMetrics": [
04 {
05 "ts": "2026-01-01T13:04:00Z",
06 "dataTransferredIn": 13094.0,
07 "dataTransferredOut": 2649889.0,
08 "dataTransferredTotal": 2662983.0
09 },
10 {
11 "ts": "2026-01-01T13:06:00Z",
12 "dataTransferredIn": 7470.0,
13 "dataTransferredOut": 986551.0,
14 "dataTransferredTotal": 994021.0
15 },
16 …
17 ]
18 }
19}

The values are in bytes, and dataTransferredTotal is the sum of dataTransferredIn and dataTransferredOut. For every field of the dataset, refer to Real-Time Metrics GraphQL fields.

To add the panel in Grafana:

Open the dashboards

In the Grafana menu, select Dashboards.

Create a dashboard

Select New > New Dashboard.

Add a panel

In the Add panel card, select Add a new panel.

Select the Azion data source

In the Data source list, select Azion.

Paste the query

In the query code box, paste the DataTransferredOverTime query.

The panel preview reads the rows of the query through the Azion data source.

To start from a Real-Time Metrics chart in Azion Console, open the chart’s More options menu and select Copy query. The copied text holds the query under # QUERY and the values of its variables under # VARIABLES. Write each value into the query in place of its variable before you paste it. For the steps, refer to Export a chart’s data and query.

Map the response fields

Five optional fields tell the panel how to read the rows the query returns. Which ones a panel needs depends on its visualization and on what the graph shows. The five fields take these values:

FieldWhat it takes
Data pathThe value Metrics.
Time pathThe path to the timestamp of each row, delimited by dots. The DataTransferredOverTime query returns the timestamp in ts.
Time formatThe format of that timestamp, written in moment.js format.
Group byThe field that groups the aggregated data into series.
Alias byThe name and value a field shows in the legend.

Choose a visualization and save

The visualization sets how the panel draws the rows. A query grouped by ts, such as DataTransferredOverTime, returns one row per time bucket.

To finish the panel in Grafana:

Select a visualization

In the Visualization list, select a visualization type. For example: Time series.

Save the dashboard

Select Save to apply the configuration.

The dashboard keeps the panel with its query, its field mapping, and its visualization.

Next steps

Export a chart's data and queryCopy the query behind any Real-Time Metrics chart and reuse it in a panel.Real-Time Metrics fieldsEvery dataset and field a panel query can select, with its type.Import the pre-built Grafana dashboardAdd the ready-made Data Transferred dashboard to Grafana without writing a query.QueriesFilters, aggregations, grouping, and ordering for the queries your panels send.