Métricas do projeto

curl

curl "https://app.cubehosting.com.br/api/projects/$PROJECT_ID/metrics?window=24h" \
  -H "Authorization: Bearer $CUBE_API_KEY"

const API = 'https://app.cubehosting.com.br/api';
const headers = { Authorization: `Bearer ${process.env.CUBE_API_KEY}` };

const res = await fetch(`${API}/projects/${process.env.PROJECT_ID}/metrics?window=24h`, { headers });
const { points, memoryLimitMb } = await res.json();
const peak = points.length ? Math.max(...points.map((p) => p.memoryMb)) : 0;
console.log(`Pico de memória: ${peak} de ${memoryLimitMb} MB`);

import os
import requests

API = "https://app.cubehosting.com.br/api"
headers = {"Authorization": f"Bearer {os.environ['CUBE_API_KEY']}"}

r = requests.get(
    f"{API}/projects/{os.environ['PROJECT_ID']}/metrics",
    params={"window": "24h"},
    headers=headers,
    timeout=30,
)
r.raise_for_status()
data = r.json()
peak = max((p["memoryMb"] for p in data["points"]), default=0)
print(f"Pico de memória: {peak} de {data['memoryLimitMb']} MB")

{
  "window": "1h",
  "intervalSeconds": 60,
  "memoryLimitMb": 256,
  "points": [
    {
      "time": "2026-09-26T18:01:00.000Z",
      "memoryMb": 81,
      "cpuPercent": 1.4,
      "networkInBps": 1180,
      "networkOutBps": 290
    },
    {
      "time": "2026-09-26T18:02:00.000Z",
      "memoryMb": 83,
      "cpuPercent": 1.2,
      "networkInBps": 1200,
      "networkOutBps": 300
    }
  ]
}

GET

projects

{id}

metrics

curl

curl "https://app.cubehosting.com.br/api/projects/$PROJECT_ID/metrics?window=24h" \
  -H "Authorization: Bearer $CUBE_API_KEY"

const API = 'https://app.cubehosting.com.br/api';
const headers = { Authorization: `Bearer ${process.env.CUBE_API_KEY}` };

const res = await fetch(`${API}/projects/${process.env.PROJECT_ID}/metrics?window=24h`, { headers });
const { points, memoryLimitMb } = await res.json();
const peak = points.length ? Math.max(...points.map((p) => p.memoryMb)) : 0;
console.log(`Pico de memória: ${peak} de ${memoryLimitMb} MB`);

import os
import requests

API = "https://app.cubehosting.com.br/api"
headers = {"Authorization": f"Bearer {os.environ['CUBE_API_KEY']}"}

r = requests.get(
    f"{API}/projects/{os.environ['PROJECT_ID']}/metrics",
    params={"window": "24h"},
    headers=headers,
    timeout=30,
)
r.raise_for_status()
data = r.json()
peak = max((p["memoryMb"] for p in data["points"]), default=0)
print(f"Pico de memória: {peak} de {data['memoryLimitMb']} MB")

{
  "window": "1h",
  "intervalSeconds": 60,
  "memoryLimitMb": 256,
  "points": [
    {
      "time": "2026-09-26T18:01:00.000Z",
      "memoryMb": 81,
      "cpuPercent": 1.4,
      "networkInBps": 1180,
      "networkOutBps": 290
    },
    {
      "time": "2026-09-26T18:02:00.000Z",
      "memoryMb": 83,
      "cpuPercent": 1.2,
      "networkInBps": 1200,
      "networkOutBps": 300
    }
  ]
}

Memória, processador e rede do projeto ao longo do tempo, as mesmas dos gráficos do painel.

`window`	Intervalo entre pontos	O que é
`15m`	15 segundos	Ao vivo
`1h`	60 segundos	Uma amostra por minuto
`24h`	300 segundos	Médias de 5 minutos

cpuPercent 100 é um núcleo inteiro. A rede vem em bytes por segundo. Minutos em que o projeto estava parado não têm ponto.

Autorizações

Authorization

string

header

obrigatório

Chave de API da Cube (cube_…), criada no painel em Chaves de API. Mande como Authorization: Bearer cube_….

Parâmetros de caminho

string

obrigatório

O ID do projeto (26 caracteres). Aparece no painel, no topo do projeto, e em GET /projects.

Pattern: ^[0-9A-HJKMNP-TV-Z]{26}$

Exemplo:

"01J8Z3W6N0Q4Y7V2K5T9D1H3XA"

Parâmetros de consulta

window

enum<string>

padrão:1h

A janela de tempo.

Opções disponíveis:

15m,

1h,

24h

Resposta

Os pontos da janela.

window

enum<string>

obrigatório

Opções disponíveis:

15m,

1h,

24h

intervalSeconds

integer

obrigatório

Segundos entre um ponto e outro: 15, 60 ou 300.

memoryLimitMb

integer

obrigatório

A memória reservada do projeto.

points

object[]

obrigatório

Show child attributes

Visão geral

Projetos

Controle

Logs e métricas

Variáveis de ambiente

Autorizações

Parâmetros de caminho

Parâmetros de consulta

Resposta