Pour discuter de nos produits et nous faire part de vos commentaires, rejoignez le canal Discord officiel Google Ads sur le serveur de la communauté Google Advertising and Measurement.

Cette page a été traduite par l'API Cloud Translation.

Journalisation

La journalisation est configurée 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 des fichiers de configuration pour log4j 1.2/2 et Java Util Logging (JUL).

Mise en page et fonctionnalité de la journalisation

Les requêtes sont consignées avec un résumé d'une ligne, ainsi que le corps et les en-têtes complets de la requête/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

Troncation 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 vous définissez -1, la troncature des journaux est désactivée.

Log4j 2

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>

(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 classpath, et non du répertoire de travail. Assurez-vous donc de le créer dans un répertoire de ressources.
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)

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>
```
(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 son fichier de configuration à partir du classpath, et non du répertoire de travail. Assurez-vous donc de le copier dans un répertoire de ressources.
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.

Journalisation Java Util

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

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

Créez un fichier de configuration JUL sur le système de fichiers dans un chemin d'accès lisible depuis 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 lit uniquement à partir du système de fichiers. Ne copiez donc pas dans le répertoire des ressources.
Exécutez votre application en spécifiant -Djava.util.logging.config.file=./jdk-logger.properties.