> ## 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.

# Linha do tempo de quedas

> As quedas do projeto nos últimos 30 dias, com o motivo, o tempo no ar e o reinício automático.

A mesma **Linha do tempo de quedas** da aba Logs do painel, para montar o seu alerta ou relatório. Uma **queda** é o processo sair com código diferente de 0: um erro que ninguém tratou, um sinal ou a memória passando do que o projeto reserva. Sair com 0 ou parar pelo painel não entra.

* Ficam as **50 mais recentes** de cada projeto, dos **últimos 30 dias**; a mais antiga sai primeiro.
* `reason` já vem em pt-BR para mostrar como está: `Sem memória: passou de 512 MB`, `Encerrado pelo sinal SIGSEGV (código 139)` ou `Saiu com erro (código 1)`. A memória (`memoryLimitMb`) é a que o projeto tinha quando caiu: memória nova em Configurações só vale depois de reiniciar, e o reinício automático sobe com a de antes.
* `outcome` diz o que veio depois: `restarting` (o reinício automático dos planos pagos, que espera 1, 2, 4 e 8 s), `crash_loop` (a 5ª queda seguida: o projeto parou) ou `stopped` (sem reinício automático, no Free). `restartedAt` é quando o reinício automático pôs o projeto de volta no ar.
* O log daquele momento vem em [Queda com o log do momento](/api-reference/projects/crash).

Funciona com a chave de leitura.

## Erros comuns

| Código | HTTP | O que fazer |
| - | - | - |
| [`not_found`](/errors#param-not-found) | 404 | Confira o ID do projeto. |

Todos os códigos, com o formato do erro, em [Códigos de erro](/errors).


## OpenAPI

````yaml GET /projects/{id}/crashes
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, veja a análise das visitas dos
    sites, cuide das variáveis de ambiente, faça e baixe backups, volte para uma
    versão anterior, crie bancos de dados (PostgreSQL, MySQL, MongoDB e Redis),
    guarde arquivos privados no Blob, use um domínio seu nos sites e veja o uso
    do plano. Para agentes de IA, o servidor MCP da conta (`POST
    https://app.cubehosting.com.br/api/mcp`, JSON-RPC, com a mesma chave) está
    em https://docs.cubehosting.com.br/account-mcp.
  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: Análise
  - name: Variáveis de ambiente
  - name: Backups
  - name: Versões dos envios
  - name: Bancos de dados
  - name: Blob
  - name: Domínios
  - name: Templates
  - name: Avisos
  - name: Conta
paths:
  /projects/{id}/crashes:
    get:
      tags:
        - Logs e métricas
      summary: Linha do tempo de quedas
      description: >-
        As quedas do projeto nos últimos 30 dias, a mais nova primeiro, até 50:
        cada vez que o processo saiu com código diferente de 0 (erro, sinal ou
        sem memória). Cada uma traz o motivo em pt-BR (`reason`), o código de
        saída e o sinal, quanto tempo ficou no ar, o que veio depois (`outcome`:
        o reinício automático, o loop de erro ou parado) e quando o reinício
        automático pôs de volta no ar. O log daquele momento vem no `GET` de uma
        queda. Sair com 0 ou parar pelo painel não é queda.
      operationId: listProjectCrashes
      parameters:
        - $ref: '#/components/parameters/ProjectId'
      responses:
        '200':
          description: As quedas dos últimos 30 dias.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CrashList'
              example:
                crashes:
                  - id: 5b0f7c9e-3d7a-4c1e-9a55-2f1c8e7d6b40
                    exitedAt: '2026-09-29T14:02:11.000Z'
                    startedAt: '2026-09-29T13:59:58.000Z'
                    uptimeSeconds: 133
                    exitCode: 137
                    signal: SIGKILL
                    isOutOfMemory: true
                    memoryLimitMb: 256
                    reason: 'Sem memória: passou de 256 MB'
                    outcome: restarting
                    consecutiveCrashes: 1
                    restartedAt: '2026-09-29T14:02:13.000Z'
                    logStatus: available
                limit: 50
                retentionDays: 30
        '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 <chave>" 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.
      x-codeSamples:
        - lang: bash
          label: curl
          source: >-
            curl
            "https://app.cubehosting.com.br/api/projects/$PROJECT_ID/crashes" \
              -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}/crashes`, { headers
            });

            const { crashes } = await res.json();

            for (const c of crashes) console.log(c.exitedAt, c.reason,
            `${c.uptimeSeconds ?? '?'} s no ar`);
        - 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']}/crashes",
                headers=headers,
                timeout=30,
            )
            r.raise_for_status()
            for c in r.json()["crashes"]:
                print(c["exitedAt"], c["reason"])
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:
    CrashList:
      type: object
      required:
        - crashes
        - limit
        - retentionDays
      properties:
        crashes:
          type: array
          items:
            $ref: '#/components/schemas/Crash'
        limit:
          type: integer
          description: Quantas quedas ficam guardadas por projeto (50).
        retentionDays:
          type: integer
          description: Por quantos dias (30).
    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
    Crash:
      type: object
      required:
        - id
        - exitedAt
        - startedAt
        - uptimeSeconds
        - exitCode
        - signal
        - isOutOfMemory
        - memoryLimitMb
        - reason
        - outcome
        - consecutiveCrashes
        - restartedAt
        - logStatus
      properties:
        id:
          type: string
          format: uuid
        exitedAt:
          type: string
          format: date-time
          description: Quando o processo saiu.
        startedAt:
          type:
            - string
            - 'null'
          format: date-time
          description: Quando aquela vida do processo tinha subido.
        uptimeSeconds:
          type:
            - integer
            - 'null'
          description: Tempo no ar antes de cair.
        exitCode:
          type: integer
          description: O código de saída (diferente de 0).
        signal:
          type:
            - string
            - 'null'
          description: >-
            Acima de 128, o sinal que encerrou o processo: `SIGKILL` no 137,
            `SIGSEGV` no 139, `SIGTERM` no 143.
        isOutOfMemory:
          type: boolean
          description: Passou da memória reservada do projeto.
        memoryLimitMb:
          type: integer
          description: >-
            A memória que o projeto tinha quando caiu (memória nova só vale
            depois de reiniciar).
        reason:
          type: string
          description: >-
            O motivo em pt-BR: `Sem memória: passou de 512 MB`, `Encerrado pelo
            sinal SIGSEGV (código 139)` ou `Saiu com erro (código 1)`.
        outcome:
          type: string
          enum:
            - restarting
            - crash_loop
            - stopped
          description: >-
            `restarting`: o reinício automático. `crash_loop`: a 5ª queda
            seguida, o projeto parou. `stopped`: sem reinício automático (Free).
        consecutiveCrashes:
          type: integer
          description: Quedas seguidas, contando esta.
        restartedAt:
          type:
            - string
            - 'null'
          format: date-time
          description: Quando o reinício automático pôs o projeto de volta no ar.
        logStatus:
          type: string
          enum:
            - available
            - pending
            - unavailable
          description: >-
            Se o log daquele momento está guardado, sendo guardado ou não deu
            para ler.
  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_…`.

````