The Usage tab on the Dashboard provides detailed insight into the actual resource usage of your projects.

Usage tab on the dashboard.

Gain insight into how well your projects are performing with the Usage page, and then take the necessary actions for improvements.

In the header, you can filter the metrics by a specific period of time, project, and function path.

Filter metrics by date, project and function.

There are four sections showing your metrics: Networking, Functions, Builds, and Other. In each section, you can see related metric charts showing detailed data in different dimensions.

The chart of Bandwidth metric.

Networking

Bandwidth

The amount of data your Deployments have received or sent. This metric includes traffic for both Preview and Production Deployments.

Outgoing and Incoming bandwidth can be used to measure the overall traffic of your projects.

  • Outgoing: Outgoing bandwidth measures the amount of data that your Deployments have sent to your users. All the responses from the Edge Network and Serverless Functions are collected as Outgoing bandwidth.
  • Incoming: Incoming bandwidth measures the amount of data that your Deployments have received from your users.

An example of Incoming bandwidth is pageviews that are requested by the browser. All the requests sent to the Edge Network and Serverless Functions are collected as Incoming bandwidth.

Usually for website projects, Incoming bandwidth will be much smaller than Outgoing bandwidth.

Requests

The number of Cached and Uncached requests that your Deployments have received.

Similar to Bandwidth, the Requests metric includes requests for both Preview and Production Deployments.

  • Cached: If a request is served by the cache of Vercel Edge Network, it's considered as a Cached request.
  • Uncached: If a request isn't served by the cache and hits the Origin, it's not cached. In addition, under some specific conditions the request can never be cached. These numbers are considered as Uncached requests.

Functions

Invocations

The number of times your Serverless Functions received a request. This metric does not include Cache Hits.

  • Successfully: All invocations that finished successfully by running your Function.
  • Errored: All invocations where your Function failed before it finished or times where your Function couldn't be invoked due to an unexpected error.
  • Timeout: If your Function was invoked but didn't return before it reached its execution timeout, it'll be counted as a timeout.

When using Incremental Static Regeneration with Next.js, both the revalidate option for getStaticProps and fallback for getStaticPaths will result in a Function invocation.

Execution

The amount of time your Functions have spent computing responses to the requests they’ve received. The value is given in GB-Hours, which is the memory allocated for each Function in GB, multiplied by the time in hours they were running. By default, Functions are allocated 1GB of memory, but can be configured to use more.

  • Completed: The execution time for Functions that were executed and finished successfully.
  • Errored: The execution time for Functions that were executed but failed. The value represents the GB-Hours from when they started until they failed.
  • Timeout: The execution time for Functions that were executed but didn't finish before they reached their execution timeout.

For example:

  • If a function is configured to use 1GB of memory and executes for 1 second, this would be billed at 1 GB-s, requiring 3,600 executions in order to reach a full GB-Hr.
  • If a function is configured to use 3GB of memory that executes for 1 second, this would be billed at 3 GB-s, requiring 1,200 executions to reach a full GB-Hr.

The majority of Serverless Functions will execute for a much shorter duration with a minimal billed duration of 100ms.

Throttles

The number of times that a request to your Functions could not be served because the concurrency limit was hit.

Builds

Build Time

The amount of time that your Deployments have spent being queued or building.

  • Build Time: The amount of time it took your Deployments to get from the building state to a final state.
  • Queued Time: The amount of time it took your Deployments to get from creation to building.

Number of Builds

How many times a build was issued for one of your Deployments.

  • Completed: All builds that successfully completed or were cancelled.
  • Errored: All builds that failed or timed out.

Other

Analytics

The number of individual points of data that were reported from your visitor’s browsers for the Analytics feature.

Image Optimization

The number of Source Images. A Source Image is the original, unaltered image determined by the src prop. If the same Source Image is used multiple times with different transformations, it is only counted once for the current billing period.