Mengonfigurasi logging

Logging di library klien Java dikonfigurasi dengan SLF4J, facade logging generik untuk Java yang memungkinkan log diarahkan ke berbagai implementasi logging, seperti Log4j 2, Logback, atau java.util.logging (JUL). Kami menyediakan contoh file konfigurasi untuk Log4j 2 dan JUL.

Tata letak dan fungsi log

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

Pemotongan log detail

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

Log4j 2

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

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

2. (Opsional) Buat file konfigurasi log4j2.xml di direktori resource Anda (misalnya, src/main/resources di Maven). Log4j 2 memuat file konfigurasinya 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:

   <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 src/main/resources di Maven. Log4j 1.2 memuat file konfigurasinya dari classpath, bukan direktori kerja, jadi pastikan Anda menyalinnya 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, dengan mengganti 2.x.y dengan versi SLF4J yang digunakan dalam project Anda:

   <dependency>
     <groupId>org.slf4j</groupId>
     <artifactId>slf4j-jdk14</artifactId>
     <version>2.x.y</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 hanya ke direktori resource classpath.

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