Surveillance du fonctionnement des agents

Comment ouvrir la surveillance des agents dans Codenica ?

Vous ouvrez cette vue depuis le menu de l’application : Menu -> Supervision -> Agents. Elle est destinée aux administrateurs qui veulent vérifier rapidement si Codenica Insight Agent est correctement installé sur les ordinateurs, s’il communique avec le backend et si les données de surveillance du travail sont régulièrement transmises au système.

Cette vue ne sert pas principalement à évaluer l’activité d’un employé. Son objectif principal est le contrôle technique des agents : version du programme, dernière synchronisation, erreurs, avertissements, état des files d’attente, statut backend et qualité des données. Cela permet de distinguer plus facilement un ordinateur qui n’envoie réellement pas de données d’une situation où le problème vient seulement d’une agrégation retardée ou de la configuration de l’agent.

En haut de la vue se trouve un panneau d’actions lié à l’agent. Vous pouvez y télécharger l’installateur de Codenica Insight Agent, ouvrir les instructions d’installation et accéder aux paramètres de surveillance. En dessous se trouve le Panneau d’analyse, qui rassemble les indicateurs les plus importants pour la période sélectionnée, puis la liste des agents sous forme de tableau.

Cette vue comporte une exception importante : un enregistrement du tableau correspond à un agent ou à un ordinateur, et non à une journée de surveillance. Après avoir cliqué sur un enregistrement, l’application affiche les détails de l’agent sélectionné, y compris les résumés quotidiens de la période définie dans les filtres.

Liste des agents dans la surveillance des ordinateurs

Le tableau de la vue Agents permet de repérer rapidement les postes qui demandent une attention technique. Par défaut, la liste est orientée vers le contrôle courant du fonctionnement des agents. Elle affiche notamment la description de l’ordinateur, la version de l’agent, la dernière synchronisation, la dernière adresse IP et l’état général de l’agent. Ces colonnes suffisent pour repérer les ordinateurs qui ne communiquent plus depuis longtemps avec le système ou qui commencent à signaler des problèmes.

Dans la configuration du tableau, vous pouvez activer des colonnes de diagnostic supplémentaires. Elles sont utiles lorsqu’il faut vérifier plus précisément pourquoi la surveillance ne fournit pas de données ou pourquoi certaines informations arrivent avec du retard.

État de santé de l’agent affiche l’évaluation générale de l’agent, par exemple fonctionnement correct, avertissement, erreur, hors ligne ou blocage.
Version de l’agent aide à trouver les ordinateurs avec une version obsolète de Codenica Insight Agent.
Dernière synchronisation et Dernière communication indiquent quand l’agent a envoyé des données ou contacté le backend pour la dernière fois.
Statut backend indique si la dernière communication a été acceptée par le système.
Erreurs, Avertissements et Synchronisations échouées permettent de séparer l’activité technique ordinaire des problèmes à vérifier.
File d’attente, File d’envoi et File en erreur montrent si une file de données en attente d’envoi augmente sur l’ordinateur.
Blocages et Raison du blocage aident à vérifier si l’agent a été volontairement bloqué dans le système.

En pratique, il est préférable de commencer par les agents avec un statut d’erreur, un nombre élevé de synchronisations échouées, une file d’attente importante ou aucune communication récente. Ce sont les signaux les plus fréquents indiquant que la surveillance de l’ordinateur nécessite une intervention.

Panneau d’analyse dans la surveillance du fonctionnement des agents

Le panneau d’analyse de la vue Agents affiche l’état de tout le groupe d’agents dans la plage de dates sélectionnée. Vous pouvez passer à une journée, une semaine, un mois ou une période personnalisée. Deux modes de calcul sont également disponibles : Total, c’est-à-dire la somme pour la période, et Moyenne quotidienne, c’est-à-dire une valeur calculée par jour. Cette distinction est importante, car le même nombre d’erreurs n’a pas le même sens sur une journée que sur une longue période couvrant de nombreux ordinateurs.

Les indicateurs les plus importants du panneau décrivent :

Agents - le nombre d’agents inclus dans l’analyse.
Événements - le nombre total d’événements techniques enregistrés par les agents.
Erreurs et Avertissements - le nombre d’erreurs et d’avertissements pouvant nécessiter un diagnostic.
Synchronisations échouées et Synchronisations réussies - l’efficacité de la communication des agents avec le backend.
Commandes échouées - les commandes que l’agent n’a pas exécutées correctement, par exemple une mise à jour, un redémarrage ou un arrêt.
File d’attente et File en erreur - l’état des files de données en attente d’envoi ou non traitées correctement.
Avertissements d’état - les avertissements liés à l’état des agents.
Ordinateurs - le nombre d’ordinateurs associés aux agents analysés.

Il est utile de lire le panneau de gauche à droite : d’abord l’échelle de la surveillance, ensuite le nombre d’événements, puis les erreurs, les synchronisations et les files d’attente. Cela aide à savoir si le problème concerne un seul ordinateur, un groupe plus large de postes ou tout l’environnement.

Classements et catégories dans la surveillance des agents

L’onglet des classements et catégories permet de voir où se concentre le plus grand nombre d’événements de surveillance des agents. Un résultat élevé ne signifie pas toujours une panne. Un agent qui communique souvent avec le système et effectue beaucoup d’opérations peut naturellement générer plus d’entrées. C’est seulement en comparant les classements avec les erreurs, la synchronisation et les files d’attente que l’on voit si l’activité est normale ou problématique.

Dans cette partie du panneau, vous pouvez analyser plusieurs groupes de données :

Types d’événements - les types d’événements signalés par les agents, par exemple la synchronisation, les avertissements d’état ou la gestion des commandes.
Niveaux de gravité - les niveaux de gravité des événements, qui montrent rapidement la part des informations, avertissements et erreurs.
Statuts du backend - les réponses du backend à la communication de l’agent, particulièrement importantes pour diagnostiquer les synchronisations échouées.
Agents principaux - les agents qui génèrent le plus d’événements dans la période sélectionnée.
Ordinateurs les plus actifs - les ordinateurs où le fonctionnement de l’agent est le plus visible dans les données.
Employés les plus actifs - les employés liés aux ordinateurs, si le système peut rattacher les données à un utilisateur.

Les classements sont particulièrement utiles après le déploiement des agents, après une mise à jour de version ou après une modification des paramètres de surveillance. Ils permettent de vérifier si les nouveaux événements apparaissent de manière équilibrée ou seulement sur certains ordinateurs.

Tendances et présence horaire dans la surveillance des agents

Les tendances montrent comment le fonctionnement des agents a évolué au fil des jours de la période sélectionnée. Dans la vue Agents, les graphiques les plus importants concernent les événements, les erreurs, les synchronisations échouées et les files d’attente. Si, après une période calme, le nombre d’erreurs ou de synchronisations échouées augmente soudainement, vérifiez si la configuration réseau, les politiques de sécurité, la version de l’agent ou la disponibilité du backend ont changé à ce moment-là.

Les graphiques de tendances aident à répondre à des questions pratiques :

Le problème des agents augmente-t-il progressivement ou est-il apparu soudainement un jour précis ?
Les erreurs sont-elles constantes ou limitées à de courtes périodes ?
La file d’attente diminue-t-elle après le rétablissement de la connexion ou continue-t-elle à augmenter ?
Les synchronisations échouées concernent-elles quelques jours ou toute la plage analysée ?

Un élément distinct est le graphique Présence horaire. Il montre les heures locales auxquelles des résumés de journaux d’agent sont apparus. Ce n’est pas un compteur de temps de travail, un nombre d’événements ni une durée de synchronisation. Une heure marquée signifie qu’une entrée de journal d’agent a été observée durant cette heure pour la journée surveillée.

Comparaisons de périodes dans la surveillance des agents

Les comparaisons permettent de rapprocher la période actuelle d’une période précédente de durée similaire. Dans la surveillance des agents, c’est très utile, car un nombre d’erreurs isolé, sans contexte, peut être trompeur. La comparaison montre seulement si la situation est stable, s’améliore ou se dégrade.

Il faut surtout observer les changements dans les métriques techniques :

une hausse du nombre d’erreurs peut indiquer un problème de version d’agent, de configuration ou d’environnement Windows local,
une hausse des synchronisations échouées peut indiquer un problème de connexion, d’enregistrement de l’agent ou de réponse du backend,
une hausse de la file d’attente suggère que l’agent collecte les données plus vite qu’il ne peut les envoyer,
une hausse de la file en erreur signifie qu’une partie des données n’a pas été traitée correctement et demande une vérification,
une hausse des commandes échouées peut signifier que l’agent n’exécute pas correctement les commandes d’administration.

Lors de l’interprétation des comparaisons, il faut tenir compte de l’échelle. Si de nombreux nouveaux ordinateurs ont été ajoutés à la surveillance dans la période actuelle, l’augmentation du nombre d’événements est naturelle. Une hausse de la part des erreurs, des synchronisations échouées ou des files en retard par rapport au nombre d’agents est plus préoccupante.

Anomalies dans la surveillance des agents

L’onglet des anomalies indique les situations qui s’écartent du fonctionnement attendu des agents et peuvent nécessiter une action de l’administrateur. Le système n’y affiche pas les événements d’information ordinaires, mais les dépassements de seuils liés aux erreurs, à la synchronisation, aux files d’attente et aux commandes.

La vue Agents peut notamment détecter :

une forte part d’erreurs de l’agent - lorsque l’agent a généré beaucoup d’erreurs par rapport à l’ensemble des événements,
une forte part de synchronisations échouées - lorsque de nombreuses tentatives d’envoi de données échouent,
une grande file d’attente - lorsque des enregistrements en attente d’envoi s’accumulent sur l’ordinateur,
une file en erreur - lorsqu’une partie des enregistrements n’a pas été traitée correctement,
une forte part de commandes échouées - lorsque l’agent n’exécute pas correctement des commandes comme la mise à jour, le redémarrage ou l’arrêt.

Chaque anomalie contient le nom de l’ordinateur ou de l’agent, la date, la valeur actuelle, le seuil de référence et les données de preuve. Il vaut mieux commencer le diagnostic par les anomalies de gravité élevée, surtout si des erreurs de synchronisation et des files en retard apparaissent en même temps.

Détails d’un enregistrement dans la surveillance du fonctionnement de l’agent

Après avoir cliqué sur un enregistrement de la liste, l’application ouvre les détails de l’agent sélectionné. Dans cette partie, vous ne consultez plus la liste générale des installations, mais les résumés quotidiens d’un ordinateur ou d’un agent précis sur la période choisie. C’est un bon moyen de vérifier si le problème visible dans le tableau est confirmé par les données quotidiennes.

Les détails peuvent inclure à la fois des informations techniques sur l’agent et des données agrégées issues d’autres zones de surveillance :

les dates des résumés, la première et la dernière activité, ainsi que les heures actives,
le temps actif, le temps au premier plan, l’inactivité, les frappes clavier et les clics souris,
les applications utilisées, la dernière application et le programme le plus utilisé,
les domaines web, le nombre d’ouvertures de pages et le dernier domaine,
les documents, les opérations du presse-papiers, les événements de fichiers et les transferts de données,
les événements USB, les tentatives d’impression et les statuts des politiques de sécurité,
les applications bloquées, les sites bloqués et les violations de règles,
le statut d’audit, le nombre d’éléments matériels, de logiciels, de périphériques USB, d’imprimantes et de contrôles de sécurité,
le dernier statut backend, la dernière erreur, les files d’attente et les informations sur les commandes de l’agent.

Ainsi, les détails de l’enregistrement sont utiles non seulement en cas de panne de l’agent, mais aussi lorsque d’autres vues de surveillance ne contiennent pas de données pour un ordinateur. Vous pouvez alors vérifier si l’agent a réellement fonctionné, s’il a envoyé des données et si le backend les a correctement acceptées.

Qualité et fraîcheur des données dans la surveillance des agents

Les sections de qualité et de fraîcheur des données aident à évaluer si les résultats visibles dans le panneau sont complets. C’est particulièrement important dans la vue Agents, car l’absence de données peut avoir plusieurs causes : l’ordinateur a pu être éteint, l’agent a pu ne pas envoyer de données, la synchronisation a pu échouer, ou l’enregistrement du jour en cours peut encore être en cours d’agrégation.

Faites attention aux informations suivantes :

Couverture des détails - indique quelle part des enregistrements possède des détails complets,
Enregistrements sans détails - signale les enregistrements sans données détaillées, même si un résumé peut exister,
Données en cours partielles - désigne les données du jour en cours qui peuvent ne pas encore être clôturées,
Enregistrements historiques ouverts - signale les anciens enregistrements qui semblent toujours inachevés,
Détails non valides - informe d’un problème dans la structure des données détaillées,
Jours sans données - montre les jours de la période sélectionnée pour lesquels le système ne possède pas de journaux d’agent.

La fraîcheur des données indique quand la vue a été générée, si elle inclut le jour actuel, quel est l’enregistrement le plus récent et s’il existe un retard. Si le panneau affiche des problèmes de qualité ou de fraîcheur, vérifiez d’abord la dernière communication de l’agent, le statut backend, la file d’attente et la dernière erreur sur l’ordinateur concerné.