Logging

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

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

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

ประเภทของบันทึก	ชื่อบันทึก	ระดับความสำเร็จ	ระดับความล้มเหลว
สรุป	com.google.ads.googleads.lib.request.summary	ข้อมูล	เตือน
รายละเอียด	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 ไม่ใช่ไดเรกทอรีที่ใช้งานได้ ดังนั้นโปรดสร้างในไดเรกทอรีทรัพยากร

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 เดือนกรกฎาคมจะอ่านจากระบบไฟล์เท่านั้น ดังนั้นอย่าคัดลอกไปยังไดเรกทอรีทรัพยากร

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