Logging

Logging dikonfigurasi dengan SLF4J, library logging generik untuk Java, yang memungkinkan log diarahkan ke banyak implementasi logging yang berbeda. Kami menyediakan file konfigurasi untuk log4j 1.2/2 dan Java Util Logging (JUL).

Tata letak dan fungsi logging

Permintaan dicatat dengan ringkasan satu baris dan isi/header permintaan/respons lengkap.

Pemangkasan Log Detail

Log mendetail dipangkas secara default untuk menghindari pembuatan log berukuran besar. Untuk mengubah panjang log yang dipangkas, tetapkan -Dapi.googleads.maxLogMessageLength=<number>. Menyetel -1 akan menonaktifkan pemangkasan log.

Log4j 2

1. Tambahkan dependensi pada library log4j-slf4j-impl, dengan mengganti 2.x.y dengan versi Log4j 2 yang Anda gunakan dalam project.

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

2. (Opsional) Buat file konfigurasi di direktori resource Anda, misalnya, di Maven: src/main/resources. Log4j 2 memuat file konfigurasi dari classpath, bukan direktori kerja, jadi pastikan Anda membuatnya di direktori resource.

3. Jalankan aplikasi Anda, dengan menentukan -Dlog4j.configurationFile=<CONFIG_FILE_PATH>. Anda dapat menentukan CONFIG_FILE_PATH=googleads-logging/log4j2.xml untuk menggunakan file konfigurasi default yang disertakan dengan library klien.

Log4j 1.2 (lama)

1. Tambahkan dependensi pada library slf4j-log4j12, dengan mengganti 1.x.y dengan versi Log4j 1.2 yang Anda gunakan dalam project Anda.

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

2. (Opsional) Buat file konfigurasi di direktori resource project Anda, misalnya, di Maven, jalur adalah src/main/resources. Log4j 1.2 memuat file konfigurasinya dari classpath, bukan direktori kerja, jadi pastikan Anda menyalin ke direktori resource.

3. Jalankan aplikasi Anda, dengan menentukan -Dlog4j.configuration=<CONFIG_FILE_PATH>. Anda dapat menentukan CONFIG_FILE_PATH=googleads-logging/log4j.properties untuk menggunakan file konfigurasi default yang disertakan dengan library klien.

Java Util Logging

1. Tambahkan dependensi pada library slf4j-jdk14.

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

2. Buat file konfigurasi JUL pada sistem file di jalur yang dapat dibaca dari aplikasi Anda (misalnya, ./jdk-logger.properties). Template disediakan di google-ads/src/main/resources/googleads-logging/jdk-logger.properties. JUL hanya membaca dari sistem file, jadi jangan salin ke direktori resource.

3. Jalankan aplikasi Anda dengan menentukan -Djava.util.logging.config.file=./jdk-logger.properties.