Logging

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

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

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

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

ประเด็นหลัก: เปลี่ยนแปลงคำขอที่ความล้มเหลวบางส่วนเป็นจริงจะไม่ทำให้คำขอทั้งคำขอล้มเหลว ดังนั้น ระบบจะบันทึกบันทึกความล้มเหลวบางส่วนที่ระดับความสำเร็จเสมอ ไม่ใช่ระดับความล้มเหลวอย่างที่คาดไว้

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

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

บันทึก 4j 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 ไม่ใช่ไดเรกทอรีที่ใช้งานได้ ดังนั้นคุณควรสร้างในไดเรกทอรีทรัพยากร

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

1. เพิ่มทรัพยากร Dependency ในไลบรารี 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