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

# Metrics

Metrics report a sandbox's CPU, memory, network, and disk usage by minute. `GET /sandbox/{id}/metrics` returns them at a 60-second step. It is served by the data plane with a [token](https://developers.telnyx.com/docs/edge-compute/sandboxes/authentication.md#sandbox-token), never by the control plane.

```bash API theme={null}
curl -G "$DATA_API/$SANDBOX_ID/metrics" \
  --data-urlencode "from=2026-11-11T19:00:00Z" \
  --data-urlencode "to=2026-11-11T19:30:00Z" \
  -H "Authorization: Bearer $SANDBOX_TOKEN"
```

| Parameter | Description |
| - | - |
| `from`, `to` | RFC 3339 times. The default window is the last 60 minutes. A window over 24 hours is refused with `400 bad_request`. |

```json Output theme={null}
{
  "data": {
    "sandbox_id": "sb-us-east-1-0193c4d2-7f1a-7c2e-9d4b-5a6e8f0c1b2d",
    "from": "2026-11-11T19:00:00Z",
    "to": "2026-11-11T19:30:00Z",
    "step_seconds": 60,
    "latest": {
      "ts": "2026-11-11T19:29:50Z",
      "cpu_cores": 0.84,
      "mem_bytes": 612368384,
      "net_rx_bytes": 48213004,
      "net_tx_bytes": 1902334,
      "disk_bytes": 734003200
    },
    "series": [
      {
        "ts": "2026-11-11T19:00:00Z",
        "cpu_cores_avg": 0.12,
        "cpu_cores_max": 0.97,
        "mem_bytes_avg": 401604608,
        "mem_bytes_max": 455081984,
        "net_rx_bytes": 1048576,
        "net_tx_bytes": 65536,
        "disk_bytes": 524288000
      },
      ...
    ]
  }
}
```

| Metric | Description |
| - | - |
| `cpu_cores` | vCPU in use. `1.0` is one full vCPU. |
| `mem_bytes` | The sandbox's memory use, measured on the host. |
| `net_rx_bytes`, `net_tx_bytes` | Bytes received and sent on the sandbox's network interface during the interval, not since the start. |
| `disk_bytes` | Bytes allocated on the workspace disk. |

`latest` is the most recent sample, or `null` when there is none. Each `series` point summarizes one 60-second interval.

The series covers the sandbox's current run. It restarts at a resume, and samples from before a pause are not served. For a `paused` or `terminated` sandbox, `latest` is `null` and `series` is empty.
