التسجيل

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

تخطيط التسجيل ووظائفه

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

نوع السجلّ	اسم السجلّ	مستوى النجاح	مستوى الفشل
الملخّص	com.google.ads.googleads.lib.request.summary	معلومات	تحذير
التفصيل	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 ملف الإعداد الخاص به من مسار classpath، وليس من دليل العمل، لذا احرص على إنشاء ملف في دليل الموارد.

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 ملف التكوين من مسار 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.