Utiliser les journaux système

ArcGIS Enterprise on Kubernetes consigne les événements qui se produisent dans votre organisation et toutes les erreurs associées à ces événements sont enregistrées dans les journaux. Les journaux sont disponibles dansArcGIS Enterprise Manager.

Vous pouvez utiliser les journaux pour surveiller et résoudre les problèmes au niveau de votre organisation. Les informations contenues dans ces journaux peuvent vous aider à identifier les erreurs et à disposer d’un contexte pour la résolution des problèmes. Les journaux compilent également un historique des événements et des tendances dans le temps.

Capturer, interroger et afficher des événements

Lorsqu'un événement se produit au sein de votre site, il est capturé et enregistré dans les journaux. Pour afficher les messages associés à l'événement, interrogez les journaux. Pour interroger et afficher les messages existants dans votre site, procédez comme suit :

  1. Connectez-vous à ArcGIS Enterprise Manager en tant qu’administrateur.
  2. Cliquez sur le bouton Logs (Journaux) de la barre latérale pour examiner les journaux actuels.

    Certains messages sont retournés avec des informations supplémentaires.

Tous les journaux enregistrent certains éléments d’information sur l’événement. Vous pouvez afficher et permuter les colonnes qui affichent les éléments suivants :

  • Date et heure de l’événement de journal
  • Niveau de consignation de l’événement
  • Messages de consignation
  • Source de l’événement de journal
  • ID de la requête de l'événement de journal
  • Nom d’utilisateur associé à l’événement
  • Type de service sur lequel l'événement s'est produit
  • Nœud sur lequel ’événement de journal s’est produit.
  • Code de consignation relatif à l’événement
  • Trace de la pile d’appels de l'événement

Vous pouvez également filtrer les journaux en fonction de l’heure, du niveau de consignation, de la source, de l’ID de la requête, du nom d’utilisateur, du type de service et du code de consignation.

Résoudre les problèmes à l’aide des journaux

Si vous suspectez un problème avec un service ou un nœud, ou si un utilisateur signale un problème, vous pouvez reproduire l’événement, le capturer avec les journaux, puis interroger les journaux pour obtenir des informations sur l’événement. Utilisez ensuite les informations du journal pour résoudre le problème provoqué par l'événement.

Si un problème est suspecté ou signalé, essayez de le reproduire. Si vous parvenez à le reproduire, interrogez les journaux appropriés et examinez leurs messages pour obtenir des informations utiles. Par exemple, si un utilisateur signale un problème de performances avec un service Web, reproduisez ses actions et surveillez les journaux pour voir ce qui se passe. Vous y trouverez peut-être un message d’erreur indiquant la cause.

Si aucune information n’est présente, augmentez le niveau de consignation. Cela élargit la plage de journaux capturés et peut fournir des informations utiles.

Niveaux de consignation

Les événements consignés peuvent présenter un niveau de détail différent, allant de Severe (Grave), qui indique un problème devant être résolu immédiatement, à Verbose (Commentaires), qui correspond à un message détaillé et informatif généré lors d'une utilisation normale du serveur.

Le tableau suivant décrit les niveaux de consignation :

Niveau de consignationDescriptionExemple de message

Grave

Des problèmes graves nécessitant une attention immédiate se sont produits. Ce niveau ne comprend que les messages graves.

Traitement de la requête impossible. Service X introuvable.

Avertissement

Des problèmes modérés nécessitant votre attention se sont produits. Ce niveau comprend également des messages graves.

La connexion a échoué. Spécification d'un nom d'utilisateur ou d'un mot de passe non valide.

Info

Les messages d’administration courants incluent des informations sur la création et le démarrage de services. Ce niveau comprend également les messages graves et les avertissements.

Accès aux paramètres des comptes d’organisation.

Détaillé

Les messages courants incluent des informations comme les noms des demandes d’opération reçues. Ce niveau comprend également les messages graves, les avertissements et les commentaires.

Recherche d’éléments arrivés à expiration.

Commentaires

Ces messages affichent des informations supplémentaires sur la manière dont le déploiement exécute une opération, à savoir la confirmation que chaque couche d’un service de carte a été affichée correctement, la vitesse d’affichage de la couche, ou le temps nécessaire pour accéder aux données source de la couche. Ce niveau comprend également les messages graves, les avertissements, les commentaires et les messages indiquant une exécution correcte.

Début d’affichage de la couche : counties.

Débogage

Les messages sont destinés aux développeurs et aux techniciens désireux de mieux comprendre le problème dans le cadre du dépannage. Il est recommandé de ne pas utiliser ce niveau dans un environnement de production, car il risque de diminuer les performances. Si vous n'êtes pas en train d'essayer de corriger un problème, utilisez plutôt le niveau Avertissement.

Nettoyage des répertoires.

Mettre à jour le niveau de consignation

Lorsque vous utilisez les journaux système dans ArcGIS Enterprise Manager, il se peut que vous ayez à augmenter le niveau de consignation pour capturer et examiner les événements.

Vous pouvez étendre la plage des journaux enregistrés. Vous pouvez également examiner les journaux liés à la création et au démarrage des services. Dans ce cas, vous pouvez remplacer le niveau de consignation par défaut Warning (Avertissement) par Info (Infos).

Pour mettre à jour le niveau de consignation dans ArcGIS Enterprise Manager, procédez comme suit :

  1. Cliquez sur Settings (Paramètres) dans la page Logs (Journaux).
  2. Sur la page Log settings (Paramètres des journaux), définissez le niveau de consignation par défaut souhaité.
  3. Cliquez sur Save (Enregistrer).

Mettre à jour la durée de conservation des journaux

Vous pouvez définir une politique de conservation des journaux système. Par défaut, les journaux système sont conservés pendant 60 jours avant d’être supprimés.

Pour mettre à jour la durée de la période de conservation, procédez comme suit :

  1. Cliquez sur Settings (Paramètres) dans la page Logs (Journaux).
  2. Sur la page Log settings (Paramètres des journaux), mettez à jour la durée de conservation des journaux.
  3. Cliquez sur Save (Enregistrer).

Mettre à jour les index des journaux

Vous pouvez mettre à jour les index des journaux pour résoudre les problèmes d’accès aux journaux, par exemple, si de nouveaux journaux ne sont pas générés ou si les journaux existants ne sont pas accessibles.

Pour mettre à jour les index des journaux dans ArcGIS Enterprise Manager, procédez comme suit :

  1. Cliquez sur Settings (Paramètres) dans la page Logs (Journaux).
  2. Dans la page Log settings (Paramètres des journaux), cliquez sur Update log index (Mettre à jour les index des journaux).

Supprimer les messages de journal

Supprimer les messages de journal, procédez comme suit :

  1. Sur la page Logs (Journaux), cliquez sur le bouton Delete (Supprimer) Suppr.
  2. Sur la page Delete log messages (Supprimer les messages de journal), les options suivantes sont disponibles :
    • Select log level(s) (Sélectionner le(s) niveau(x) de journal) : sélectionnez un ou plusieurs niveaux de consignation à supprimer.
    • Select time period (Sélectionner une période) : sélectionnez une période au cours de laquelle supprimer les messages de journal.
    • Select time period (Sélectionner une période personnalisée) : si cette option est cochée, sélectionnez une période personnalisée au cours de laquelle supprimer les messages de journal.
  3. Cliquez sur Supprimer.