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

# Obter métricas da aplicação

> Obtenha o histórico de CPU, RAM e rede de uma aplicação com GET /v2/apps/{app_id}/metrics: até 288 pontos nas últimas 24 horas, um a cada 5 minutos.

<ParamField header="Authorization" type="string" placeholder="Chave da API" required>
  A chave da API para sua conta. Você pode encontrá-la nas [configurações da conta](https://squarecloud.app/pt-br/account/security).
</ParamField>

Requer uma chave de API com o [escopo](/pt-br/api-reference/authentication#escopos) `apps:read`.

Este endpoint retorna o uso histórico de recursos em vez do snapshot atual: até 288 pontos de dados cobrindo as últimas 24 horas, amostradas a cada 5 minutos, para CPU, RAM e rede. Os pontos vêm do mais recente para o mais antigo. Use-o para renderizar um gráfico de uso ou identificar tendências ao longo do tempo; para os números atuais e ao vivo da aplicação, use [Obter status da aplicação](/pt-br/api-reference/endpoint/apps/status) ou os eventos `status` dos [Logs em tempo real](/pt-br/api-reference/endpoint/apps/realtime).

A coleta de métricas exige pelo menos **512 MB de RAM** alocados para a aplicação; aplicações menores retornam `METRICS_NOT_SUPPORTED`. Os resultados são cacheados por 2.5 minutos por (proprietário, aplicação), e o endpoint possui limite de taxa de 10 requisições a cada 5 segundos por usuário, com um bloqueio curto ao atingir esse limite.

## Parâmetros

<ParamField path="app_id" type="string" placeholder="ID da Aplicação" required>
  O ID da aplicação. Você pode encontrá-lo na URL da sua aplicação no dashboard.
</ParamField>

## Resposta

<ResponseField name="status" type="string">
  Indica se a chamada foi bem-sucedida: `success` se foi, `error` se não.
</ResponseField>

<ResponseField name="response" type="array">
  O conteúdo da resposta.

  <Expandable title="Alternar objeto">
    <ResponseField name="date" type="string">
      A data em formato ISO.
    </ResponseField>

    <ResponseField name="cpu" type="number">
      A porcentagem de uso da CPU no ponto de tempo informado.
    </ResponseField>

    <ResponseField name="ram" type="number">
      O uso de RAM em MB no ponto de tempo informado.
    </ResponseField>

    <ResponseField name="net" type="int[]">
      Um array representando o total de rede usado. Primeiro é entrada (input), segundo é saída (output).
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseExample>
  ```json theme={"system"}
  {
      "status": "success",
      "response": [
          {
              "date": "2025-08-13T12:55:01.348Z",
              "cpu": 0.45,
              "ram": 111.27,
              "net": [
                  16834,
                  126
              ]
          },
          {
              "date": "2025-08-13T12:50:01.349Z",
              "cpu": 0.45,
              "ram": 111.22,
              "net": [
                  16834,
                  126
              ]
          },
          {
              "date": "2025-08-13T12:45:01.350Z",
              "cpu": 0.58,
              "ram": 111.36,
              "net": [
                  16834,
                  126
              ]
          },
          {
              "date": "2025-08-13T12:40:01.348Z",
              "cpu": 0.43,
              "ram": 118.44,
              "net": [
                  16834,
                  126
              ]
          }
      ]
  }
  ```
</ResponseExample>

## Erros comuns

| Código | HTTP | Significado |
| - | - | - |
| `METRICS_NOT_SUPPORTED` | 400 | A aplicação tem menos de 512 MB de RAM alocados e não coleta métricas. |

## Relacionados

* CLI: [`squarecloud app metrics`](/pt-br/cli-reference/status-and-metrics#squarecloud-app-metrics)
* SDKs: [`api.apps.metrics()`](/pt-br/sdks/js/managing_application) (JavaScript), [`client.apps.metrics()`](/pt-br/sdks/py/managing_application) (Python), [`c.Apps.Metrics()`](/pt-br/sdks/go/managing_application) (Go)


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