Query usage data from Tiered Cache

Read the requests Tiered Cache processed and the data it transferred, with a consumption query in the GraphiQL Playground.

Last updated

View as Markdown Agent setup

The workloadConsumptionMetrics dataset returns aggregated consumption data for Azion products, including Tiered Cache. You query it through the GraphQL API, and the data is available for up to 24 months.

This guide runs the query in the GraphiQL Playground. The same query works from any GraphQL client that sends your credentials.

Prerequisites

  • An Azion account, signed in. The Playground returns an error message for a request that carries no session.
  • Access to the GraphiQL Playground.

Query the requests and the data transferred

The query filters the dataset by product and by a time range, then sums the accounted usage per metric. To run it:

Open the Playground

Go to https://api.azion.com/v4/consumption/graphql.

Enter the query

The productId 1564082375 is Tiered Cache. Adjust begin and end to the period you want to read:

GraphQL
01query {
02 workloadConsumptionMetrics(
03 filter: {
04 tsRange: {
05 begin: "2025-02-01T00:00:00",
06 end: "2025-03-01T00:00:00",
07 }
08 productId: 1564082375
09 metricNameIn: ["data_transferred_total", "requests"]
10 }
11 aggregate: {
12 sum: accounted
13 }
14 limit: 10000
15 groupBy: [clientId, workloadId, productId, metricName]
16 ) {
17 clientId
18 workloadId
19 productId
20 metricName
21 total: sum
22 }
23}
Run the query and read the response

The response carries one object per group, with the summed usage in total:

JSON
01{
02 "data": {
03 "workloadConsumptionMetrics": [
04 {
05 "clientId": "0000z",
06 "workloadId": 7584931026,
07 "productId": 1564082375,
08 "metricName": "requests",
09 "total": 7
10 },
11 {
12 "clientId": "0000z",
13 "workloadId": 7584931026,
14 "productId": 1564082375,
15 "metricName": "data_transferred_total",
16 "total": 35677128
17 },
18 {
19 "clientId": "0000z",
20 "workloadId": 1938475620,
21 "productId": 1564082375,
22 "metricName": "data_transferred_total",
23 "total": 62854832
24 },
25 {
26 "clientId": "0000z",
27 "workloadId": 1938475620,
28 "productId": 1564082375,
29 "metricName": "requests",
30 "total": 8748041
31 },
32 {
33 "clientId": "0000z",
34 "workloadId": 4829103746,
35 "productId": 1564082375,
36 "metricName": "requests",
37 "total": 797683
38 }
39 ]
40 }
41}

You now have the requests Tiered Cache processed and the bytes it transferred in the period, per workload.

Query fields

FieldWhat it carries
filterThe criteria that narrow the returned data
tsRangeA subfield of filter, with a begin and an end timestamp in the format YYYY-MM-DDTHH:mm:ss
productIdThe product the rows belong to. Tiered Cache is 1564082375
metricNameInThe metrics to return. This query reads data_transferred_total and requests
aggregateWith sum: accounted, the accounted usage of every event matching the filters and the groups
limitThe maximum number of results. The system maximum is 10000
groupByThe fields the results are grouped by

Response fields

FieldWhat it carries
clientIdThe unique identifier of the client on Azion. For example: 8437r
workloadIdThe identifier of the workload the usage belongs to. For example: 4829103746
productIdThe product the row belongs to
metricNameThe metric the row reports
totalThe summed value of the metric. For data_transferred_total, the bytes Tiered Cache transferred. For requests, the requests it processed

For every field of the dataset, refer to Consumption GraphQL API fields.

Next steps

Tiered CacheThe second cache layer this data measures, with its topologies and its TTL floor.Applications limitsThe purges and the data transfer each service plan includes every month.Real-Time MetricsThe Tiered Cache dataset, read from the Console instead of a query.GraphiQL PlaygroundHow to authenticate and run any other query against the GraphQL API.