Logging

Logging dikonfigurasi dengan SLF4J, library logging umum untuk Java, yang memungkinkan log diarahkan ke banyak implementasi {i>logging<i} 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 permintaan/respons lengkap dan header.

Pemotongan Log Detail

Log mendetail dipotong secara default untuk menghindari pembuatan log berukuran besar. Kepada ubah panjang log yang dipotong, setel -Dapi.googleads.maxLogMessageLength=<number>. Menyetel -1 akan menonaktifkan pemotongan log.

Log4j 2

1. Menambahkan dependensi pada library log4j-slf4j-impl, dengan menggantikan 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, sebagai misalnya, di Maven: src/main/resources. Log4j 2 memuat konfigurasinya dari classpath, bukan direktori kerja, jadi pastikan Anda membuat resource Anda.

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

Log4j 1.2 (lama)

1. Tambahkan dependensi pada library slf4j-log4j12, yang mengganti 1.x.y dengan versi Log4j 1.2 yang Anda gunakan dalam proyek 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, misalnya, di Maven, jalurnya adalah src/main/resources. Log4j 1.2 memuat dari classpath, bukan direktori kerja, jadi pastikan yang disalin ke direktori resource.

3. Jalankan aplikasi Anda, dengan menentukan -Dlog4j.configuration=<CONFIG_FILE_PATH>. Anda dapat menentukan CONFIG_FILE_PATH=googleads-logging/log4j.properties yang akan digunakan file konfigurasi {i>default<i} yang disertakan dengan pustaka klien.

Logging Java Util

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 adalah disediakan di google-ads/src/main/resources/googleads-logging/jdk-logger.properties. JULI membaca dari sistem file saja, jadi jangan menyalinnya ke direktori sumber daya.

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