Query Reference
Last updated September 9, 2025
The metric selects what query data is displayed. You can choose one field at a time, and the same metric can be applied to different event types. For instance, Function Wall Time can be selected for edge, serverless, or middleware functions, aggregating each field in various ways.
| Field Name | Description | Aggregations |
|---|---|---|
| Edge Requests | The number of Edge Requests | Count, Count per Second, Percentages |
| Duration | The time spent serving a request, as measured by Vercel's CDN | Sum, Sum per Second, Min/Max, Percentages, Percentiles |
| Incoming Fast Data Transfer | The incoming amount of Fast Data Transfer used by the request. | Sum, Sum per Second, Min/Max, Percentages, Percentiles |
| Outgoing Fast Data Transfer | The outgoing amount of Fast Data Transfer used by the response. | Sum, Sum per Second, Min/Max, Percentages, Percentiles |
| Total Fast Data Transfer | The total amount of Fast Data Transfer used by the response. | Sum, Sum per Second, Min/Max, Percentages, Percentiles |
| Function Invocations | The number of Function invocations | Count, Count per Second, Percentages |
| Function Duration | The amount of Function duration, as measured in GB-hours. | Sum, Sum per Second, Min/Max, Percentages, Percentiles |
| Function CPU Time | The amount of CPU time a Vercel Function has spent responding to requests, as measured in milliseconds. | Sum, Sum per Second, Min/Max, Percentages, Percentiles |
| Incoming Fast Origin Transfer | The amount of Fast Origin Transfer used by the request. | Sum, Sum per Second, Min/Max, Percentages, Percentiles |
| Outgoing Fast Origin Transfer | The amount of Fast Origin Transfer used by the response. | Sum, Sum per Second, Min/Max, Percentages, Percentiles |
| Provisioned Memory | The amount of memory provisioned to a Vercel Function. | Sum, Sum per Second, Min/Max, Percentages, Percentiles |
| Peak Memory | The maximum amount of memory used by Vercel Function at any point in time. | Sum, Sum per Second, Min/Max, Percentages, Percentiles |
| Requests Blocked | All requests blocked by either the system or user. | Count, Count per Second, Percentages |
| ISR Read Units | The amount of Read Units used to access ISR data | Sum, Sum per Second, Min/Max, Percentages, Percentiles |
| ISR Write Units | The amount of Write Units used to store new ISR data | Sum, Sum per Second, Min/Max, Percentages, Percentiles |
| ISR Read/Write | The amount of ISR operations | Sum, Sum per Second, Min/Max, Percentages, Percentiles |
| Time to First Byte | The time between the request for a resource and when the first byte of a response begins to arrive. | Sum, Sum per Second, Min/Max, Percentages, Percentiles |
| Function Wall Time | The duration that a Vercel Function has run | Sum, Sum per Second, Min/Max, Percentages, Percentiles |
| Firewall Actions | The incoming web traffic observed by firewall rules. | Sum, Sum per Second, Unique, Percentages, |
| Optimizations | The number of image transformations | Sum, Sum per Second, Unique, Percentages, |
| Source Size | The source size of image optimizations | Sum, Sum per Second, Min/Max, Percentages, Percentiles |
| Optimized Size | The optimized size of image optimizations | Sum, Sum per Second, Min/Max, Percentages, Percentiles |
| Compression Ratio | The compression ratio of image optimizations | Sum, Sum per Second, Min/Max, Percentages, Percentiles |
| Size Change | The size change of image optimizations | Sum, Sum per Second, Min/Max, Percentages, Percentiles |
Metrics can be aggregated in the following ways:
| Aggregation | Description |
|---|---|
| Count | The number of requests that occurred |
| Count per Second | The average rate of requests that occurred |
| Sum | The sum of the field value across all requests |
| Sum per Second | The sum of the field value as a rate per second |
| Minimum | The smallest observed field value |
| Maximum | The largest observed field value |
| Percentiles (75th, 90th, 95th, 99th) | Percentiles for the field values. For example, 90% of requests will have a duration that is less than the 90th percentile of duration. |
| Percentages | Each group is reported as a percentage of the ungrouped whole. For example, if a query for request groups by hosts, one host may have 10% of the total request count. Anything excluded by the clause is not counted towards the ungrouped whole. |
Aggregations are calculated within each point on the chart (hourly, daily, etc) and also across the entire query window.
The filter bar defines the conditions to filter your query data. It only fetches data that meets a specified condition based on several fields and operators:
| Operator | Description | |
|---|---|---|
| , | The operator that allows you to specify a single value | |
| , | The operator that allows you to specify multiple values. For example, | |
| Filter data values that begin with some specific characters | ||
| Filter data values that end with specific characters | ||
| Numerical operators that allow numerical comparisons |
The clause calculates statistics for each combination of field values. Each group is displayed as a separate color in the chart view, and has a separate row in the table view.
For example, grouping by and will display data broken down by each combination of and .
There are several fields available for use within the Filter and group by:
| Field Name | Description | |
|---|---|---|
| Group by the request's domains and subdomains | ||
| Group by the request's project | ||
| Group by the request's deployment ID | ||
| Group by the request's HTTP response code | ||
| The mapped path used by the request. For example, if you have a dynamic route like and a blog post is , the is | ||
| The path used by the request. For example, if you have a dynamic route like and a blog post is , the is | ||
| The cache status for the request | ||
| Group by the environment ( or ) | ||
| Group by the HTTP request method (, , , etc.) | ||
| Group by the HTTP referrer URL | ||
| Group by the HTTP referrer domain | ||
| Group by the request's IP address | ||
| Group by the request's IP country | ||
| Group by the request's user agent | ||
| The autonomous system number (ASN) for the request. This is related to what network the request came from (either a home network or a cloud provider) | ||
| Group by the region the request was routed to | ||
| Group by the ISR cache region | ||
| Group by cache result | ||
| Group by the WAF action taken by the Vercel Firewall (, , , or ) | ||
| Group by the firewall rule ID | ||
| When , the request would have been subject to version skew but was protected, otherwise . |
Was this helpful?