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

# Logs em tempo real

> Estabelecer uma conexão Server-Sent Events (SSE) para receber os logs da sua aplicação em tempo real. Após a conexão, as 200 linhas de log mais recentes são enviadas, seguidas por novas atualizações. A conexão pode ser mantida por até 30 minutos.

<Info>O Playground da API está desativado para este endpoint devido à natureza das conexões SSE, que não são universalmente suportadas pelos navegadores.</Info>

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

### Parâmetros

<ParamField path="app_id" type="string" placeholder="ID da Aplicação" required>
  O ID da aplicação cujos logs você deseja monitorar. Este ID pode ser encontrado na URL do painel de gerenciamento da sua aplicação.
</ParamField>

### Resposta

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

Em caso de falha, a resposta incluirá um campo `code` juntamente com o status de erro, detalhando a causa.

Se a requisição for bem-sucedida, a resposta será um stream `text/event-stream` contendo os logs da aplicação em tempo real.

### Estrutura do Server-Sent Events (SSE)

A resposta é um fluxo contínuo no formato `text/event-stream`. Cada mensagem no stream é composta por um campo `event` e um campo `data`.

#### Tipos de Evento

* `system`: Indica eventos relacionados ao sistema, como o status da conexão (`REALTIME_CONNECTING`, `REALTIME_CONNECTED`) ou pings de manutenção (`PING`).
* `logs`: Contém uma única linha de log gerada pela sua aplicação.