Configurer la journalisation

La journalisation dans la bibliothèque cliente Java est configurée avec SLF4J, une façade de journalisation générique pour Java qui permet de diriger les journaux vers de nombreuses implémentations de journalisation différentes, telles que Log4j 2, Logback ou java.util.logging (JUL). Nous fournissons des exemples de fichiers de configuration pour Log4j 2 et JUL.

Mise en page et fonctionnalité des journaux

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

Type de journal Nom du journal Niveau de réussite Niveau d'échec
RÉSUMÉ com.google.ads.googleads.lib.request.summary INFO WARN
DÉTAILS com.google.ads.googleads.lib.request.detail DEBUG INFO

Troncature des journaux détaillés

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 la propriété JVM -Dapi.googleads.maxLogMessageLength=<number>. Si vous définissez -1, la troncature des journaux est désactivée.

Log4j 2

  1. Ajoutez une dépendance à la bibliothèque log4j-slf4j2-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-slf4j2-impl</artifactId>
  <version>2.x.y</version>
</dependency>

  2. (Facultatif) Créez un fichier de configuration log4j2.xml dans votre répertoire de ressources (par exemple, src/main/resources dans Maven). Log4j 2 charge son fichier de configuration à partir du chemin de classe, 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 dans la bibliothèque cliente.

Log4j 1.2 (hérité)

  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 src/main/resources dans Maven. Log4j 1.2 charge son fichier de configuration à partir du chemin de classe, 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 dans la bibliothèque cliente.

Java Util Logging

  1. Ajoutez une dépendance à la bibliothèque slf4j-jdk14, en remplaçant 2.x.y par la version SLF4J utilisée dans votre projet :

    <dependency>
  <groupId>org.slf4j</groupId>
  <artifactId>slf4j-jdk14</artifactId>
  <version>2.x.y</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 dans google-ads/src/main/resources/googleads-logging/jdk-logger.properties. JUL ne lit que le système de fichiers. Ne le copiez donc pas uniquement dans le répertoire de ressources du chemin de classe.

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