التسجيل

يتم ضبط التسجيل باستخدام SLF4J، وهي مكتبة تسجيل عامة للغة Java، تتيح توجيه السجلات إلى العديد من عمليات تنفيذ التسجيل المختلفة. نوفّر ملفات إعداد لكل من log4j 1.2/2 وJava Util Logging (JUL).

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

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

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

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

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

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

Log4j 2

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

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

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

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. (اختياري) أنشئ ملف إعداد في دليل موارد المشاريع، على سبيل المثال، في Maven، يكون المسار src/main/resources. يحمّل الإصدار 1.2 من Log4j ملف الإعدادات من مسار الفئة، وليس من دليل العمل، لذا احرص على نسخه إلى دليل الموارد.

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

Java Util Logging

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.