SDK JavaScript : logs et statut en direct

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

​

Événements

​

L’objet status

​

Fin du flux

• le serveur ferme proprement la connexion (chaque connexion dure jusqu’à 10 minutes) ;
• le serveur envoie REALTIME_DISCONNECTED ;
• vous sortez de la boucle avec break ;
• vous appelez controller.abort() (la boucle se termine simplement, elle ne lève pas d’erreur).

​

Reconnexion

• jusqu’à 3 fois d’affilée ; tout événement logs ou status remet le compteur à zéro ;
• chaque réouverture au moins 5,5 s après l’ouverture précédente, pour rester sous le rythme de l’API d’une ouverture toutes les 5 secondes par application.

​

Limites et erreurs

• 5 connexions simultanées par compte et 30 par application, tous utilisateurs confondus. Les dépasser donne 429 REALTIME_MAX_CONNECTIONS ou REALTIME_MAX_CONNECTIONS_APP.
• Le statut HTTP est vérifié avant la diffusion, de sorte que ces erreurs (et 404 pour une application inconnue) sont levées à la première itération.
• Le timeout ne couvre que l’ouverture, jusqu’à l’arrivée des en-têtes de réponse. Le flux lui-même n’a pas de timeout.

​

Prochaines étapes