التسجيل

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

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