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 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

Pemotongan Log Detail

Log mendetail dipotong secara default untuk menghindari pembuatan log berukuran besar. Untuk mengubah panjang log yang dipotong, 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 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 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 disediakan di google-ads/src/main/resources/googleads-logging/jdk-logger.properties. JUL hanya membaca dari sistem file, jadi jangan menyalinnya ke direktori resource.

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