Logging

การบันทึกได้รับการกําหนดค่าด้วย 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 ไม่ใช่ไดเรกทอรีทํางาน ดังนั้นโปรดตรวจสอบว่าคุณสร้างไฟล์ในไดเรกทอรีทรัพยากร

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