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. Nous fournissons des fichiers de configuration 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, 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 |
---|---|---|---|
SUMMARY | com.google.ads.googleads.lib.request.summary | INFO | WARN |
DÉTAILS | com.google.ads.googleads.lib.request.detail | DEBUG | INFO |
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. Pour modifier la longueur à laquelle les journaux sont tronqués, définissez -Dapi.googleads.maxLogMessageLength=<number>
. La définition de -1
désactive la troncation des journaux.
Log4j 2
Ajoutez une dépendance à la bibliothèque
log4j-slf4j-impl
, en remplaçant2.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 chemin d'accès aux classes, et non du répertoire de travail. Veillez donc à créer un fichier dans un répertoire de ressources.Exécutez votre application en spécifiant
-Dlog4j.configurationFile=<CONFIG_FILE_PATH>
. Vous pouvez spécifierCONFIG_FILE_PATH=googleads-logging/log4j2.xml
pour utiliser le fichier de configuration par défaut inclus dans les bibliothèques clientes.
Log4j 1.2 (ancienne version)
Ajoutez une dépendance à la bibliothèque
slf4j-log4j12
, en remplaçant1.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. Veillez donc à le copier dans un répertoire de ressources.Exécutez votre application en spécifiant
-Dlog4j.configuration=<CONFIG_FILE_PATH>
. Vous pouvez spécifierCONFIG_FILE_PATH=googleads-logging/log4j.properties
pour utiliser le fichier de configuration par défaut inclus dans les bibliothèques clientes.
Journalisation Util Java
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 en indiquant un chemin d'accès lisible depuis votre application (par exemple,
./jdk-logger.properties
). Un modèle est fourni à l'adressegoogle-ads/src/main/resources/googleads-logging/jdk-logger.properties
. JUL ne lit que le système de fichiers. Vous ne devez donc pas la copier dans le répertoire de ressources.Exécutez votre application en spécifiant
-Djava.util.logging.config.file=./jdk-logger.properties
.