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.

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

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.