Logging di library klien Java dikonfigurasi dengan SLF4J, fasad 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.
| 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 |
Pemangkasan log detail
Log mendetail dipangkas secara default untuk menghindari pembuatan log berukuran besar. Untuk
mengubah panjang log yang dipangkas, tetapkan properti JVM
-Dapi.googleads.maxLogMessageLength=<number>. Menyetel -1 akan menonaktifkan pemangkasan log.
Log4j 2
Tambahkan dependensi pada library
log4j-slf4j2-impl, dengan mengganti2.x.ydengan 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>(Opsional) Buat file konfigurasi
log4j2.xmldi direktori resources Anda (misalnya,src/main/resourcesdi Maven). Log4j 2 memuat file konfigurasinya dari classpath, bukan direktori kerja, jadi pastikan Anda membuatnya di direktori resource.Jalankan aplikasi Anda, dengan menentukan
-Dlog4j.configurationFile=<CONFIG_FILE_PATH>. Anda dapat menentukanCONFIG_FILE_PATH=googleads-logging/log4j2.xmluntuk menggunakan file konfigurasi default yang disertakan dengan library klien.
Log4j 1.2 (lama)
Tambahkan dependensi pada library
slf4j-log4j12, dengan mengganti1.x.ydengan versi Log4j 1.2 yang Anda gunakan dalam project:<dependency> <groupId>org.slf4j</groupId> <artifactId>slf4j-log4j12</artifactId> <version>1.x.y</version> </dependency>(Opsional) Buat file konfigurasi di direktori resource project Anda, misalnya
src/main/resourcesdi Maven. Log4j 1.2 memuat file konfigurasinya dari classpath, bukan direktori kerja, jadi pastikan Anda menyalinnya ke direktori resource.Jalankan aplikasi Anda, dengan menentukan
-Dlog4j.configuration=<CONFIG_FILE_PATH>. Anda dapat menentukanCONFIG_FILE_PATH=googleads-logging/log4j.propertiesuntuk menggunakan file konfigurasi default yang disertakan dengan library klien.
Java Util Logging
Tambahkan dependensi pada library
slf4j-jdk14, dengan mengganti2.x.ydengan versi SLF4J yang digunakan dalam project Anda:<dependency> <groupId>org.slf4j</groupId> <artifactId>slf4j-jdk14</artifactId> <version>2.x.y</version> </dependency>Buat file konfigurasi JUL di sistem file dalam jalur yang dapat dibaca dari aplikasi Anda (misalnya,
./jdk-logger.properties). Template disediakan digoogle-ads/src/main/resources/googleads-logging/jdk-logger.properties. JUL hanya membaca dari sistem file, jadi jangan salin hanya ke direktori resource classpath.Jalankan aplikasi Anda dengan menentukan
-Djava.util.logging.config.file=./jdk-logger.properties.