Exploiter
Journaux et exports
Chaque appel de fonction qu'un agent exécute est rapporté sous forme d'événement d'utilisation — jamais les données, seulement les métadonnées. Le tableau de bord agrège ces événements en analyses que vous pouvez lire à l'écran ou télécharger sous forme de feuille de calcul. Cette page couvre aussi le visualiseur de logs de l'agent, un outil distinct pour diagnostiquer une fonction en panne.
7 min de lecture
« Journaux » désigne deux choses différentes
Les analyses d'utilisation (ci-dessous) forment la page Télémétrie/Journaux : nombre d'appels agrégé, latence et utilisateurs les plus actifs sur une fenêtre glissante — pour comprendre comment votre complément est utilisé. Les logs de l'agent plus bas sur cette page sont autre chose : une file en direct des propres lignes debug/info/error de l'agent — pour diagnostiquer pourquoi un appel de fonction vient d'échouer. Si vous traquez une fonction cassée là, maintenant, passez directement à cette section.
Ce que montrent les analyses
Les pages Télémétrie et Journaux couvrent une fenêtre glissante (30 jours par défaut, ajustable) :
- Utilisation quotidienne — appels et erreurs par jour, et le volume de données déplacé, pour que vous puissiez voir les périodes chargées d'un coup d'œil.
- Fonctions les plus utilisées — les fonctions les plus appelées, classées par nombre d'exécutions, avec le nombre d'erreurs.
- Fonctions les plus lentes — classées par latence, pour vous orienter vers ce qu'il faut optimiser.
- Utilisateurs les plus actifs — les utilisateurs finaux les plus occupés, affichés comme
domain · hash(par exempleacme.com · 7a3f…).
Les e-mails bruts n'atteignent jamais le tableau de bord
L'identité d'un utilisateur est réduite à son domaine d'e-mail plus un hachage SHA-256 unidirectionnel avant de quitter l'agent. Vous pouvez distinguer deux utilisateurs et voir leur domaine, mais le tableau de bord ne stocke ni n'affiche jamais une adresse brute.
Exporter
Il y a deux façons de sortir les données du tableau de bord.
- Export .xlsx rapide — télécharge la fenêtre d'analyse actuelle sous forme de classeur à trois feuilles : Utilisation quotidienne, Fonctions les plus utilisées et Utilisateurs les plus actifs. Généré sur-le-champ.
- Export de journaux asynchrone — pour une extraction plus large, demandez un export et le backend le construit en arrière-plan. Il apparaît dans la liste des exports lorsqu'il est prêt, et vous téléchargez le fichier
.xlsxterminé depuis là.
Les analyses sont par complément
Ce que vous voyez est filtré selon les compléments de votre organisation et la fenêtre que vous choisissez, de sorte qu'un export est un instantané fidèle de exactement ce qui est à l'écran.
Logs de l'agent
C'est l'autre « Journaux » — un panneau de diagnostics en direct sur la page Agent de l'environnement, distinct des analyses ci-dessus. Là où les analyses d'utilisation vous disent combien votre complément est utilisé, celui-ci vous dit ce que l'agent lui-même faisait, ligne par ligne, juste avant qu'un incident survienne.
- Récupéré à la demande, pas un historique persistant. Cliquer sur le panneau envoie à l'agent une commande
get_logsvia son canal de contrôle, et l'agent répond avec jusqu'à 500 de ses lignes les plus récentes, conservées dans un tampon circulaire en mémoire — c'est une file de maintenant, pas une archive consultable remontant à des semaines. - Filtres par niveau — des puces
debug/info/errorréduisent les lignes récupérées côté client. - Nettoyé avant même de quitter l'agent. Les valeurs sensibles (secrets, chaînes de connexion, jetons) sont retirées à l'intérieur de l'agent au moment où les lignes entrent dans le tampon circulaire — le tableau de bord ne fait jamais qu'afficher un texte déjà nettoyé, il ne masque rien à la réception.
- Quel réplica a répondu — si l'environnement exécute plusieurs réplicas, un réplica en ligne arbitraire répond et une note de bas de page indique son nom d'hôte, pour que vous sachiez de quel processus proviennent les logs affichés.
- Nécessite que l'agent de l'environnement soit en ligne (la même condition que pour l'envoi de toute autre commande), et est réservé aux administrateurs comme le reste des contrôles d'exécution.
Utilisez ceci quand une fonction précise vient d'échouer
Les analyses d'utilisation vous disent qu'une fonction est en erreur ; les logs de l'agent vous disent pourquoi — l'exception réelle ou l'erreur de connexion que l'agent a rencontrée en l'exécutant. Voir Dépannage pour la suite du guide « comment résoudre X ».
Versions
Chaque environnement conserve un historique restaurable des configurations publiées. Cette page couvre le modèle brouillon/version active, l'enregistrement et la publication d'une version, la comparaison de deux instantanés (y compris votre brouillon non publié), la restauration, et la promotion d'une version entre environnements.
Alertes
Chaque agent surveille son propre hôte et prévient le tableau de bord lorsqu'une ressource chauffe ou qu'un agent devient silencieux. Vous définissez les seuils ; ConnXL déclenche, escalade et résout les alertes et peut les pousser vers Slack, Teams, Discord ou votre propre webhook.