กําหนดค่าการบันทึก

การบันทึกในไลบรารีไคลเอ็นต์ Java ได้รับการกำหนดค่าด้วย SLF4J ซึ่งเป็นส่วนหน้าการบันทึกทั่วไปสำหรับ Java ที่ช่วยให้สามารถส่งบันทึกไปยังการติดตั้งใช้งานการบันทึกที่แตกต่างกันได้หลายแบบ เช่น Log4j 2, Logback หรือ java.util.logging (JUL) เรา มีไฟล์การกำหนดค่าตัวอย่างสำหรับ Log4j 2 และ JUL

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

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

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

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

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

Log4j 2

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

   <dependency>
     <groupId>org.apache.logging.log4j</groupId>
     <artifactId>log4j-slf4j2-impl</artifactId>
     <version>2.x.y</version>
   </dependency>
   

2. (ไม่บังคับ) สร้างlog4j2.xmlไฟล์การกำหนดค่าในไดเรกทอรีทรัพยากร (เช่น src/main/resources ใน Maven) Log4j 2 โหลดไฟล์กำหนดค่าจาก Classpath ไม่ใช่ไดเรกทอรีการทำงาน ดังนั้นโปรดตรวจสอบว่าคุณสร้างไฟล์ในไดเรกทอรีทรัพยากร

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. (ไม่บังคับ) สร้างไฟล์การกำหนดค่าในไดเรกทอรีทรัพยากรของโปรเจ็กต์ เช่น src/main/resources ใน Maven Log4j 1.2 โหลดไฟล์ การกำหนดค่าจาก classpath ไม่ใช่ไดเรกทอรีการทำงาน ดังนั้น โปรดตรวจสอบว่าคุณได้คัดลอกไฟล์ไปยังไดเรกทอรีทรัพยากร

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

การบันทึก Java Util

1. เพิ่มทรัพยากร Dependency ในไลบรารี slf4j-jdk14 โดยแทนที่ 2.x.y ด้วย เวอร์ชัน SLF4J ที่ใช้ในโปรเจ็กต์

   <dependency>
     <groupId>org.slf4j</groupId>
     <artifactId>slf4j-jdk14</artifactId>
     <version>2.x.y</version>
   </dependency>
   

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

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