Utiliser les journaux de l’organisation

Le suivi des journaux de l’organisation vous permet d’identifier les erreurs et de résoudre les problèmes rencontrés par l’organisation. Utilisez l’ArcGIS Portal Administrator Directory pour afficher, interroger, configurer et supprimer les journaux de votre organisation. Le Répertoire administrateur du portail rassemble les messages de journaux dans une table que vous pouvez lire et manipuler.

Les événements consignés au journal de chaque composant de votre organisation sont accessibles à partir du Répertoire administrateur du portail. Vous pouvez continuer à utiliser ArcGIS Server Manager pour indiquer les paramètres des journaux du serveur, supprimer des journaux du serveur et utiliser toutes les options de filtre.

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

• Capturer, interroger et afficher des événements
• Utilisation de filtres d'événements dans une requête pour affiner les résultats des recherches
• Supprimer les journaux

Capturer, interroger et afficher des événements

Lorsqu’un événement se produit dans l’organisation, 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, procédez comme suit :

1. Ouvrez le Répertoire d’administrateur du portail et connectez-vous en tant qu’administrateur. L’URL est généralement disponible à l’adresse suivante : https://webadaptorhost.example.com/webadaptorname/portaladmin.
2. Cliquez sur Journaux > Requête.
3. Conservez tous les paramètres par défaut et cliquez sur Requête.

Certains messages sont retournés avec des informations supplémentaires. Par exemple, vous verrez les messages suivants si un utilisateur entre un mot de passe incorrect un nombre trop élevé de fois et que son compte est verrouillé :

Dans le scénario ci-dessus, l’utilisateur john_cho essayait de se connecter en saisissant un mot de passe erroné. Après cinq tentatives, la stratégie de verrouillage du compte a été appliquée et le compte a été verrouillé. Ce scénario peut également montrer qu’un utilisateur malveillant tente d’accéder à l’organisation.

Tous les événements enregistrent les informations ci-dessus, telles que le type de niveau de consignation, l’heure de l’événement, le composant source qui l’a consigné au journal, la machine sur laquelle l’événement s’est produit, l’utilisateur associé à l’événement, le code de consignation, l’ID du traitement et l’ID de la requête. Toutes ces informations peuvent vous aider à dépanner votre organisation avec plus d’efficacité. Reportez-vous à la rubrique Fonctionnement des journaux pour obtenir une explication détaillée de ces informations.

Lorsque vous suspectez un problème

Si vous suspectez un problème avec l’organisation, ou si un utilisateur signale un problème, reproduisez l’événement, consignez-le dans les journaux, interrogez les journaux pour obtenir des informations sur l’événement, puis utilisez les informations du journal pour résoudre le problème causé 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.

Conseil :

Si vous pensez que le problème touche plusieurs composants, il est recommandé de sélectionner vos serveurs fédérés pour interroger les journaux. Les journaux de serveur et les journaux ArcGIS Data Store peuvent fournir des informations supplémentaires qui vous aident à résoudre le problème.

Vous trouverez ci-dessous des exemples de capture d'événements, d'interrogation et d'identification de ces événements à l'aide des journaux.

• L'utilisateur ne parvient pas à ajouter une pièce jointe à un service d'entités
• L'utilisateur spécifie un nom d'utilisateur ou un mot de passe non valide
• L'élément est déplacé d'un dossier à un autre
• L’organisation est définie en lecture seule

L'utilisateur ne parvient pas à ajouter une pièce jointe à un service d'entités

Dans cet exemple, un utilisateur signale qu’il ne parvient pas à ajouter une pièce jointe à un service d’entités. Il a essayé plusieurs fois mais le fichier ne se charge pas. Pour capturer ce type d’événement, vous devez d’abord définir le niveau de consignation du portail sur INFO.

Une fois que le portail consigne les messages au niveau INFO, procédez comme suit :

1. Demandez à l’utilisateur de reproduire le problème et d’enregistrer les étapes ainsi que la durée nécessaires à la reproduction du problème.
2. Ouvrez le Répertoire d’administrateur du portail et connectez-vous en tant qu’administrateur. L’URL est généralement disponible à l’adresse suivante : https://webadaptorhost.example.com/webadaptorname/portaladmin.
3. Cliquez sur Journaux > Requête.
   1. Indiquez les valeurs de durée obtenues par l'utilisateur. Le format est yyyy-mm-ddThh:mm:ss. Par exemple, l’heure de début est 2015-05-10T14:05:00 et l’heure de fin est 2015-05-10T14:03:00.
   2. Indiquez que la requête doit retourner des messages au niveau de consignation INFOS.
   3. Dans le champ Users (Utilisateurs), indiquez le nom d’utilisateur du membre. Par exemple, jcho pour John Cho.
   4. Cliquez sur Requête.
4. Consultez le champ Message pour voir les messages liés au problème.

Vous découvrez le message suivant :

Failed to add attachment. File size limit of 20 MB exceeded for feature service '/gis/rest/services/Hosted/parks3k_19/FeatureServer/0/1/addAttachment'.

Vous savez à présent que l'utilisateur essayait de charger un fichier qui dépassait la taille limite des fichiers. Dites-lui de réduire la taille de son fichier afin qu'elle soit inférieure à 20 Mo.

L'utilisateur spécifie un nom d'utilisateur ou un mot de passe non valide

Pour capturer ce type d’événement, vous devez d’abord définir le niveau de consignation du portail sur WARNING (AVERTISSEMENT) ou un niveau inférieur.

Une fois que le portail consigne les messages au niveau WARNING (AVERTISSEMENT), procédez comme suit :

1. Ouvrez le Répertoire d’administrateur de portail et connectez-vous en tant qu’administrateur. L’URL est généralement disponible à l’adresse suivante : https://webadaptorhost.example.com/webadaptorname/portaladmin.
2. Cliquez sur Journaux > Requête.
3. Vérifiez que le niveau de consignation est défini sur WARNING (AVERTISSEMENT). Ignorez tous les autres champs, car celui-ci renvoie des messages de niveau avertissement pour tous les utilisateurs.
4. Consultez le champ Message pour voir les messages liés au problème.

Vous découvrez le message suivant :

Sign in error: Invalid username or password specified for 'asmith'.

Ce message indique que l’utilisateur asmith (Ashley Smith) a indiqué un nom d’utilisateur ou un mot de passe non valide lorsqu’il a essayé de se connecter à l’organisation. Surveillez ces événements pour empêcher tout accès non autorisé.

L'élément est déplacé d'un dossier à un autre

Pour capturer ce type d’événement, vous devez d’abord définir le niveau de consignation du portail sur INFO.

Une fois que le portail consigne les messages au niveau INFO, procédez comme suit :

1. Ouvrez le Répertoire d’administrateur de portail et connectez-vous en tant qu’administrateur. L’URL est généralement disponible à l’adresse suivante : https://webadaptorhost.example.com/webadaptorname/portaladmin.
2. Cliquez sur Journaux > Requête.
3. Vérifiez que le niveau de consignation est défini sur INFO. Ignorez tous les autres champs, car celui-ci renvoie des messages de niveau informations pour tous les utilisateurs depuis que le niveau a été défini.
4. Cliquez sur Requête.
5. Consultez le champ Message pour voir les messages liés au problème.

Vous découvrez le message suivant :

Item moved from folder 'jcho/(Home)' to folder 'jcho/(Home)/Utilities'. Item ID is 'b7557bd2691b4e74bc4ce3e373402cc6'.

Ce message indique que l’utilisateur jcho (John Cho) a déplacé un élément (dont l’ID est b7557bd2691b4e74bc4ce3e373402cc6) de son dossier d’accueil (Home) vers un sous-répertoire de ce dossier nommé Utilities.

L’organisation est définie en lecture seule

Pour capturer les événements qui se produisent sur tous les composants lorsque vous définissez l’organisation sur le mode de lecture seule, vous devez d’abord définir le niveau de consignation des composants sur INFO ou un niveau inférieur. Pour plus d’informations, reportez-vous aux rubriques Spécifier les paramètres des journaux du portail et Spécifier les paramètres de journal du serveur.

Une fois que les composants consignent les messages au niveau INFO ou inférieur et que l’organisation est définie sur le mode de lecture seule, procédez comme suit :

1. Ouvrez le Répertoire d’administrateur de portail et connectez-vous en tant qu’administrateur. L’URL est généralement disponible à l’adresse suivante : https://webadaptorhost.example.com/webadaptorname/portaladmin.
2. Cliquez sur Journaux > Requête.
3. Vérifiez que le niveau de consignation est défini sur INFO et cliquez sur Query (Requête).
4. Identifiez le message de journal indiquant que l’organisation a été définie sur le mode de lecture seule et notez l’ID de requête de ce message.

   Successfully set the organization to read-only mode

5. Cliquez sur Query (Requête) pour revenir à l’interrogation des messages des journaux.
6. Saisissez l’ID de requête noté à l’étape 4 dans le champ RequestIDs.
7. Sélectionnez All (Tout) dans le champ Federated Servers (Serveurs fédérés).
8. Cliquez sur Query (Requête) et examinez les journaux de tous les composants associés à la définition de l’organisation sur le mode de lecture seule.

Utilisation de filtres d’événements dans une requête pour affiner les résultats des recherches

Pour affiner les événements et afficher des messages plus pertinents, vous pouvez interroger les journaux en fonction du niveau de consignation, du composant source, de l’heure, d’un code ou d’une plage de codes de consignation spécifique, d’un utilisateur ou d’une liste d’utilisateurs spécifique, et de l’ID de la requête. Vous pouvez associer les filtres de votre choix au sein de votre requête.

Pour interroger tous les messages de journal de votre organisation, vous pouvez sélectionner vos serveurs fédérés. L’heure et l’ID de la requête permettent de filtrer les messages de journal dans tous les composants, tandis que les autres options permettent de ne filtrer que les journaux du portail. Pour utiliser plus d’options de filtrage des journaux de serveur, utilisez ArcGIS Server Manager.

Pour accéder à ces filtres, connectez-vous au Répertoire d’administrateur du portail et cliquez sur Home (Accueil) > Logs (Journaux) > Query (Requête).

Niveau de consignation

Les événements 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 portail. Sélectionnez le niveau souhaité dans la liste déroulante Niveau de consignation. Pour consulter un résumé détaillé de chaque niveau, reportez-vous à la rubrique Type de journal.

Source

Sources à partir desquelles les événements consignés sont générés (composants de partage, d’administration ou du portail des logiciels). Par exemple :

• Les événements liés à la publication et aux utilisateurs sont classé sous Partage.
• Les événements liés à la sécurité et à l'indexation sont classés sous Administration du portail.
• Les événements liés à l'installation des logiciels sont classé sous Portail.

Par défaut, toutes les sources sont interrogées (option All (Tout) de la liste déroulante). Pour filtrer les événements du portail en fonction d’une source spécifique, sélectionnez la source souhaitée dans la liste déroulante Source.

Durée

Pour filtrer les événements selon une période spécifique, indiquez les valeurs de date souhaitées dans les champs Start Time (Heure de début) et End Time (Heure de fin) (au format yyyy-mm-ddThh:mm:ss). L'heure de début est l'heure la plus récente et l'heure de fin la plus ancienne. Par exemple :

• Pour définir un intervalle de temps de 15 minutes, l’heure de début est 2015-05-01T13:15:00 et l’heure de fin est 2015-05-01T13:00:00.
• Pour définir un intervalle d’une heure, l’heure de début est 2015-05-01T14:00:00 et l’heure de fin est 2015-05-01T13:00:00.
• Pour définir une journée, l’heure de début est 2015-05-02T12:00:00 et l’heure de fin est 2015-05-01T12:00:00.
• Pour interroger tous les journaux, laissez les champs de date vides.

Si l'heure de début est spécifiée, mais pas l'heure de fin, tous les journaux les plus anciens jusqu'à l'heure de début indiquée sont retournés. Inversement, si l'heure de fin est spécifiée, mais pas celle de début, tous les journaux les plus récents jusqu'à l'heure de fin indiquée sont retournés.

Si cette option est sélectionnée, les événements consignés sur les serveurs fédérés sont également filtrés.

Codes de consignation

Chaque message est accompagné d'un code de consignation. Les codes sont classés en plusieurs catégories. Vous pouvez filtrer les journaux du portail en fonction d’un code ou d’une plage de codes spécifique, par exemple :

• Pour filtrer avec un code unique, spécifiez la valeur du code (par exemple, 204028).
• Pour filtrer avec plusieurs codes, séparez-les par des virgules (,) (par exemple, 204028, 212015, 219114).
• Pour filtrer selon une plage de codes, tels que tous les codes de la catégorie de sécurité, indiquez le premier et le dernier code en les séparant par un tiret (-) (par exemple, 204000–205999).
• Pour filtrer en fonction d’une plage de codes et de codes individuels, spécifiez le premier et le dernier code (séparés par un tiret) et séparez les codes individuels par des virgules (par exemple, 204000–205999, 212015, 219114).

Utilisateurs

Pour filtrer des événements de portail pour un utilisateur spécifique, indiquez le nom de cet utilisateur dans le champ Users (Utilisateurs), par exemple :

• Pour filtrer des événements pour un utilisateur spécifique, indiquez le nom de l’utilisateur (par exemple, jcho pour John Cho).
• Pour filtrer des événements pour plusieurs utilisateurs, séparez leurs noms par des virgules (,) (par exemple, jcho, asmith pour John Cho et Ashley Smith).

Remarque :

L’utilisation du caractère générique (*) n’est pas prise en charge.

ID de requête

Chaîne d’ID unique associée à chaque requête effectuée et traitée tout au long du cycle de vie de la requête dans le système. Sélectionnez un ou tous les serveurs fédérés si vous appliquez un filtre par ID de requête concernant une opération qui recouvrent plusieurs composants.

Nombre de messages

Nombre de messages qui s'affichent lorsque vous exécutez une requête. Les messages s'affichent sur une page Web unique. Si nécessaire, faites défiler la page pour voir tous les messages.

Serveurs fédérés

Pour résoudre des problèmes ou obtenir des informations touchant plusieurs composants ArcGIS Enterprise, incluez les journaux de serveur dans la requête en sélectionnant un ou tous les serveurs fédérés. Si vous interrogez les journaux du serveur d’hébergement, les journaux d’ArcGIS Data Store sont également inclus.

Supprimer les journaux

Si vous voulez supprimer les journaux, cliquez sur Accueil > Journaux > Nettoyer > Effacer les journaux. Cette opération supprime tous les messages des journaux de la machine du portail. Lorsque vous déboguez un scénario spécifique à l'origine de problèmes avec votre portail, la suppression des journaux peut vous aider à identifier le problème en question. Tout autre événement est alors effacé du journal, ce qui vous permet de vous concentrer sur le débogage du problème.

Pour supprimer des journaux de serveur, utilisez ArcGIS Server Manager.