> ## Documentation Index > Fetch the complete documentation index at: https://docs.cubehosting.com.br/llms.txt > Use this file to discover all available pages before exploring further. # Métricas do projeto > Memória, processador e rede do projeto em 15 minutos, 1 hora ou 24 horas. 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. ## OpenAPI ````yaml GET /projects/{id}/metrics openapi: 3.1.0 info: title: API da Cube Hosting version: 1.0.0 description: >- Hospede bots de Discord, sites e APIs em Node.js e Python: envie o .zip, inicie, pare, reinicie, leia logs e métricas e cuide das variáveis de ambiente. contact: name: Cube Hosting url: https://discord.gg/pv6D9tUsDV servers: - url: https://app.cubehosting.com.br/api security: - bearerAuth: [] tags: - name: Projetos - name: Controle - name: Logs e métricas - name: Variáveis de ambiente paths: /projects/{id}/metrics: get: tags: - Logs e métricas summary: Métricas do projeto description: >- Memória, processador e rede ao longo do tempo. `15m` traz um ponto a cada 15 segundos; `1h`, um por minuto; `24h`, médias de 5 minutos. As métricas ficam guardadas por 24 horas. Minutos em que o projeto estava parado não têm ponto. operationId: getProjectMetrics parameters: - $ref: '#/components/parameters/ProjectId' - name: window in: query description: A janela de tempo. schema: type: string enum: - 15m - 1h - 24h default: 1h responses: '200': description: Os pontos da janela. content: application/json: schema: $ref: '#/components/schemas/Metrics' example: 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 '400': description: Parâmetro fora do formato. content: application/json: schema: $ref: '#/components/schemas/Error' examples: invalid_request: summary: invalid_request value: status: error code: invalid_request message: Use window 15m, 1h ou 24h. '401': description: Chave ausente, inválida ou revogada. content: application/json: schema: $ref: '#/components/schemas/Error' examples: invalid_api_key: summary: invalid_api_key value: status: error code: invalid_api_key message: >- Chave de API inválida ou revogada. Confira o cabeçalho "Authorization: Bearer " ou crie outra em Chaves de API no painel. '404': description: O projeto não existe ou não é da sua conta. content: application/json: schema: $ref: '#/components/schemas/Error' examples: not_found: summary: not_found value: status: error code: not_found message: Projeto não encontrado. '429': description: Limite de pedidos. Traz o cabeçalho `Retry-After`. content: application/json: schema: $ref: '#/components/schemas/Error' examples: rate_limit_exceeded: summary: rate_limit_exceeded value: status: error code: rate_limit_exceeded message: >- A sua conta passou do limite da API do plano Free: 10 pedidos por minuto. Espere 42 s e tente de novo. too_many_attempts: summary: too_many_attempts value: status: error code: too_many_attempts message: Muitas tentativas. Tente de novo em 15 minutos. '503': description: O servidor dos projetos não respondeu a tempo. Nada foi alterado. content: application/json: schema: $ref: '#/components/schemas/Error' examples: server_unavailable: summary: server_unavailable value: status: error code: server_unavailable message: >- O servidor dos projetos não respondeu. Tente de novo em instantes. x-codeSamples: - lang: bash label: curl source: >- curl "https://app.cubehosting.com.br/api/projects/$PROJECT_ID/metrics?window=24h" \ -H "Authorization: Bearer $CUBE_API_KEY" - lang: javascript label: Node.js source: >- 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`); - lang: python label: Python source: |- 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") components: parameters: ProjectId: name: id in: path required: true description: >- O ID do projeto (26 caracteres). Aparece no painel, no topo do projeto, e em `GET /projects`. schema: type: string pattern: ^[0-9A-HJKMNP-TV-Z]{26}$ example: 01J8Z3W6N0Q4Y7V2K5T9D1H3XA schemas: Metrics: type: object required: - window - intervalSeconds - memoryLimitMb - points properties: window: type: string enum: - 15m - 1h - 24h intervalSeconds: type: integer description: 'Segundos entre um ponto e outro: 15, 60 ou 300.' memoryLimitMb: type: integer description: A memória reservada do projeto. points: type: array items: $ref: '#/components/schemas/MetricPoint' Error: type: object required: - status - code - message properties: status: type: string const: error code: type: string description: Código fixo em inglês. Veja [Códigos de erro](/errors). message: type: string description: Texto em português para mostrar a uma pessoa. additionalProperties: true MetricPoint: type: object required: - time - memoryMb - cpuPercent - networkInBps - networkOutBps properties: time: type: string format: date-time memoryMb: type: integer cpuPercent: type: number description: 100 = um núcleo inteiro. networkInBps: type: integer description: Bytes por segundo recebidos. networkOutBps: type: integer description: Bytes por segundo enviados. securitySchemes: bearerAuth: type: http scheme: bearer description: >- Chave de API da Cube (`cube_…`), criada no painel em **Chaves de API**. Mande como `Authorization: Bearer cube_…`. ````