Utiliser les journaux du serveur

Dans cette rubrique

Capturer, interroger et afficher des événements
Fonctionnement des journaux
Utilisation de filtres de journaux pour affiner les résultats des recherches
Exploration des journaux de serveur
Affichage des journaux dans un format imprimable
Suppression de journaux

Les journaux du serveur vous permettent d'identifier les erreurs et de résoudre les problèmes liés au site. Vous allez utiliser ArcGIS Server Manager pour consulter, interroger, configurer et supprimer les journaux du portail. Le gestionnaire agrège les messages des journaux dans une table que vous pouvez lire et manipuler.

Les sections de cette rubrique d'aide décrivent les journaux du serveur et la façon de les utiliser pour résoudre les problèmes.

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, vous devez interroger les journaux. Pour interroger et afficher les messages existants dans votre site, procédez comme suit :

Ouvrez le gestionnaire et connectez-vous en tant qu'administrateur. Si vous avez besoin d'aide pour cette étape, reportez-vous à la rubrique Connexion au gestionnaire.
Cliquez sur Journaux > Afficher les journaux pour examiner les journaux actuels. Certains messages sont retournés avec des informations supplémentaires.

Tous les événements enregistrent des informations, telles que le niveau de consignation, l'heure de l'événement, le composant source à l'origine de l'événement, la machine sur laquelle l'événement s'est produit, le code de consignation, l'utilisateur associé à l'événement, etc. Toutes ces informations peuvent vous aider à dépanner votre portail avec plus d'efficacité. Reportez-vous à la rubrique Fonctionnement des journaux pour obtenir une explication détaillée de ces informations.

Comportement de consignation lors de l'installation et après

Lorsque vous installez ArcGIS Server ou le mettez à niveau, le niveau de consignation du serveur est défini sur Commentaires. Cela signifie que des messages très détaillés sont consignés pendant l'installation ou la mise à niveau.

Si une erreur se produit pendant ce processus et que vous voulez consulter les journaux pour faciliter le dépannage, déterminez d'abord si vous pouvez accéder à ArcGIS Server Manager. Si vous le pouvez, interrogez les journaux et consultez les messages. Si vous ne pouvez pas, consultez les messages des journaux sur le disque. Pour accéder aux journaux sur le disque, parcourez le répertoire où ils sont stockés et ouvrez le fichier journal le plus récent (par exemple, <ArcGIS Server installation directory>/arcgisserver/logs/<machine name>/server/server-20150101.095803-8596-0.0.log). Vous pouvez également partager ces informations avec le support technique Esri, si cela est nécessaire.

A la fin du processus d'installation ou de mise à niveau, le niveau de consignation du serveur est défini sur Avertissement par défaut. Cela signifie que seuls les problèmes moyennement graves à graves sont consignés. Si un utilisateur du serveur signale un problème, vous pouvez décider de changer le niveau de consignation afin de capturer des messages plus détaillés sur ce problème spécifique. Pour savoir comment modifier le niveau de consignation, reportez-vous à la rubrique Spécifier les paramètres du journal du serveur dans le gestionnaire.

Lorsque vous suspectez un problème

Si vous suspectez un problème avec le serveur, ou si un utilisateur signale un problème, vous devez reproduire l'événement, le capturer avec les journaux, puis interroger les journaux pour obtenir des informations sur l'événement. Vous utiliserez ensuite les informations du journal pour vous aider à résoudre le problème provoqué par l'événement.

Si un problème est supposé ou signalé, utilisez l'arborescence de décision suivante pour capturer l'événement avec les journaux :

Essayez de reproduire le problème :
- Si le problème ne peut pas être reproduit, interrogez les journaux et consultez les messages pour obtenir des informations sur le problème :
  1. Si aucune information n'est présente, augmentez le niveau de consignation. Reproduisez le problème, interrogez les journaux et consultez les messages.
  2. Si les messages du journal contiennent des informations, lisez-les pour faciliter la résolution du problème.
- Si vous n'arrivez pas à reproduire le problème, notez le scénario ayant abouti à ce problème pour le cas où il se reproduirait.

Astuce:

Si le problème est lié à la publication de services hébergés, nous vous conseillons de consulter également les journaux Portal for ArcGIS. Les journaux du portail peuvent fournir des informations complémentaires qui vous aideront à résoudre le problème de publication.

Fonctionnement des journaux

Tous les événements enregistrent des informations spécifiques, telles que le niveau de consignation, l'heure de l'événement et la machine sur laquelle l'événement s'est produit. Toutes ces informations peuvent vous aider à dépanner votre serveur avec plus d'efficacité.

Par défaut, seules les propriétés Niveau, Heure, Message, et Source apparaissent dans la fenêtre des messages de consignation. Pour ajouter ou supprimer des propriétés de l'affichage, sélectionnez Colonnes.

Astuce:

Réorganisez les colonnes en faisant glisser et en déposant les en-têtes correspondants dans l'affichage des journaux d'événements. Cliquez sur chaque en-tête de colonne pour trier par ordre croissant ou décroissant.

Les sections suivantes expliquent ces informations plus en détail.

Niveau

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

Les types de niveaux de consignation sont les suivants :

Niveau de consignation	Description	Exemple de message
Sérieux	Problèmes graves nécessitant une attention immédiate. Ce niveau ne comprend que les messages graves.	Impossible de traiter la requête. Service Planning/counties/FeatureServer introuvable.
Avertissement	Problèmes modérés nécessitant votre attention. Ce niveau comprend également des messages graves.	Echec de connexion. Spécification d'un nom d'utilisateur ou d'un mot de passe non valide.
Infos	Messages courants sur l'administration du serveur, y compris les messages relatifs à la création et au démarrage de services. Ce niveau comprend également les messages graves et les avertissements.	Le dossier Planning a été créé.
Détaillé	Messages courants sur l'utilisation du serveur, comme le nom des demandes d'opération reçues. Ce niveau comprend les messages graves, les avertissements et les commentaires.	Recherche d’éléments expirés dans /admin/arcgisserver/directories/arcgisjobs.
Commentaires	Ces messages affichent des informations supplémentaires sur la manière dont le serveur 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 et le temps nécessaire au serveur pour accéder aux données source de la couche. Ce niveau comprend les messages graves, les avertissements, les commentaires et les messages de type Fin.	Début d'affichage de la couche : counties.
Déboguer	Messages très détaillés destinés aux développeurs et aux techniciens désireux de mieux comprendre l'état du serveur 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 du serveur.
Désactivés	La consignation est désactivée. Les événements ne sont pas consignés sur le serveur.	N/D

Temps

Heure à laquelle l'événement consigné s'est produit. Les événements sont organisés dans l'ordre chronologique, le plus récent étant le premier affiché. Cliquez sur l'en-tête de colonne Heure pour trier les messages par ordre croissant ou décroissant.

Vous pouvez spécifier l'intervalle temporel à afficher lors de l'interrogation des journaux.

Source

La source de l'événement consigné peut être un service ou le serveur lui-même. Les événements associés aux services affichent le nom et le type du service comme propriété de la source. Les événements associés au serveur affichent le nom du composant de l'infrastructure ayant consigné le message comme propriété de la source.

Par exemple :

Un événement associé au service de carte SampleWorldCities apparaît sous la forme SampleWorldCities.MapServer.
Après avoir créé une grappe de serveurs sur votre site, Admin s'affiche comme étant le composant qui a consigné le message.

Si vous le souhaitez, vous pouvez spécifier la source à afficher lors de l'interrogation des journaux.

Machine

Chaque machine serveur SIG qui fait partie du site conserve des journaux propres à cette machine. De même, si vous avez inscrit ArcGIS Data Store sur votre site, chaque machine Data Store consigne les messages spécifiques à cette machine.

Par exemple, un serveur SIG peut consigner une erreur indiquant qu'il n'est pas parvenu à mettre à jour l'emplacement de la configuration. Seuls les messages correspondant aux statistiques enregistrées pour une machine spécifique incluent la propriété de la machine.

Vous pouvez spécifier la machine à afficher lors de l'interrogation des journaux.

Code

Code de consignation associé au message. Les codes sont classés par plages, comme indiqué dans Vue d'ensemble des codes de consignation.

Temps écoulé

Temps nécessaire (en millisecondes) pour que l'événement consigné se termine. Par exemple, l'événement d'exportation de l'image de la carte Web est associé à une durée écoulée qui indique le temps nécessaire pour exporter l'image de la carte Web.

Nom d\'utilisateur

Nom de l'utilisateur qui a envoyé la demande provoquant le message de consignation. Cette propriété est utile pour vous aider à suivre l'activité d'un utilisateur lorsque la sécurité est activée.

Traitement

ID du processus de machine qui a consigné l'événement.

Thread

Thread du processus de serveur qui a généré le message.

Nom de la méthode

Appel de méthode sur le service qui a provoqué le message de consignation.

Utilisation de filtres de journaux pour affiner les résultats des recherches

Pour affiner le nombre d'événements et afficher des messages les plus pertinents, vous pouvez effectuer des requêtes en fonction du niveau de consignation, de l'âge (la durée) du journal, du composant source et de la machine. Vous pouvez associer les filtres de votre choix au sein de votre requête. Vous pouvez accéder à ces filtres sur la page Affichage du gestionnaire.

Filtre sur les logs

Les événements peuvent présenter un niveau de détail différent, allant de Grave, qui indique un problème devant être résolu immédiatement, à Commentaires, qui correspond à un message détaillé et informatif généré lors d'une utilisation normale du serveur. Sélectionnez le niveau souhaité dans la liste déroulante Filtre sur les logs. Pour obtenir un résumé détaillé de chaque niveau, consultez la section Niveau ci-dessus.

Age

Les événements consignés sur le serveur sont organisés par ordre chronologique, le plus récent étant le premier affiché. Pour filtrer des événements sur une fenêtre temporelle spécifique, spécifiez l'incrément souhaité dans la liste déroulante Age.

Incrément de temps	Description
Dernières 15 minutes	Affiche les événements consignés au cours des 15 dernières minutes.
Dernière heure	Affiche les événements consignés durant l'heure qui vient de s'écouler.
Dernières 6 heures	Affiche les événements consignés au cours des six dernières heures.
Dernières 24 heures	Affiche les événements consignés la veille.
Dernière semaine	Affiche les événements consignés au cours de la semaine dernière ou sur la période de conservation des journaux sur disque que vous avez définie pour le site.
Depuis le démarrage	Affiche les événements consignés depuis le dernier redémarrage du serveur ou sur la période de conservation des journaux sur disque que vous avez définie pour le site.
Tous	Affiche tous les événements consignés depuis l'installation d'ArcGIS Server ou sur la période de conservation des journaux sur disque que vous avez définie pour le site.

Vous pouvez cliquer sur l'en-tête de colonne Heure pour trier les messages par ordre croissant ou décroissant.

Notez que la requête renvoie uniquement des journaux sur la période de conservation sur disque que vous avez définie pour votre site ArcGIS Server. La période par défaut est de 90 jours. Par exemple, si vous sélectionnez La semaine dernière dans le filtre Age alors que la durée de conservation des journaux a été configurée sur cinq jours, seuls les journaux des cinq derniers jours seront renvoyés.

Astuce:

Cliquez sur Paramètres pour indiquer la durée de conservation des journaux sur le disque par le serveur. Pour plus d'informations, reportez-vous à la rubrique Spécifier les paramètres du journal du serveur dans le gestionnaire.

Source

Par défaut, toutes les sources sont interrogées (option Tout de la liste déroulante). Pour interroger un composant spécifique de service ou d'infrastructure du réseau, sélectionnez le nom du service ou du composant dans le filtre Source. Pour obtenir une description des sources correspondant aux événements consignés, consultez la table ci-dessous.

Remarque :

Les sources Admin, Serveur, Rest et Soap décrites ci-dessous sont regroupées sous le niveau Structure du serveur dans le filtre Source. Pour interroger ces sources, sélectionnez Structure du serveur dans le filtre Source.

Source	Description
Admin	Indique que le message a été consigné par l'API d'administration. L'API d'administration représente le niveau du serveur qui vous permet d'administrer votre serveur pour créer le site, ajouter des machines et des services et configurer des agrégats, par exemple.
Serveur	Indique que le message a été consigné par la portion de l'infrastructure du serveur qui est à l'origine de la création des instances des services.
Rest	Indique que le message a été consigné par le gestionnaire REST du serveur. Le composant Rest consigne des messages à tous les niveaux.
Soap	Indique que le message a été consigné par le gestionnaire SOAP du serveur. Le composant Soap consigne des messages à tous les niveaux.
ArcGIS Data Store	Indique que le message a été consigné par le service ArcGIS Data Store. Ces messages s'affichent uniquement si le service ArcGIS Data Store est inscrit auprès d'un site ArcGIS Server.
<nom_du_service>.FeatureServer	La source est un service d'entités.
<nom_du_service>.GeocodeServer	La source est un service de géocodage.
<nom_du_service>.GeoDataServer	La source est un service de géodonnées.
<nom_du_service>.GeometryServer	La source est un service de géométrie.
Geometry.GeometryServer	La source est le service de géométrie préconfiguré qui est installé sur ArcGIS Server.
<nom_du_service>.GlobeServer	La source est un service de globe.
<nom_du_service>.GPServer	La source est un service de géotraitement.
CachingTools.GPServer	La source se compose des outils de mise en cache préconfigurés qui sont installés avec ArcGIS Server.
PrintingTools.GPServer	La source est le service PrintingTools préconfiguré qui est installé sur ArcGIS Server.
PublishingTools.GPServer	La source se compose des outils de publication préconfigurés qui sont installés avec ArcGIS Server.
<nom_du_service>.ImageServer	La source est un service d'imagerie.
<nom_du_service>.JPIPServer	La source est un service JPIP.
<nom_du_service>.KmlServer	La source est un service KML.
<nom_du_service>.MapServer	La source est un service de carte.
<nom_du_service>.MobileServer	La source est un service de données mobiles.
<nom_du_service>.NAServer	La source est un service d'analyse du réseau.
<nom_du_service>.WCSServer	La source est un service WCS (Web Coverage Service).
<nom_du_service>.WFSServer	La source est un service WFS (Web Feature Service).
<nom_du_service>.WMServer	La source est un service Workflow Manager.
<nom_du_service>.WMSServer	La source est un service de carte Web.
<nom_du_service>.WMTSServer	La source est un service WMTS (Web Map Tile Service).
<nom_du_service>.WPSServer	La source est un service WPS (Web Processing Service).
<servicename>.SceneServer	La source est un service de scène.
<nom_du_service>.SchematicsServer	La source est un service Schematics.
<nom_du_service>.SearchServer	La source est un service de recherche.
SampleWorldCities.MapServer	La source est le service de carte SampleWorldCities préconfiguré qui est installé avec ArcGIS Server.
Search.SearchServer	La source est le service de recherche préconfiguré qui est installé sur ArcGIS Server.
Search_indexer.GPServer	La source est le service de géotraitement _indexer préconfiguré qui accompagne le service de recherche.
<nom_du_service_recherche>_indexer.GPServer	La source est le service de géotraitement _indexer qui accompagne le service de recherche.

Machine

Par défaut, toutes les machines sont interrogées (option Tout de la liste déroulante). Pour interroger les événements consignés sur une machine spécifique, sélectionnez la machine dans le filtre Machine.

Exploration des journaux de serveur

Lorsque vous exécutez une requête dans le module Afficher les journaux, la fenêtre des messages de consignation affiche les 1 000 messages les plus récents correspondants. La période de ces messages s'affiche au bas de la fenêtre.

Si votre requête renvoie plus de 1 000 messages, accédez au jeu d'enregistrements suivant en cliquant sur le bouton Plus ancien au bas de la fenêtre des messages de consignation. Vous pouvez également cliquer sur le bouton Plus récent pour parcourir les messages plus récents.

Lorsque vous parcourez les enregistrements, notez que la fenêtre des messages de consignation n'est pas mise à jour automatiquement en fonction des nouveaux messages qui ont peut-être été consignés après l'exécution de la requête. Pour obtenir les résultats les plus récents de votre requête, cliquez sur Requête dans le module Afficher les journaux.

Affichage des journaux dans un format imprimable

Après avoir exécuté une requête, cliquez sur le lien Vue imprimable pour afficher les journaux dans un format imprimable. Vous ouvrez une nouvelle fenêtre de navigateur (ou onglet) qui affiche les journaux au format HTML. Vous pouvez utiliser cette vue pour imprimer les journaux, les enregistrer sur le disque au format HTML ou copier et coller les journaux dans un document ou une feuille de calcul. De cette façon, vous pouvez partager vos messages de consignation avec d'autres utilisateurs dans votre organisation et, le cas échéant, avec le support technique d'Esri.

La vue imprimable n'affiche que la dernière requête exécutée, la vue courante de la fenêtre des messages de consignation et les éventuelles propriétés de consignation spécifiées. Cependant, si vous avez trié ou réorganisé les colonnes de l'affichage du journal d'événements, la vue HTML rétablit les colonnes sur l'état correspondant à la première exécution de la requête. Si vous le souhaitez, vous pouvez copier et coller les journaux dans une feuille de calcul et utiliser les outils de l'application pour trier et réorganiser les colonnes.

Suppression de journaux

Cliquez sur Supprimer les journaux pour supprimer l'ensemble des messages de consignation en provenance de chacun des serveurs SIG qui participent au site. Vous serez invité à confirmer la suppression de tous les messages après avoir cliqué sur Supprimer les journaux.

Lorsque vous déboguez un scénario à l'origine de problèmes avec votre serveur, la suppression des journaux peut vous aider à identifier le problème en question. Si vous essayez, par exemple, de déterminer les performances d'affichage d'une couche spécifique d'un service de carte, il peut s'avérer utile de supprimer le journal, d'envoyer une demande à la carte, puis de mettre à jour la fenêtre des messages de consignation afin d'afficher l'événement de demande. Tout autre événement est alors effacé du journal, ce qui vous permet de vous concentrer sur le débogage du service de carte.

Vous avez un commentaire à formuler concernant cette rubrique ?