---
title: Hyperdrive exposes database connection pool size metrics
description: Hyperdrive configurations now export connection pool size metrics via GraphQL and a new dashboard chart.
image: https://developers.cloudflare.com/changelog-preview.png
---

> Documentation Index  
> Fetch the complete documentation index at: https://developers.cloudflare.com/changelog/llms.txt  
> Use this file to discover all available pages before exploring further. 

[Skip to content](#%5Ftop) 

# Changelog

New updates and improvements at Cloudflare.

[ Subscribe to RSS ](https://developers.cloudflare.com/changelog/rss/index.xml) [ View RSS feeds ](https://developers.cloudflare.com/fundamentals/new-features/available-rss-feeds/) 

![hero image](https://developers.cloudflare.com/_astro/hero.CVYJHPAd_26AMqX.svg) 

[ ← Back to all posts ](https://developers.cloudflare.com/changelog/) 

## Hyperdrive exposes database connection pool size metrics

May 15, 2026 

[ Hyperdrive ](https://developers.cloudflare.com/hyperdrive/)[ Workers ](https://developers.cloudflare.com/workers/) 

You can now view the size of your Hyperdrive database connection pools, giving you the ability to self-diagnose connection issues. Using the Cloudflare dashboard or the `hyperdrivePoolSizesAdaptiveGroups` dataset in the [GraphQL Analytics API](https://developers.cloudflare.com/analytics/graphql-api/getting-started/), you can see `waitingClients`, `currentPoolSize`, `availablePoolSlots`, and `maxPoolSize` for each of your configurations.

A new **Pool connections** chart has been added to the **Metrics** tab of each Hyperdrive configuration in the [Cloudflare dashboard ↗](https://dash.cloudflare.com). You can use the location selector to drill down into specific locations hosting your connection pool by airport code.

![Hyperdrive pool size metrics chart](https://developers.cloudflare.com/_astro/hyperdrive-pool-size-metrics-chart.DZxLTFgB_3zcIK.webp) 

The chart shows:

* **Waiting clients**: Client requests waiting for an available connection.
* **Open connections**: Active connections to your database.
* **Pool size maximum**: Your configured origin connection limit.

Connection contention appears as a spike in waiting clients, or when open connections consistently approach the pool size maximum. If your open connections regularly approach this limit, consider contacting Cloudflare to [increase your Hyperdrive connection limit](https://developers.cloudflare.com/hyperdrive/platform/limits/#request-a-limit-increase).

#### Pool size metrics

The `hyperdrivePoolSizesAdaptiveGroups` dataset in the [GraphQL Analytics API](https://developers.cloudflare.com/analytics/graphql-api/getting-started/) exposes the following key connection pool metrics for each Hyperdrive configuration:

Under `avg`:

* **`currentPoolSize`** — Average number of connections currently open in the pool.
* **`availablePoolSlots`** — Average number of pool connections available for checkout.
* **`waitingClients`** — Average number of clients waiting for a connection from the pool.

Under `max`:

* **`maxPoolSize`** — Configured maximum size of the connection pool.
* **`currentPoolSize`** — Peak number of connections open in the pool.
* **`waitingClients`** — Peak number of clients waiting for a connection from the pool.

For more information, refer to [Metrics and analytics](https://developers.cloudflare.com/hyperdrive/observability/metrics/) and [Connection pooling](https://developers.cloudflare.com/hyperdrive/concepts/connection-pooling/).

```json
{"@context":"https://schema.org","@type":"BlogPosting","@id":"https://developers.cloudflare.com/changelog/post/2026-05-15-hyperdrive-pool-size-metrics/#page","headline":"Hyperdrive exposes database connection pool size metrics · Changelog","description":"Hyperdrive configurations now export connection pool size metrics via GraphQL and a new dashboard chart.","url":"https://developers.cloudflare.com/changelog/post/2026-05-15-hyperdrive-pool-size-metrics/","inLanguage":"en","image":"https://developers.cloudflare.com/changelog-preview.png","dateModified":"2026-05-15","datePublished":"2026-05-15","publisher":{"@type":"Organization","name":"Cloudflare","url":"https://www.cloudflare.com/"},"isPartOf":{"@type":"WebSite","@id":"https://developers.cloudflare.com/#website","name":"Cloudflare Docs","url":"https://developers.cloudflare.com/"}}
```