Journalisation

La journalisation est configurée avec SLF4J, une bibliothèque de journalisation générique pour Java, qui permet de rediriger les journaux vers de nombreuses implémentations de journalisation différentes. Nous fournissons des fichiers de configuration pour log4j 1.2/2 et Java Util Logging (JUL).

Mise en page et fonctionnalité de journalisation

Les requêtes sont enregistrées avec un résumé en une ligne, ainsi que le corps et les en-têtes complets de la requête/réponse.

Troncature du journal détaillé

Les journaux détaillés sont tronqués par défaut pour éviter de créer des journaux volumineux. Pour modifier la longueur à laquelle les journaux sont tronqués, définissez -Dapi.googleads.maxLogMessageLength=<number>. Si la propriété -1 est définie sur -1, la troncation du journal est désactivée.

Log4j 2

1. Ajoutez une dépendance à la bibliothèque log4j-slf4j-impl, en remplaçant 2.x.y par la version de Log4j 2 que vous utilisez dans votre projet.

   <dependency>
     <groupId>org.apache.logging.log4j</groupId>
     <artifactId>log4j-slf4j-impl</artifactId>
     <version>2.x.y</version>
   </dependency>
   

2. (Facultatif) Créez un fichier de configuration dans votre répertoire de ressources, par exemple dans Maven: src/main/resources. Log4j 2 charge son fichier de configuration à partir du chemin d'accès aux classes, et non du répertoire de travail. Veillez donc à le créer dans un répertoire de ressources.

3. Exécutez votre application en spécifiant -Dlog4j.configurationFile=<CONFIG_FILE_PATH>. Vous pouvez spécifier CONFIG_FILE_PATH=googleads-logging/log4j2.xml pour utiliser le fichier de configuration par défaut inclus avec les bibliothèques clientes.

Log4j 1.2 (ancienne version)

1. Ajoutez une dépendance à la bibliothèque slf4j-log4j12, en remplaçant 1.x.y par la version de Log4j 1.2 que vous utilisez dans votre projet.

   <dependency>
     <groupId>org.slf4j</groupId>
     <artifactId>slf4j-log4j12</artifactId>
     <version>1.x.y</version>
   </dependency>
   

2. (Facultatif) Créez un fichier de configuration dans le répertoire de ressources de votre projet. Par exemple, dans Maven, le chemin d'accès est src/main/resources. Log4j 1.2 charge son fichier de configuration à partir du chemin d'accès aux classes, et non du répertoire de travail. Veillez donc à le copier dans un répertoire de ressources.

3. Exécutez votre application en spécifiant -Dlog4j.configuration=<CONFIG_FILE_PATH>. Vous pouvez spécifier CONFIG_FILE_PATH=googleads-logging/log4j.properties pour utiliser le fichier de configuration par défaut inclus avec les bibliothèques clientes.

Java Util Logging

1. Ajoutez une dépendance à la bibliothèque slf4j-jdk14.

   <dependency>
     <groupId>org.slf4j</groupId>
     <artifactId>slf4j-jdk14</artifactId>
     <version>1.7.25</version>
   </dependency>
   

2. Créez un fichier de configuration JUL sur le système de fichiers dans un chemin lisible à partir de votre application (par exemple, ./jdk-logger.properties). Un modèle est fourni à l'adresse google-ads/src/main/resources/googleads-logging/jdk-logger.properties. JUL ne lit que le système de fichiers. Ne le copiez donc pas dans le répertoire des ressources.

3. Exécutez votre application en spécifiant -Djava.util.logging.config.file=./jdk-logger.properties.