SDK JavaScript: log e stato in tempo reale

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

​

Eventi

​

L’oggetto status

​

Terminare il flusso

• il server chiude la connessione in modo pulito (ogni connessione dura fino a 10 minuti);
• il server invia REALTIME_DISCONNECTED;
• esci dal ciclo con break;
• chiami controller.abort() (il ciclo semplicemente termina, non lancia eccezioni).

​

Riconnessione

• fino a 3 volte di fila; qualsiasi evento logs o status azzera il conteggio;
• ogni riapertura avviene almeno 5,5 s dopo l’apertura precedente, per restare sotto il ritmo dell’API di un’apertura ogni 5 secondi per app.

​

Limiti ed errori

• 5 connessioni simultanee per account e 30 per app, considerando tutti gli utenti. Superarle produce 429 REALTIME_MAX_CONNECTIONS o REALTIME_MAX_CONNECTIONS_APP.
• Lo status HTTP viene controllato prima dello streaming, quindi questi errori (e il 404 per un’app sconosciuta) vengono lanciati alla prima iterazione.
• Il timeout copre solo l’apertura, fino all’arrivo degli header della risposta. Il flusso in sé non ha timeout.

​

Prossimi passi