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

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