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

# Métricas da aplicação

> Retorna as métricas de uma aplicação pelo seu ID, incluindo uso de CPU, RAM, armazenamento e rede nas últimas 24 horas.

**id** `string` *required*

O ID da aplicação cujas métricas serão retornadas. Se a aplicação pertencer a um workspace, informe o ID dele no query parameter `workspace_id`.

**workspace\_id** `string`

Se a aplicação pertencer a um workspace, o ID do workspace. Obrigatório para membros do workspace que agem sobre uma aplicação que não lhes pertence.

### Resposta

**response** `array`

Um array de objetos de métrica da aplicação nas últimas 24 horas.

**Mostrar objeto**

**cpu** `number`

Porcentagem de uso de CPU.

**ram** `number`

Uso de RAM, em MB.

**storage** `number`

Uso de armazenamento, em MB.

**network** `array`

Um array com dois números: `[network_in, network_out]`, representando o tráfego de rede de entrada e de saída, em bytes.

**date** `string`

O timestamp de quando a métrica foi registrada.

```json Response theme={null}
{
  "response": [
    {
      "cpu": 25.5,
      "ram": 512,
      "storage": 1024,
      "network": [1048576, 524288],
      "date": "2026-03-20T19:58:00Z"
    },
    {
      "cpu": 30.2,
      "ram": 510,
      "storage": 1024,
      "network": [2097152, 1048576],
      "date": "2026-03-20T19:59:00Z"
    }
  ]
}
```

### Respostas de erro

**code** `string`

O código de erro que indica o motivo da falha. Valores possíveis:

* `AUTH_TOKEN_MISSING`, `API_KEY_INVALID`, `SESSION_REVOKED`: o header `Authorization` está ausente, a chave de API é inválida ou a sessão do painel foi revogada (`401`).
* `API_KEY_IP_DENIED`, `API_KEY_SCOPE_DENIED`: a chave de API é usada a partir de um IP fora da sua allowlist, ou não tem o escopo que a rota exige (`403`).
* `ACCESS_DENIED`: o recurso pertence a outra conta, ou você não tem a permissão do workspace para ele (`403`).
* `APP_NOT_FOUND`: a aplicação informada não existe.
* `FORBIDDEN`: o usuário não tem permissão para acessar a aplicação.

**message** `string`

Uma mensagem descritiva com detalhes adicionais sobre o erro.

```json Error Response (404) theme={null}
{
  "code": "APP_NOT_FOUND"
}
```

```json Error Response (401) theme={null}
{
  "code": "FORBIDDEN"
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.