The Usage dashboard gives you direct visibility into your project's API and asset consumption. If you see any unexpected behavior, such as slow responses, errors, or limits being hit, this is where you start.

To access it, navigate to Project Settings > General > Usage.

Usage dashboard

Use this dashboard to:

• Rule Hygraph in or out during incident triage without filing a support ticket.
• See whether a spike is hitting a plan quota or an operational limit, and which metric specifically.
• Track API calls and asset bandwidth per project against your plan limits.
• Monitor RPS, concurrency, and request size per environment before they cause dropped requests.
• Identify which environment is driving consumption without cross-referencing external tools.

#Access

The Usage tab is visible to Admin and Developer roles by default. To grant access to other users, assign them the Read observability data Management API permission.

Data in this dashboard is updated every hour.

To query the same metrics programmatically, see Usage metrics API reference.

#Project quotas

Project quotas show how much of your plan's allocated resources your project has consumed over your billing period. These metrics are scoped to the project, not individual environments. Approaching a limit here means you are approaching a plan boundary, not an operational threshold.

A visual threshold indicates when consumption is approaching the project's limit:

• Orange: 80% of the limit
• Red: 95% of the limit

If you are consistently approaching or exceeding your plan limits, see Manage plan.

#Asset bandwidth

The Asset bandwidth chart shows the total data transferred for assets, such as images, video, and documents, served from your project. The chart shows daily consumption as a bar chart and a cumulative indicator. Hover over any bar to see the exact value for that day.

Example: 40 / 100 GB shows the total asset bandwidth for your billing period against your plan limit.

Asset bandwidth

#API calls

The API calls chart shows total requests made to your Content API. The chart shows daily consumption as a bar chart and a cumulative indicator. Hover over any bar to see the exact value for that day.

Example: 47K / 500K calls shows the total API calls for your billing period against your plan limit.

API calls

#Tech safeguards metrics

Tech safeguards metrics show the operational limits that govern how your API handles traffic at a given moment. These limits exist independently of your plan quotas. Exceeding them affects request behavior directly. For more information on tech safeguards in your plan, see API limits.

You can filter tech safeguard metrics by environment and time range.

• Environment: Filters all metrics to a specific environment.
• Time range: Available options are last 7 days, last 30 days, last 6 months, and last 12 months.

Metrics reflect activity up to the last hourly update. For same-day activity, check back after the next update cycle. Real-time data and minute-level granularity are not available.

#Request Activity

A spike in blocked requests is the clearest signal that something hit an operational ceiling. The Request Activity chart shows two series: requests within limit and requests blocked. This lets you see exactly when that happened and how sustained it was. Hover over any point to see a breakdown tooltip for that day.

Request Activity

#Concurrent operations

The Concurrent operations chart shows separate sparkline charts for concurrent queries and mutations against your project's concurrency limit. Each chart provides concurrent requests data for a given day. Hover over the limit line on any chart to see the following details for a day:

• Maximum concurrent queries / mutations that day
• Your plan's concurrency limit
• Number of requests blocked that day

If your concurrent requests cross your plan limit, they may be blocked. A red dot on the chart indicates that requests were blocked that day.

For more information on concurrency operations in your plan, see API limits - Concurrent operations.

Concurrent operations

#Request size

The Request size chart shows separate sparkline charts for query and mutation request sizes against your project's configured limit. Hover over the limit line on any chart to see the following details for a day:

• Maximum request size for queries / mutations that day
• Your plan's request size limit
• Number of requests blocked that day

Requests that exceed the size limit may be blocked before execution. For more information on request size in your plan, see API limits - Request size.

Request size

#RPS (Requests per second)

The RPS chart shows query and mutation requests per second against your project's rate limit as a sparkline. Hover over the limit line to see the following details for a day:

• Maximum RPS recorded that day
• Number of requests blocked that day

Sustained activity near the threshold indicates your client is sending requests faster than the project is configured to accept. This does not necessarily mean that requests are failing yet, but that the margin is reduced. A red dot on the chart indicates that requests were blocked that day.

For more information on requests per second in your plan, see API limits - Requests per second.

RPS