---
title: "Get environment metrics"
method: GET
path: "/environments/{environment}/metrics"
tags: ["Environments"]
---

# Get environment metrics

`GET /environments/{environment}/metrics`

## Request

- Base URL: `https://cloud.laravel.com/api`
- URL: `https://cloud.laravel.com/api/environments/{environment}/metrics`
- Auth: HTTP bearer

Get metrics for a specific environment.

Each metric is read separately; one that could not be read is `{"error": true}` while the rest are
returned. For `http_response_count`, `average` holds each series' sum over the period and `total` the
sum of all of them. `min` and `max` are bounds for charting the series.

## Path parameters

- `environment` string, required

## Query parameters

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

## Response `200`

- object
  - `data` object, required
    - `cpu_usage` union, required
      - object
        - `labels` string[], required
        - `data` object[], required
          - `x` string, required
          - `y` number[], required
        - `average` number[], required
        - `min` number, required
        - `max` number, required
      - object
        - `error` boolean, required
    - `memory_usage` union, required
      - object
        - `labels` string[], required
        - `data` object[], required
          - `x` string, required
          - `y` number[], required
        - `average` number[], required
        - `min` number, required
        - `max` number, required
      - object
        - `error` boolean, required
    - `http_response_count` union, required
      - object
        - `labels` string[], required
        - `data` object[], required
          - `x` string, required
          - `y` number[], required
        - `total` integer, required
        - `average` integer[], required
        - `min` integer, required
        - `max` integer, required
      - object
        - `error` boolean, required
    - `replica_count` union, required
      - object
        - `labels` string[], required
        - `data` object[], required
          - `x` string, required
          - `y` integer[], required
        - `average` integer[], required
        - `min` integer, required
        - `max` integer, required
      - object
        - `error` boolean, required
    - `web_workers_count` union, required
      - object
        - `labels` string[], required
        - `data` object[], required
          - `x` string, required
          - `y` number[], required
        - `average` number[], required
        - `min` number, required
        - `max` number, required
      - object
        - `error` boolean, required
  - `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)