ضبط التسجيل

يتم ضبط التسجيل في مكتبة برامج Java باستخدام SLF4J، وهي واجهة تسجيل عامة للغة Java تتيح توجيه السجلات إلى العديد من عمليات التسجيل المختلفة، مثل Log4j 2 أو Logback أو java.util.logging (JUL). نوفّر نماذج لملفات الإعداد لكل من Log4j 2 وJUL.

تنسيق السجلّ ووظائفه

يتم تسجيل الطلبات مع ملخّص من سطر واحد والطلب الكامل ونص الاستجابة والعناوين.

نوع السجلّ	اسم السجلّ	مستوى النجاح	مستوى الخطأ
الملخّص	com.google.ads.googleads.lib.request.summary	معلومات	WARN
التفصيل	com.google.ads.googleads.lib.request.detail	تصحيح الأخطاء	معلومات

نقطة أساسية: طلبات التغيير التي تكون فيها قيمة partial failure هي true لا تؤدي إلى تعذُّر تنفيذ الطلب بالكامل. وبالتالي، يتم دائمًا تسجيل سجلّات الأخطاء الجزئية على مستوى "النجاح"، وليس على مستوى "الخطأ".

اقتطاع السجلّ التفصيلي

يتم اقتطاع السجلّات التفصيلية تلقائيًا لتجنُّب إنشاء سجلّات كبيرة. لتغيير طول السجلات التي يتم اقتطاعها، اضبط السمة -Dapi.googleads.maxLogMessageLength=<number> في جهاز Java الافتراضي (JVM). يؤدي ضبط -1 إلى إيقاف اقتطاع السجلّ.

Log4j 2

1. أضِف تبعية على مكتبة 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 ملف الإعداد من مسار الفئة، وليس من دليل العمل، لذا تأكّد من إنشائه في دليل الموارد.

3. شغِّل تطبيقك مع تحديد -Dlog4j.configurationFile=<CONFIG_FILE_PATH>. يمكنك تحديد CONFIG_FILE_PATH=googleads-logging/log4j2.xml لاستخدام ملف الإعداد التلقائي المضمّن في مكتبة العميل.

الإصدار 1.2 من Log4j (قديم)

1. أضِف تبعية على مكتبة 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 ملف الإعداد من مسار الفئة، وليس من دليل العمل، لذا تأكَّد من نسخه إلى دليل الموارد.

3. شغِّل تطبيقك مع تحديد -Dlog4j.configuration=<CONFIG_FILE_PATH>. يمكنك تحديد CONFIG_FILE_PATH=googleads-logging/log4j.properties لاستخدام ملف الإعداد التلقائي المضمّن في مكتبة البرامج.

Java Util Logging

1. أضِف تبعية على مكتبة 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 من نظام الملفات فقط، لذا لا تنسخه إلى دليل موارد مسار الفئة فقط.

3. شغِّل تطبيقك مع تحديد -Djava.util.logging.config.file=./jdk-logger.properties.