Logging

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

Tata letak dan fungsi logging

Permintaan dicatat ke dalam log dengan ringkasan satu baris serta header dan isi permintaan/respons lengkap.

Jenis log	Nama log	Tingkat keberhasilan	Tingkat kegagalan
RINGKASAN	com.google.ads.googleads.lib.request.summary	INFO	WARN
DETAIL	com.google.ads.googleads.lib.request.detail	DEBUG	INFO

Poin Penting: Mutasi permintaan dengan Kegagalan sebagian yang benar tidak akan menyebabkan seluruh permintaan gagal. Dengan demikian, log kegagalan sebagian selalu dicatat ke dalam log pada tingkat Keberhasilan, bukan pada tingkat Kegagalan seperti yang mungkin diharapkan.

Pemotongan Log Detail

Log mendetail terpotong secara default untuk menghindari pembuatan log yang besar. Untuk mengubah panjang saat log terpotong, tetapkan -Dapi.googleads.maxLogMessageLength=<number>. Menyetel -1 akan menonaktifkan pemotongan 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, misalnya, di Maven: src/main/resources. Log4j 2 memuat file konfigurasinya dari classpath, bukan direktori kerja, jadi pastikan Anda membuat 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, di Maven, jalurnya 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.

Logging Util Java

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 di sistem file dalam 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 menyalin ke direktori resource.

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