Logging

Logging dikonfigurasi dengan SLF4J, yaitu library logging umum untuk Java, sehingga log dapat 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 isi dan header 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: Mengubah permintaan dengan Kegagalan sebagian bernilai benar (true) tidak akan menyebabkan seluruh permintaan gagal. Dengan demikian, log kegagalan parsial selalu dicatat ke dalam log pada Tingkat sukses, bukan pada tingkat Kegagalan seperti yang mungkin diharapkan.

Pemotongan Log Detail

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

Log4j 2

1. Tambahkan dependensi pada library log4j-slf4j-impl, yang 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 dari direktori kerja. Jadi, pastikan Anda membuatnya dalam 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, yang 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 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.

Logging Utilitas 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 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 menyalin ke direktori resource.

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