Journalisation

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

Disposition et fonctionnalités de la journalisation

Les requêtes sont consignées avec un résumé d'une ligne et le corps complet de la requête/réponse. et les en-têtes.

Troncation des journaux détaillés

Les journaux détaillés sont tronqués par défaut pour éviter de créer des journaux volumineux. À modifier la longueur de troncation des journaux, définir -Dapi.googleads.maxLogMessageLength=<number> Le paramètre -1 désactive la troncation des journaux.

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 le répertoire de ressources pour dans Maven: src/main/resources. Log4j 2 charge sa configuration à partir du chemin de classe, et non du répertoire de travail. Veillez donc à 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 la valeur par défaut de configuration inclus dans 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 des ressources de votre projet. Par exemple, dans Maven, le chemin d'accès est src/main/resources. Log4j 1.2 charge ses du chemin d'accès à la classe, et non du répertoire de travail. Assurez-vous donc que vous copiez 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 dans les bibliothèques clientes.

Journalisation Util Java

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, avec un chemin d'accès lisible à partir de votre application (par exemple, ./jdk-logger.properties). Un modèle est fourni à google-ads/src/main/resources/googleads-logging/jdk-logger.properties JUIL. les lectures à partir du système de fichiers uniquement. Par conséquent, ne les copiez pas dans le répertoire de ressources.

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