التسجيل

يتم ضبط التسجيل باستخدام 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	تصحيح الأخطاء	معلومات

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

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

يتم اقتطاع السجلّات التفصيلية تلقائيًا لتجنُّب إنشاء سجلّات كبيرة. ل تغيير الطول الذي يتم اقتطاع السجلات عنده، اضبط -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 ملف الإعدادات من مسار الفصل، وليس من الدليل العامل، لذا تأكَّد من إنشائه في ملف resources.

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

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.