---
title: How to Retrieve Cluster Metrics
url: https://docs.vultr.com/products/compute/clusters/how-to-retrieve-cluster-metrics
description: Retrieve GPU and fabric performance metrics for all instances in a Vultr cluster with configurable time periods of 1, 7, or 30 days via the API.
publish_date: 2026-04-17T14:09:18.538440Z
last_updated: 2026-04-23T16:41:45.844300Z
---

Retrieving cluster metrics returns GPU and fabric performance data for all instances in a cluster. This is useful for monitoring cluster health, identifying performance bottlenecks, and tracking resource utilization.

This guide explains how to retrieve cluster metrics using the Vultr API.

1. Send a `GET` request to the [**List Clusters** endpoint](https://www.vultr.com/api/#tag/clusters/operation/list-clusters) to retrieve all clusters.

    ```console
    $ curl "https://api.vultr.com/v2/clusters" \
        -X GET \
        -H "Authorization: Bearer ${VULTR_API_KEY}"
    ```

    Note the `id` of the cluster for which you want to retrieve metrics.

1. Send a `GET` request to the [**Get Cluster Metrics** endpoint](https://www.vultr.com/api/#tag/clusters/operation/get-cluster-metrics) to retrieve metrics for the cluster. Replace `{cluster-id}` with the cluster id. Optionally add the `period` query parameter to specify the time range: `-1days` (default), `-7days`, or `-30days`.

    ```console
    $ curl "https://api.vultr.com/v2/clusters/{cluster-id}/metrics?period=-7days" \
        -X GET \
        -H "Authorization: Bearer ${VULTR_API_KEY}"
    ```

    The response contains GPU and fabric metrics for all instances in the cluster.