Query usage data from Functions

Query the Consumption dataset from the GraphiQL Playground for the compute time and the invocations a function consumed.

Last updated

View as Markdown Agent setup

The workloadConsumptionMetrics dataset lets you get real-time aggregated data related to consumption and usage of Azion products, including Functions.

The information can be accessed through the GraphQL API, allowing you to transfer this data to a third-party platform, and enabling you to further analyze and review. Additionally, the data is available for up to 24 months.

You read the compute time and the invocations of Functions from the GraphiQL Playground.

Query the compute time and invocations

To read both metrics for a period:

  1. Access the GraphiQL Playground by going to the following link: https://api.azion.com/v4/consumption/graphql.
    • You must be logged in to your Azion account. Otherwise, the endpoint returns an error message.
  2. Send a query following this format:
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: 1531930033
09 metricNameIn: ["invocations", "compute_time"]
10 }
11 aggregate: {
12 sum: accounted
13 }
14 limit: 10000
15 groupBy: [clientId, workloadId, productId, metricName, region]
16 ) {
17 clientId
18 workloadId
19 productId
20 metricName
21 region
22 total: sum
23 }
24}

Where:

FieldDescription
filterDefines the criteria used to filter the data returned by the query.
tsRangeA subfield of filter. Specifies a time range for filtering data. It includes begin and end fields to define the start and end timestamps. Format: "YYYY-MM-DDTHH:mm:ss"; example: "2024-04-11T00:00:00".
sum: accountedAs a subfield of aggregate, calculates the total accounted usage for events matching the query’s filters and groups.
limitSpecifies the maximum number of results to return. System maximum: 10000.
groupBySpecifies the fields by which the query results should be grouped. Example: [clientId, metricName].
productIdUnique identifier of the product being used. In this case, 1531930033 for Functions.
metricNameName of the calculated metric for analytics. Example: invocations or compute_time.

This example retrieves data for the total number of invocations or compute time used by Functions. The results are grouped by clientId and workloadId. To learn more about the available fields, check the Consumption GraphQL API Fields documentation.

  1. The response carries a JSON object similar to this:
JSON
01{
02 "data": {
03 "workloadConsumptionMetrics": [
04 {
05 "clientId": "12345a",
06 "workloadId": 1234567890,
07 "productId": 1531930033,
08 "metricName": "invocations",
09 "region": "United States",
10 "Total": 816931
11 },
12 {
13 "clientId": "67890a",
14 "workloadId": 1987654321,
15 "productId": 1531930033,
16 "metricName": "invocations",
17 "region": "Europe",
18 "Total": 33134
19 },
20 {
21 "clientId": "111111b",
22 "workloadId": 1231231230,
23 "productId": 1531930033,
24 "metricName": "compute_time",
25 "region": "All Other Regions",
26 "Total": 436363.41
27 }
28 ]
29 }
30}

Where:

FieldDescription
clientIdClient unique identifier on Azion. Example: 8437r.
workloadIdIdentifier for the workload associated with the usage. Example: 4829301746.
productIdUnique identifier of the product being used. In this case, 1531930033 for Functions.
metricNameName of the measured metric for analytics. Example: invocations or compute_time.
regionGeographical region where the usage was recorded. Example: Europe.
totalThe result of the sum. For compute_time, the total execution time of Functions in seconds, such as 436363.41. For invocations, the total number of invocations, such as 33134.

To know more about the available fields, check the Consumption GraphQL API Fields documentation.