---
title: "Get database cluster metrics"
method: GET
path: "/databases/clusters/{database}/metrics"
tags: ["Database Clusters"]
---

# Get database cluster metrics

`GET /databases/clusters/{database}/metrics`

## Request

- Base URL: `https://cloud.laravel.com/api`
- URL: `https://cloud.laravel.com/api/databases/clusters/{database}/metrics`
- Auth: HTTP bearer

Get metrics for a specific database cluster.

`replica_lag` is always empty on this endpoint, and `connections` is only populated for AWS RDS clusters.

## Path parameters

- `database` string, nullable, required

## Query parameters

- `period` '1h' | '6h' | '24h' | '3d' | '7d' | '30d'

## Response `200`

- object
  - `data` object, required
    - `cpu_usage` object, required
      - `data` object[], required
        - `x` string, required
        - `y` number, required
      - `average` number, required
      - `max` number, required
    - `compute_hours` object, required
      - `data` object[], required
        - `x` string, required
        - `y` number, required
      - `total` number, required
    - `memory_usage` object, required
      - `data` object[], required
        - `x` string, required
        - `y` number, required
      - `current` number, required
      - `min` number, required
      - `max` number, required
    - `writes` object, required
      - `data` object[], required
        - `x` string, required
        - `y` number, required
      - `total` number, required
    - `storage_usage` object, required
      - `data` object[], required
        - `x` string, required
        - `y` number, required
      - `current` number, required
    - `replica_lag` string[], required
    - `connections` union, required
      - object
        - `data` object[], required
          - `x` string, required
          - `y` number, required
        - `current` number, required
        - `max` number, required
      - string[]
  - `meta` object, required
    - `period` string, required
    - `available_periods` string[], required

## Other responses

- `403`: Authorization error
- `404`: Not found
- `422`: Validation error

---

[API](https://skmtc.dev/laravel/apis/laravel-cloud.md) - [All operations](https://skmtc.dev/laravel/apis/laravel-cloud/llms.txt) - [OpenAPI document](https://skmtc.dev/laravel/apis/laravel-cloud/revisions/af603f54ff33?raw)