Skip To Content

Consignation au journal

Dans cette rubrique

Options de consignation au journal

Cette section décrit les fichiers journaux pour l'application Web du géoportail et ses outils de bureau.

  1. Consignation au journal de l'application Web du géoportail
  2. Activation de la consignation au journal des clients du Géoportail
  3. Le fichier CswClient.log pour les clients CSW
  4. Le fichier publishMetadata.log pour le client de publication
  5. Le fichier WMCOpener.log pour le client WMC

Consignation au journal de l'application Web du Géoportail

Lorsque des erreurs ou d'autres problèmes se produisent dans l'interface du Géoportail, le meilleur endroit où rechercher les informations est les fichiers journaux. La consignation au journal de l'application Web du géoportail décrite ici est dans le contexte des implémentations à l'aide d'Apache Tomcat pour la consignation au journal du géoportail ou d'Oracle WebLogic pour la consignation au journal du géoportail comme serveur de l'application Web. Pour les autres logiciels du serveur de l'application Web pris en charge, vous pouvez utiliser les concepts décrits dans cette section et les appliquer au cadre de consignation au journal utilitaire Java.

Consignation au journal du géoportail pour Apache Tomcat

Les fichiers journaux de Tomcat se trouvent par défaut dans le répertoire <Tomcat Installation Directory>\logs. En plus des fichiers standard qui sont créés par Tomcat, le répertoire des journaux contiendra également un fichier journal du Géoportail ArcGIS Server, nommé gpt.xxxxxx.log xxxxxx est la date dans le format aaaa-mm-jj. Ce fichier journal est le premier endroit où rechercher les erreurs. Vous trouverez également d'autres informations sur le mécanisme de consignation au journal de Tomcat ici.

Le Géoportail ArcGIS Server permet de définir le niveau de consignation au journal pour obtenir plus ou moins de détails dans les fichiers journaux du géoportail. Le niveau de détails écrits dans le fichier gpt.xxxxx.log est défini dans le fichier <Tomcat Installation Directory>\webapps\geoportal\WEB-INF\classes\logging.properties. La variable com.esri.gpt.level détermine le niveau de consignation au journal et est définie à FIN par défaut. Les valeurs de niveau de consignation au journal acceptées sont :

  • GRAVE
  • AVERTISSEMENT
  • INFO
  • CONFIG
  • FIN
  • PLUS FIN
  • LE PLUS FIN
  • TOUT
Après avoir modifié le niveau de consignation au journal, redémarrez l'application Web du géoportail dans le Gestionnaire Tomcat ou redémarrez Tomcat complètement afin que vos modifications soient prises en compte.

Attention :

Le fait de définir le niveau de journal à FIN, PLUS FIN, LE PLUS FIN ou TOUT est un dépannage approprié, mais le niveau de journal doit être redéfini à son niveau d'origine lorsque le dépannage est terminé. Le fait de laisser la consignation au journal définie à ces niveaux entraînera que le fichier journal se développera rapidement et prendra l'espace du disque.

Consignation au journal du Géoportail pour Oracle WebLogic

Weblogic ne récupère pas le fichier logging.properties du géoportail par défaut dans le répertoire de classes du géoportail. Afin d'affecter les propriétés de consignation au journal, vous devez modifier le fichier logging.properties principal pour l'exécutable java exécutant WebLogic. Les étapes suivantes présentent la manière d'activer la génération d'un fichier journal pour l'application Web du géoportail et son écriture dans un répertoire en sortie de votre choix. Pour plus d'informations, voir la documentation en ligne Oracle pour la consignation au journal WebLogic.

  1. Localisez l'exécutable java exécutant weblogic, et dans ce dossier, ouvrez son fichier logging.properties dans un éditeur de texte.
    Astuce:

    Parfois, le fichier logging.properties de l'exécutable java de WebLogic se trouve dans le dossier \\bea\jrockit\jre\lib ou \\Oracle\Middleware\jdk\jre\lib.

  2. Dans le fichier logging.properties, trouvez le paramètre java.util.logging.ConsoleHandler.level et changez-le de INFO par défaut en LE PLUS FIN.
  3. Dans ce même fichier, faites défiler jusqu'à la fin du fichier où # les propriétés spécifiques à la ressource sont définies. En dessous de la ligne d'exemple pour la ressource com.xyz.foo.level = SEVERE, saisissez ce qui suit :
    com.esri.gpt.level = FINER
  4. Enregistrez le fichier logging.properties.
  5. Les scripts du serveur weblogic par défaut consignent au journal tous les messages sur la console du serveur. Afin de les rediriger vers un fichier journal, vous devez modifier le script de démarrage du serveur WebLogic. Démarrez en naviguant vers le fichier startWebLogic.cmd et en l'ouvrant dans un éditeur de texte. Le fichier startWebLogic se trouve souvent dans le dossier \\wlserver_10\samples\domains\wl_server\bin ou un chemin de fichier similaire.
  6. Dans le fichier startWebLogic.cmd, trouvez la ligne qui dit :
    set JAVA_OPTIONS=%SAVE_JAVA_OPTIONS%
  7. Ajoutez deux paramètres supplémentaires à cette variable JAVA_OPTIONS. Les deux paramètres définiront le nom de deux fichiers journaux du géoportail et l'emplacement où ils doivent être écrits. Dans notre exemple, nous écrivons ces deux fichiers journaux sur le disque C:\. Les deux paramètres sont -Dweblogic.Stdout="C:\geoportal-stdout" et -Dweblogic.Stderr="C:\geoportal-stderr". La variable JAVA_OPTIOINS doit désormais ressembler à l'exemple ci-dessous.
    set JAVA_OPTIONS=%SAVE_JAVA_OPTIONS% -Dweblogic.Stdout="C:\geoportal-stdout" -Dweblogic.Stderr="C:\geoportal-stderr"
  8. Enregistrez le fichier startWebLogic.cmd.
  9. Redémarrez le service WebLogic. Après le démarrage du service, les fichiers journaux de votre géoportail doivent être écrits sur le disque C:\.

Activez la consignation au journal pour les clients du Géoportail

La consignation au journal pour les clients CSW, le client de publication et le client WMC est désactivée par défaut. Pour l'activer, spécifier le chemin en sortie du fichier journal et définir la taille maximale du fichier journal, vous devez configurer les fichiers de propriétés des clients. Ces fichiers de propriétés se trouvent dans le répertoire d'installation ArcGIS Desktop, dans le dossier \\ArcGIS\Desktop10.0\bin et sont installés lorsque le client lui-même est installé. Pour les clients CSW d'ArcGIS Explorer, le fichier de propriétés se trouve à \\\Explorer\bin. Le fichier de propriétés correspondant pour chaque client est affiché ci-dessous.

Attention :

Si vous naviguez vers le répertoire \\ProgramFiles\ESRI\Geoportal\, vous verrez des sous-dossiers des clients qui contiennent également des fichiers de propriétés. Ces derniers sont les modèles utilisés lors de l'installation du client et ne sont pas référencés pour toute modification de consignation au journal apportée. Assurez-vous d'apporter toute modification de consignation au journal aux fichiers de propriétés dans le dossier \\ArcGIS\Desktop10.0\bin à la place.

Nom du client du GéoportailFichier de propriétés dans \\ArcGIS\Desktop10.0\bin

Clients CSW

CswClient.properties

Client de publication

PublishClient.properties

Client WMC

WMCOpener.properties

Chaque fichier de propriétés a les trois paramètres suivants, qui peuvent être définis comme décrits ci-dessous. Après avoir modifié le fichier de propriétés, vous devez relancer ArcGIS Desktop ou ArcGIS Explorer pour que vos modifications soient prises en compte.

ParamètreDescriptionValeurs acceptées

logFolder

Emplacement où les fichiers journaux doivent être écrits

chemin de fichier accessible sur le réseau

maxLogFileSizeInBytes

taille maximale autorisée pour le fichier journal

entier

débogage

active ou désactive la consignation au journal

Remarque :

Contrairement à la consignation au journal de l'application Web du géoportail, il y a seulement deux niveaux de consignation au journal pour les clients : activé ou désactivé

activé / désactivé

la valeur par défaut est désactivé

Le fichier CswClient.log pour les clients CSW

Après avoir activé la consignation au journal pour les clients CSW, vous pouvez rechercher le fichier journal pour voir les requêtes envoyées des clients CSW aux extrémités du catalogue CSW. Pour plus d'informations sur les requêtes et les réponses gérées par le client CSW, voir Comment les clients CSW fonctionnent. La recherche de la communication dans le fichier CswClient.log peut souvent révéler s'il y a un problème avec l'extrémité, le profil utilisé pour communiquer ou un autre problème de communication.

Le fichier publishMetadata.log pour le client de publication

Après avoir activé la consignation au journal pour le client de publication, vous pouvez rechercher le fichier journal publishMetadata.log pour obtenir des informations sur vos sessions de publication et les résultats des sessions de publication plus en détails. Un exemple de fichier journal est indiqué et décrit ci-dessous. Vous pouvez voir les autres messages à côté de ce qui est indiqué dans l'exemple, selon la ressource qui est publiée et si la session a été réussie.

************ Metadata Publishing started at   7/28/2010 11:20:38 AM ************
Publication Parameters
============================================================
Metadata Server Url           : http://myserver:8080/geoportal
Publish Metadata Service Name : GPT_Publish_Metadata
Selected Workspace Name       : \\networkServer\C$\Data\districts.shp.xml
Selected container category   : XML Document
============================================================
EndPoint Type : DEFAULT
Publish url : http://myserver:8080/geoportal/rest/manage/document
Publish request : <metadata xml here>
Publish response : 
Publication successful for \\networkServer\C$\Data\districts.shp.xml
************ Metadata Publishing completed at 7/28/2010 11:20:46 AM ************

Ce fichier journal montre l'heure de début et de fin de la session de publication, les paramètres en entrée de la session et la réponse si la session de publication a été réussie ou non. La requête de publication inclut les métadonnées dans les documents que le client de publication trouve et publie. Le type d'extrémité indique si l'extrémité du géoportail par défaut, qui est l'extrémité REST, est utilisée ou si l'extrémité CSW ou l'extrémité du servlet est utilisée. L'url de publication est l'url vers l'extrémité. Dans cet exemple, vous pouvez voir que l'url de l'extrémité REST est indiquée.

Le fichier WMCOpener.log pour le client WMC

Après avoir activé la consignation au journal pour le client WMC, vous pouvez rechercher le fichier journal WMCOpener.log pour obtenir des informations sur les services référencés lorsque vous avez utilisé le client WMC. Le fichier WMCOpener.log donnera les informations de service lues à partir du fichier WMC et signalera si la couche a en réalité été ajoutée à la carte. En cas de problème avec le service et s'il n'est pas ajouté à la carte, les informations de service seront indiquées dans le journal, mais elles ne diront pas s'il a été ajouté.