Surveillance de l'activite

Comment utiliser le flux d'activite en temps reel pour suivre les taches, les changements de statut des bureaux et l'utilisation des ressources.

3 min de lecture

Flux d'activite en temps reel

Le flux d'activite affiche en direct tout ce qui se passe sur vos bureaux et taches. Il utilise les Server-Sent Events (SSE) pour envoyer les mises a jour a votre navigateur au fil de l'eau. Pas de polling, pas de rafraichissement necessaire.

Vous y verrez :

  • Taches creees, demarrees, terminees ou echouees
  • Bureaux demarres, arretes ou en erreur
  • Demandes d'approbation
  • Reponses de l'agent et sorties de commandes

Le flux se trouve dans le panneau droit du tableau de bord Mission Control. Chaque evenement affiche un horodatage, le bureau source et un resume de ce qui s'est passe.

Types d'evenements

EvenementDescription
task.createdUne nouvelle tache a ete ajoutee au tableau
task.startedUne tache a commence son execution
task.completedUne tache s'est terminee avec succes
task.failedUne tache a rencontre une erreur pendant l'execution
task.reviewUne tache est passee en statut review, en attente d'approbation
task.cancelledUne tache a ete annulee manuellement
desktop.startedUn bureau est passe en etat running
desktop.stoppedUn bureau a ete arrete
desktop.errorUn bureau a rencontre une erreur
approval.createdUne demande d'approbation a ete generee
approval.resolvedUne approbation a ete acceptee ou rejetee

Consommer le flux d'activite

Le flux est disponible ici :

GET /api/mission-control/activity/stream

C'est un endpoint SSE. En JavaScript :

const eventSource = new EventSource('/api/mission-control/activity/stream', {
  headers: { 'x-api-key': 'your-api-key' }
});

eventSource.onmessage = (event) => {
  const data = JSON.parse(event.data);
  console.log(data.type, data.payload);
};

eventSource.onerror = () => {
  // SSE se reconnecte automatiquement par defaut
  console.log('Connexion perdue, reconnexion...');
};

Note : si vous utilisez l'authentification par cle API, vous devrez peut-etre passer la cle en parametre de requete car EventSource ne supporte pas nativement les headers personnalises. Voir Authentification API pour les details.

Tableau de bord des metriques

En plus du flux d'evenements, Mission Control fournit des metriques agregees mises a jour en temps reel.

Les metriques de taches incluent le total par statut (pending, running, review, done, failed, cancelled), le taux de completion sur les 24 dernieres heures et la duree moyenne des taches.

Les metriques de ressources incluent l'utilisation CPU par bureau et agregee, l'utilisation RAM par bureau et agregee, et l'utilisation disque par bureau.

Elles sont accessibles dans le panneau de vue d'ensemble de Mission Control et via l'API :

curl https://lebureau.talentai.fr/api/mission-control/overview \
  -H "x-api-key: your-api-key"

La reponse contient les compteurs de taches, le nombre de bureaux actifs et les agregats de ressources.

Filtrage et recherche

Le flux d'activite supporte le filtrage par :

  • Bureau -- afficher les evenements d'un bureau specifique
  • Type d'evenement -- afficher uniquement les taches, les bureaux ou les approbations
  • Plage temporelle -- se concentrer sur les evenements recents ou une fenetre specifique

Conseils

  • Gardez le flux ouvert pendant l'execution de taches par lots. C'est le moyen le plus rapide de detecter les echecs.
  • Le tableau de bord des metriques permet de reperer les bureaux surcharges (CPU/RAM eleves) avant qu'ils ne ralentissent.
  • L'endpoint SSE reste ouvert indefiniment. Votre client se reconnecte automatiquement si la connexion tombe.
  • Pour du monitoring automatise, consommez le flux SSE dans vos scripts pour declencher des alertes ou des taches de suivi.