SDK JavaScript: logs e status ao vivo

const controller = new AbortController();

for await (const event of api.apps.realtime(appId, { signal: controller.signal })) {
    if (event.event === "logs") {
        console.log(event.stream, event.line); // "stdout" | "stderr"
    } else if (event.event === "status") {
        console.log(event.status.cpu, event.status.ram); // always the full, merged state
    } else {
        console.log(event.event, event.data); // "system" or "error"
    }
}

​

Eventos

​

O objeto status

​

Encerrando o stream

• o servidor fecha a conexão de forma limpa (cada conexão dura até 10 minutos);
• o servidor envia REALTIME_DISCONNECTED;
• você sai do loop com break;
• você chama controller.abort() (o loop simplesmente termina, sem lançar erro).

​

Reconexão

• até 3 vezes seguidas; qualquer evento logs ou status zera a contagem;
• cada reabertura ocorre pelo menos 5,5 s após a abertura anterior, para respeitar o ritmo da API de uma abertura a cada 5 segundos por aplicação.

​

Limites e erros

• 5 conexões simultâneas por conta e 30 por aplicação, somando todos os usuários. Ultrapassar resulta em 429 REALTIME_MAX_CONNECTIONS ou REALTIME_MAX_CONNECTIONS_APP.
• O status HTTP é verificado antes do streaming, então esses erros (e o 404 para uma aplicação desconhecida) são lançados na primeira iteração.
• O timeout cobre apenas a abertura, até os headers da resposta chegarem. O stream em si não tem timeout.

​

Próximos passos