التسجيل

تتم تهيئة التسجيل باستخدام SLF4J، وهي مكتبة تسجيل عامة للغة Java، ما يسمح بتوجيه السجلات إلى العديد من تطبيقات التسجيل المختلفة. نحن نوفّر ملفات تهيئة لـ log4j 1.2/2 وJava U النوع 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 ملف التهيئة الخاص به من مسار الفئة، وليس من دليل العمل، لذا تأكد من إنشاء دليل موارد.

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

1. إضافة اعتمادية إلى مكتبة "slf4j-jdk14"

   <dependency>
     <groupId>org.slf4j</groupId>
     <artifactId>slf4j-jdk14</artifactId>
     <version>1.7.25</version>
   </dependency>
   

2. أنشئ ملف إعداد تموز (يوليو) على نظام الملفات في مسار قابل للقراءة من تطبيقك (على سبيل المثال، ./jdk-logger.properties). يتم توفير نموذج في google-ads/src/main/resources/googleads-logging/jdk-logger.properties. يقرأ JUL من نظام الملفات فقط، لذلك لا تنسخه إلى دليل الموارد.

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