การบันทึก

การบันทึกได้รับการกำหนดค่าด้วย SLF4J ซึ่งเป็นไลบรารีการบันทึกทั่วไปสำหรับ Java ซึ่ง ช่วยให้สามารถส่งบันทึกไปยังการติดตั้งใช้งานการบันทึกที่แตกต่างกันได้มากมาย เรามีไฟล์การกำหนดค่าสำหรับ log4j 1.2/2 และ Java Util Logging (JUL)

เลย์เอาต์และการทำงานของการบันทึก

ระบบจะบันทึกคำขอพร้อมสรุป 1 บรรทัดและเนื้อหาคำขอ/คำตอบแบบเต็ม และส่วนหัว

ประเภทของบันทึก ชื่อบันทึก ระดับความสำเร็จ ระดับความล้มเหลว
สรุป com.google.ads.googleads.lib.request.summary ข้อมูล WARN
รายละเอียด com.google.ads.googleads.lib.request.detail DEBUG ข้อมูล

การตัดบันทึกโดยละเอียด

ระบบจะตัดบันทึกโดยละเอียดโดยค่าเริ่มต้นเพื่อหลีกเลี่ยงการสร้างบันทึกขนาดใหญ่ หากต้องการ เปลี่ยนความยาวที่ระบบตัดบันทึก ให้ตั้งค่า -Dapi.googleads.maxLogMessageLength=<number> การตั้งค่า -1 จะปิดใช้ การตัดทอนบันทึก

Log4j 2

  1. เพิ่มทรัพยากร Dependency ในไลบรารี log4j-slf4j-impl โดยแทนที่ 2.x.y ด้วยเวอร์ชันของ Log4j 2 ที่คุณใช้ในโปรเจ็กต์

    <dependency>
      <groupId>org.apache.logging.log4j</groupId>
      <artifactId>log4j-slf4j-impl</artifactId>
      <version>2.x.y</version>
    </dependency>
    
  2. (ไม่บังคับ) สร้างไฟล์การกำหนดค่าในไดเรกทอรีทรัพยากร เช่น ใน Maven: src/main/resources Log4j 2 โหลดไฟล์การกำหนดค่าจาก classpath ไม่ใช่ไดเรกทอรีการทำงาน ดังนั้นโปรดตรวจสอบว่าคุณสร้างไฟล์ในไดเรกทอรี resources

  3. เรียกใช้แอปพลิเคชันโดยระบุ -Dlog4j.configurationFile=<CONFIG_FILE_PATH> คุณระบุ CONFIG_FILE_PATH=googleads-logging/log4j2.xml เพื่อใช้ไฟล์การกำหนดค่าเริ่มต้น ที่รวมอยู่ในไลบรารีของไคลเอ็นต์ได้

Log4j 1.2 (เดิม)

  1. เพิ่มทรัพยากร Dependency ในไลบรารี slf4j-log4j12 โดยแทนที่ 1.x.y ด้วย เวอร์ชันของ Log4j 1.2 ที่คุณใช้ในโปรเจ็กต์

    <dependency>
      <groupId>org.slf4j</groupId>
      <artifactId>slf4j-log4j12</artifactId>
      <version>1.x.y</version>
    </dependency>
    
  2. (ไม่บังคับ) สร้างไฟล์การกำหนดค่าในไดเรกทอรีทรัพยากรของโปรเจ็กต์ เช่น ใน Maven เส้นทางคือ src/main/resources Log4j 1.2 โหลดไฟล์การกำหนดค่าจาก classpath ไม่ใช่ไดเรกทอรีการทำงาน ดังนั้นโปรดตรวจสอบว่าคุณได้คัดลอกไปยังไดเรกทอรีทรัพยากร

  3. เรียกใช้แอปพลิเคชันโดยระบุ -Dlog4j.configuration=<CONFIG_FILE_PATH> คุณสามารถระบุ CONFIG_FILE_PATH=googleads-logging/log4j.properties เพื่อใช้ ไฟล์การกำหนดค่าเริ่มต้นที่รวมอยู่ในไลบรารีของไคลเอ็นต์

การบันทึก Java Util

  1. เพิ่มการอ้างอิงในไลบรารี slf4j-jdk14

    <dependency>
      <groupId>org.slf4j</groupId>
      <artifactId>slf4j-jdk14</artifactId>
      <version>1.7.25</version>
    </dependency>
    
  2. สร้างไฟล์การกำหนดค่า JUL ในระบบไฟล์ในเส้นทางที่อ่านได้จาก แอปพลิเคชันของคุณ (เช่น ./jdk-logger.properties) โดยมีเทมเพลตให้ที่ google-ads/src/main/resources/googleads-logging/jdk-logger.properties JUL อ่านจากระบบไฟล์เท่านั้น ดังนั้นอย่าคัดลอกไปยังไดเรกทอรีทรัพยากร

  3. เรียกใช้แอปพลิเคชันโดยระบุ -Djava.util.logging.config.file=./jdk-logger.properties