Filter a Real-Time Metrics dashboard

Narrow every chart of a Real-Time Metrics dashboard to the requests you need, and apply the same filters to a GraphQL query.

Last updated

View as Markdown Agent setup

You can narrow the charts of a Real-Time Metrics dashboard in Azion Console, or apply the same filters to a query with the GraphQL API. For every field, operator, and value type a filter accepts, refer to Filters and time range.

With no filter, a dashboard counts the data of your whole account. A filter keeps only the data whose field matches a value, such as the host, the status code, the request method, or the country. In the GraphQL API, these fields are host, status, requestMethod, and geolocCountryName.

Select your interface once. The prerequisites and each task on this page show only that path.

Prerequisites

  • An application with requests in the time range you read.
  • A host your workload answers on, such as www.example.com, to combine filters.

Add a filter

This task keeps the requests that returned an error, with a status code of 400 or higher. Every chart of the dashboard then counts only those requests.

To apply the same filter with the GraphQL API, send a POST request to https://api.azion.com/v4/metrics/graphql. In filter, the statusGte key keeps the status codes of 400 or higher, next to the tsRange that every query requires. The query sums requests for each status code.

Replace [TOKEN VALUE] with your personal token, and the begin and end values with the period you want to read:

Shell
01curl -X POST 'https://api.azion.com/v4/metrics/graphql' \
02 -H 'Content-Type: application/json' \
03 -H 'Authorization: Token [TOKEN VALUE]' \
04 -d '{"query":"query ErrorRequestsByStatus($begin: DateTime!, $end: DateTime!) { httpMetrics(limit: 100, filter: { tsRange: { begin: $begin, end: $end }, statusGte: 400 }, aggregate: { sum: requests }, groupBy: [status], orderBy: [sum_DESC]) { status sum } }","variables":{"begin":"2026-01-01T12:00:00","end":"2026-01-02T12:00:00"}}'

The API answers 200 with one row for each status code of 400 or higher:

JSON
01{
02 "data": {
03 "httpMetrics": [
04 {
05 "status": 496,
06 "sum": 210
07 },
08 {
09 "status": 501,
10 "sum": 198
11 },
12 {
13 "status": 495,
14 "sum": 73
15 },
16 {
17 "status": 404,
18 "sum": 55
19 },
20 {
21 "status": 502,
22 "sum": 31
23 },
24 {
25 "status": 401,
26 "sum": 12
27 },
28 {
29 "status": 400,
30 "sum": 1
31 },
32 {
33 "status": 499,
34 "sum": 1
35 },
36 {
37 "status": 504,
38 "sum": 1
39 }
40 ]
41 }
42}

Each row holds one status code and its request count in the range. A filter key is a field name followed by its operator, such as statusGte or hostEq. For every operator, refer to GraphQL queries.

To filter the dashboard by status code in Azion Console:

Open Real-Time Metrics

Access Azion Console > Real-Time Metrics.

The page opens on Build › Applications › Data Transferred.

Open the Filter popover

In the filter row, select the filter icon, whose tooltip reads Add filter.

Select the Status field

In Filter, select Status.

Select the operator

In Operator, select Greater Than or Equal.

Enter the value

Enter 400 as the value.

Select Apply

A chip under the filter row reads Status greater than or equal: 400. Every chart of the dashboard now counts only the requests with a status code of 400 or higher.

Combine filters

Each filter you add narrows the data again, so the charts keep only the data that matches every filter. This task adds a host to the status filter from Add a filter, to read the errors of one host. Replace www.example.com with a host your workload answers on.

To combine filters with the API, add each one as a key of filter. This query adds hostEq to the statusGte filter:

Shell
01curl -X POST 'https://api.azion.com/v4/metrics/graphql' \
02 -H 'Content-Type: application/json' \
03 -H 'Authorization: Token [TOKEN VALUE]' \
04 -d '{"query":"query ErrorRequestsForHost($begin: DateTime!, $end: DateTime!) { httpMetrics(limit: 100, filter: { tsRange: { begin: $begin, end: $end }, statusGte: 400, hostEq: \"www.example.com\" }, aggregate: { sum: requests }, groupBy: [status], orderBy: [sum_DESC]) { status sum } }","variables":{"begin":"2026-01-01T12:00:00","end":"2026-01-02T12:00:00"}}'

The API answers 200 with the error responses of that host alone:

JSON
01{
02 "data": {
03 "httpMetrics": [
04 {
05 "status": 501,
06 "sum": 198
07 },
08 {
09 "status": 404,
10 "sum": 29
11 },
12 {
13 "status": 504,
14 "sum": 1
15 }
16 ]
17 }
18}

Each row counts only the requests that match both filters.

To keep any of several values of one field, use the In operator with a list. For example, statusIn: [404, 502] in place of statusGte: 400 returns only the rows of 404 and 502 over the same range, with the same counts as in the response of Add a filter.

To add a second filter in Azion Console:

Open the Filter popover

In the filter row, select the filter icon, whose tooltip reads Add filter.

Select the Host field

In Filter, select Host.

Select the Equals operator

In Operator, select Equals.

Enter the host

Enter www.example.com as the value.

Select Apply

A second chip reads Host equals: www.example.com, next to the status chip. Every chart now counts only the requests to that host with a status code of 400 or higher.

The Filter popover states Each combination of operator can only be used once. To keep any of several values of one field, use the in form of the query input, described in Filter with the query input.

Filter with the query input

The query input in the filter row takes filters as one typed expression in Azion Query Language. It also keeps several values of one field at once, which a single Equals filter cannot do. This task keeps the requests that returned 404 or 502.

To filter with the query input in Azion Console:

Open Real-Time Metrics

Access Azion Console > Real-Time Metrics.

Select the query input

In the filter row, select the query input, whose placeholder reads Filter using Azion Query Language syntax....

Enter the expression

Enter status in (404, 502).

While you type, the input suggests fields, then operators, then values. Ctrl + Space, or Cmd + Space, opens the suggestions.

Apply the expression

Press Enter.

Every chart of the dashboard now counts only the requests that returned 404 or 502.

To keep a range of values instead, use between with exactly two values: status between (400, 499) keeps the status codes from 400 to 499. For the syntax of each operator in the query input, refer to Filters and time range. When the input shows a validation message and Refresh stays disabled, refer to Troubleshoot Real-Time Metrics.

Edit or remove a filter

Each applied filter shows as a chip under the filter row. Selecting a chip reopens that filter, and its remove icon deletes it.

To edit a filter in Azion Console:

Open the filter

Under the filter row, select the chip of the filter.

The Filter popover opens with the values of that filter. A lock icon replaces the arrow of the field, because the field cannot change.

Change the operator or the value
Select Apply

The chip shows the new operator or value, and every chart of the dashboard follows the changed filter.

To remove a filter, select the remove icon on its chip, and repeat for each filter you want to remove. The chip disappears, and the charts stop applying that filter.

Switching to a dashboard that reads another dataset clears every filter and keeps the time range.

Next steps

Filters and time rangeEvery field, operator, and value type a filter accepts, and the syntax of the query input.Export a chart's data and queryDownload a filtered chart as CSV, or copy its GraphQL query with the filter values.Build dashboardsEach Build dashboard, the dataset it reads, and what each chart plots.Troubleshoot Real-Time MetricsWhat each validation message of the query input means, and how to fix the expression.