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.
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
| Evenement | Description |
|---|---|
task.created | Une nouvelle tache a ete ajoutee au tableau |
task.started | Une tache a commence son execution |
task.completed | Une tache s'est terminee avec succes |
task.failed | Une tache a rencontre une erreur pendant l'execution |
task.review | Une tache est passee en statut review, en attente d'approbation |
task.cancelled | Une tache a ete annulee manuellement |
desktop.started | Un bureau est passe en etat running |
desktop.stopped | Un bureau a ete arrete |
desktop.error | Un bureau a rencontre une erreur |
approval.created | Une demande d'approbation a ete generee |
approval.resolved | Une 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.