ArcGIS Notebook Server consigne dans des journaux tous les événements qui se produisent sur un site, ainsi que toutes les erreurs associées à ces événements. Ces journaux sont disponibles pour les administrateurs du site.
Les journaux constituent un outil important de contrôle et de résolution des problèmes que présente votre site ArcGIS Notebook Server. Les informations fournies par ces journaux peuvent vous aider à identifier les erreurs et à disposer d’un contexte pour la résolution des problèmes et des erreurs. Les journaux servent également de système d’enregistrement des événements qui se produisent sur votre site.
Les types d’événements suivants sont ainsi enregistrés dans les journaux :
- Installation et mise à niveau, par exemple autorisation logicielle et création de sites
- Ouverture et fermeture des notebooks ArcGIS
- Tâches de nettoyage effectuées par le site
- Tâches de gestion du site effectuées par les administrateurs, par exemple ajout ou suppression des runtimes de notebook, création de répertoires de serveur ou configuration des paramètres de sécurité.
- Événements de sécurité, par exemple connexion des utilisateurs au site ou importation et exportation de certificats SSL.
Certains événements ne sont pas enregistrés dans les journaux ArcGIS Notebook Server. Il s’agit notamment de la fédération et de l’annulation de la fédération du site avec un portail. Les événements qui ont lieu sur les notebooks ArcGIS (ajout de contenu, exécution de cellules, etc.) ne sont pas enregistrés. Les événements qui ont lieu dans les conteneurs Docker de votre machine ne sont pas non plus enregistrés ; pour consulter des journaux propres au conteneur, reportez-vous à la section Consulter les journaux des conteneurs Docker ci-dessous.
Niveaux de consignation disponibles
Chaque journal est associé à un niveau de consignation des détails, qui peut être l’un des suivants (du moins détaillé au plus détaillé) :
- Severe (Grave) - Problèmes graves nécessitant une attention immédiate.
- Warning (Avertissement) - Problèmes modérés nécessitant votre attention.
- Info - Messages courants sur l’administration du serveur, y compris les messages relatifs à la création et au démarrage de services.
- Fine (Fin) - Messages courants sur l’utilisation du serveur, comme le nom des demandes d’opération reçues.
- Verbose (Commentaires) - Messages fournissant plus d’informations sur la façon dont le serveur exécute les opérations.
- Debug (Débogage) - 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. Utilisation non recommandée sur les systèmes de production en raison du nombre de journaux créés.
Dans le répertoire administrateur ArcGIS Notebook Server, vous pouvez spécifier le niveau de consignation le plus détaillé à créer. Par exemple, si vous définissez le niveau sur Fine (Fin), le site de votre serveur consignera les messages des niveaux de détail Severe (Grave), Warning (Avertissement), Info et Fine (Fin).
Accéder aux journaux de serveur et les interroger
Utilisez le répertoire administrateur ArcGIS Notebook Server pour interroger, afficher, configurer et supprimer les journaux de serveur.
Pour accéder aux journaux, procédez comme suit :
- Connectez-vous au répertoire administrateur. L’URL est au format https://notebookserver.domain.com:11443/arcgis/adminou https://notebookserver.domain.com/<webadaptorname>/admin.
- Cliquez sur Logs (Journaux) > Query (Requête) pour interroger et consulter les journaux actuels. Utilisez les contrôles de filtre sur la page pour vous aider à restreindre les événements par catégories, par exemple la période ou le niveau de consignation.
- Cliquez sur Logs (Journaux) > Settings (Paramètres) pour gérer les paramètres des journaux, tels que le niveau de consignation par défaut (comme expliqué ci-dessus), la durée de conservation des journaux sur le disque et l’emplacement auquel les journaux sont écrits.
- Cliquez sur Clean Logs (Effacer les journaux) pour supprimer tous vos fichiers journaux du site ArcGIS Notebook Server.
Afficher les journaux de conteneur Docker
Vous pouvez afficher les journaux propres aux conteneurs Docker de votre site grâce à l’interface de ligne de commande Docker, en procédant comme suit.
- Connectez-vous au répertoire administrateur. L’URL est au format https://notebookserver.domain.com:11443/arcgis/adminou https://notebookserver.domain.com/<webadaptorname>/admin.
- Accédez à System (Système) > Containers (Conteneurs). Localisez le conteneur dont vous voulez afficher les journaux, puis cliquez sur son ID.
- Ouvrez l’affichage JSON de la page d’informations sur le conteneur en ajoutant ?f=pjson à son URL. L’URL est alors au format https://notebookserver.arcgis.com/<webadaptorname>/admin/system/containers/<container>?f=pjson.
- Localisez le paramètre containerId du conteneur et enregistrez sa valeur.
- Ouvrez un terminal en tant qu’utilisateur disposant de privilèges Docker.
- Exécutez la commande docker logs <containerId> en utilisant la valeur que vous avez enregistrée. Cette opération renverra les journaux Docker spécifiques à ce conteneur.
Vous avez un commentaire à formuler concernant cette rubrique ?