Mengonfigurasi logging

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

  1. Tambahkan dependensi pada library log4j-slf4j2-impl, dengan mengganti 2.x.y dengan 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>
    
  2. (Opsional) Buat file konfigurasi log4j2.xml di direktori resources Anda (misalnya, src/main/resources di Maven). Log4j 2 memuat file konfigurasinya dari classpath, bukan direktori kerja, jadi pastikan Anda membuatnya 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 src/main/resources di Maven. 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.

Java Util Logging

  1. Tambahkan dependensi pada library slf4j-jdk14, dengan mengganti 2.x.y dengan versi SLF4J yang digunakan dalam project Anda:

    <dependency>
      <groupId>org.slf4j</groupId>
      <artifactId>slf4j-jdk14</artifactId>
      <version>2.x.y</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 salin hanya ke direktori resource classpath.

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