SDK de JavaScript: logs y estado en 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

​

El objeto status

​

Finalizar el stream

• el servidor cierra la conexión limpiamente (cada conexión dura hasta 10 minutos);
• el servidor envía REALTIME_DISCONNECTED;
• sales del bucle con break;
• llamas a controller.abort() (el bucle simplemente termina, no lanza ningún error).

​

Reconexión

• hasta 3 veces seguidas; cualquier evento logs o status reinicia el contador;
• cada reapertura al menos 5,5 s después de la apertura anterior, para respetar el ritmo de la API de una apertura cada 5 segundos por aplicación.

​

Límites y errores

• 5 conexiones simultáneas por cuenta y 30 por aplicación, sumando todos los usuarios. Superarlas da 429 REALTIME_MAX_CONNECTIONS o REALTIME_MAX_CONNECTIONS_APP.
• El estado HTTP se comprueba antes del streaming, así que estos errores (y el 404 de una aplicación desconocida) se lanzan en la primera iteración.
• El timeout solo cubre la apertura, hasta que llegan los encabezados de la respuesta. El stream en sí no tiene timeout.

​

Próximos pasos