Skip to main content
GET
Get metrics

Authorizations

X-API-Key
string
header
required

API key for authentication. Each key is bound to a specific account.

Path Parameters

database_id
string
required

Database ID (UUID) or short id (the database_id field, e.g. a1b2c3d4)

Response

Latest metrics snapshot

Latest usage snapshot, refreshed about every 60 seconds. Zero values mean not measured yet.

success
boolean
cpu_used_millicores
integer

CPU in use, millicores

cpu_capacity_millicores
integer

CPU capacity, millicores

mem_used_bytes
integer

Memory in use, bytes

mem_capacity_bytes
integer

Memory capacity, bytes

storage_used_bytes
integer

Storage in use, bytes

storage_capacity_bytes
integer

Storage capacity, bytes

connections_active
integer

Active client connections

connections_max
integer

Connection limit

replication_lag_bytes
integer

Standby/replica lag in bytes (0 without HA or replicas)

archive_lag_bytes
integer

WAL archiving lag in bytes (PostgreSQL)

metrics_updated_at
string

When this snapshot was taken, RFC 3339 (empty before the first sample)

pooled_connections_active
integer

Client connections on the pooler (PostgreSQL)

pooled_connections_max
integer

Pooler connection limit (PostgreSQL)

ops_per_sec
number

Transactions (PostgreSQL), queries (MySQL, ClickHouse) or commands (Valkey) per second. -1 when not measured

cache_hit_pct
number

Share of reads served from memory, percent. -1 when not measured

evictions_per_min
number

Keys removed because memory was full, per minute (Valkey). -1 for other engines

merges_running
integer

Background merges running (ClickHouse). -1 for other engines

compression_ratio
number

Data size before compression divided by size on disk (ClickHouse). -1 for other engines

pooler_server_active
integer

Server connections the pooler is using (PostgreSQL). -1 without a pooler

pooler_server_idle
integer

Idle server connections in the pool (PostgreSQL). -1 without a pooler

pooler_cl_waiting
integer

Client connections waiting for a server connection (PostgreSQL). Above 0 for long means the pool is too small for the load

pooler_maxwait_us
integer

Longest current wait for a server connection, microseconds (PostgreSQL)

pooler_version
string

Pooler version (PostgreSQL)

conn_rejected_total
integer

Connections refused because the limit was reached, since the database started. -1 when not measured

conn_idle_timeout_secs
integer

Seconds after which idle connections are closed. -1 when not set

storage_data_bytes
integer

Part of storage_used_bytes taken by data. -1 when not measured

storage_log_bytes
integer

Part of storage_used_bytes taken by the write-ahead or binary log. -1 when not measured

storage_read_only
boolean

True while storage is at 95% or more and PostgreSQL or MySQL accept reads only. Writes come back below 90%

Last modified on October 5, 2026