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
- Comprendre le fonctionnement des journaux
- Utiliser des filtres de journaux pour affiner les résultats des recherches
- Explorer les journaux de serveur
- Afficher les journaux dans un format imprimable
- Supprimer les journaux
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 Se connecter au gestionnaire.
- Cliquez sur Logs (Journaux) > View Logs (Afficher les journaux) pour consulter les journaux existants. 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 Verbose (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 pour capturer des messages plus détaillés sur ce problème spécifique. Pour savoir comment modifier le niveaux de consignation, reportez-vous à la rubrique Spécifier les paramètres du journal du serveur dans Manager.
Résoudre les problèmes
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é, procédez comme suit 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.
- Si aucune information n’est présente, augmentez le niveaux de consignation. Reproduisez le problème, interrogez les journaux et consultez les messages.
- 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.
- Si le problème ne peut pas être reproduit, interrogez les journaux et consultez les messages pour obtenir des informations sur le problème.
Conseil :
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.
Comprendre le 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.
Conseil :
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.
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.
Remarque :
ArcGIS Server peut uniquement conserver 1 000 journaux à la fois. Seuls les 1 000 journaux les plus récents sont conservés, quels que soient les autres paramètres que vous avez sélectionnés pour la rétention des journaux.
La fréquence des messages de consignation augmente lorsque vous augmentez le niveau de détail. Par exemple, davantage de messages sont enregistrés au niveau FINE qu’au niveau SEVERE.
Nous vous recommandons de conserver le niveau de consignation SEVERE, WARNING ou INFO, sauf si vous avez besoin de l’augmenter pour résoudre des problèmes.
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. | Traitement de la requête impossible. Service Planning/counties/FeatureServer introuvable. |
| Avertissement | Problèmes modérés nécessitant votre attention. Ce niveau comprend également des messages graves. | Échec de connexion. Spécification d'un nom d'utilisateur ou d'un mot de passe non valide. |
| Informations | 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éé. |
| Correct | 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ée | La consignation est désactivée. Les événements ne sont pas consignés sur le serveur. | N/D |
Durée
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 Time (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. 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.
Voici quelques exemples :
- Un événement associé au service de carte SampleWorldCities apparaît sous la forme SampleWorldCities.MapServer.
- Après la création d’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 fait partie du site conserve des journaux propres à cette machine. Si vous avez inscrit ArcGIS Data Store auprès de votre site, chaque machine Data Store consigne également les messages spécifiques à cette machine.
Par exemple, un serveur 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.
Request ID (ID de la requête)
Il s’agit de la chaîne d’ID unique jointe lors de son envoi à chaque requête soumise à ArcGIS Server, qui est conservée tout au long du cycle de vie de la requête dans le système.
Nom de la méthode
Il s’agit de la méthode appelée sur le service qui a provoqué le message de consignation.
Utiliser des 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. Choisissez le niveau souhaité dans la liste déroulante Log Filter (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 |
|---|---|
| 15 dernières minutes | Affiche les événements consignés durant les 15 dernières minutes. |
| Dernière heure | Affiche les événements consignés durant l'heure qui vient de s'écouler. |
| 6 dernières heures | Affiche les événements consignés au cours des dernières six 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 de ArcGIS Server ou sur la période de conservation des journaux sur disque que vous avez définie pour le site |
Cliquez sur l’en-tête de colonne Time (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 Last Week (La semaine dernière)dans le filtre Age (Âge) lorsque la durée de conservation des journaux a été configurée sur cinq jours, seuls les journaux des cinq derniers jours seront renvoyés.
Conseil :
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 de journal du serveur.
Source
La source de l’événement consigné peut être un service ou le serveur. 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 défaut, toutes les sources sont interrogées (option All (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 Server Framework (Structure du serveur) dans le filtre Source. Pour interroger ces sources, sélectionnez Server Framework (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>.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>.KmlServer | La source est un service KML. |
| <nom_du_service>.MapServer | La source est un service de carte. |
| <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). |
| <nom_du_service>.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
Chaque machine serveur fait partie du site conserve des journaux propres à cette machine. Si vous avez inscrit ArcGIS Data Store auprès de votre site, chaque machine Data Store consigne également les messages spécifiques à cette machine.
Par défaut, toutes les machines sont interrogées (option All (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.
Explorer les journaux de serveur
Lorsque vous exécutez une requête dans le module View Logs (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.
Afficher les 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 manière, vous pouvez partager vos messages de consignation avec d’autres utilisateurs dans votre organisation et, le cas échéant, avec le support 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. 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.
Supprimer les journaux
Cliquez sur Delete Logs (Supprimer les journaux) pour supprimer l’ensemble des messages de consignation en provenance de chacun des serveurs 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. Tous les autres événements sont alors effacés 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 ?