تتم تهيئة التسجيل باستخدام 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
أضِف تبعية إلى مكتبة
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>
(اختياري) أنشئ ملف إعداد في دليل الموارد، على سبيل المثال، في Maven:
src/main/resources
. يحمّل Log4j 2 ملف التهيئة الخاص به من مسار الفئة، وليس من دليل العمل، لذا تأكد من إنشاء دليل موارد.شغِّل التطبيق مع تحديد
-Dlog4j.configurationFile=<CONFIG_FILE_PATH>
. يمكنك تحديدCONFIG_FILE_PATH=googleads-logging/log4j2.xml
لاستخدام ملف الإعداد التلقائي المضمّن في مكتبات العملاء.
Log4j 1.2 (الإصدار القديم)
أضِف تبعية إلى مكتبة
slf4j-log4j12
، مع استبدال1.x.y
بإصدار Log4j 1.2 الذي تستخدمه في مشروعك.<dependency> <groupId>org.slf4j</groupId> <artifactId>slf4j-log4j12</artifactId> <version>1.x.y</version> </dependency>
(اختياري) أنشئ ملف إعداد في دليل موارد المشاريع، على سبيل المثال، في Maven، يكون المسار
src/main/resources
. يحمّل Log4j 1.2 ملف التهيئة من مسار الفئة، وليس من دليل العمل، لذا تأكد من النسخ إلى دليل الموارد.شغِّل التطبيق، مع تحديد
-Dlog4j.configuration=<CONFIG_FILE_PATH>
. يمكنك تحديدCONFIG_FILE_PATH=googleads-logging/log4j.properties
لاستخدام ملف الإعداد التلقائي المضمّن في مكتبات العملاء.
تسجيل استخدام Java
إضافة اعتمادية إلى مكتبة "
slf4j-jdk14
"<dependency> <groupId>org.slf4j</groupId> <artifactId>slf4j-jdk14</artifactId> <version>1.7.25</version> </dependency>
أنشئ ملف إعداد تموز (يوليو) على نظام الملفات في مسار قابل للقراءة من تطبيقك (على سبيل المثال،
./jdk-logger.properties
). يتم توفير نموذج فيgoogle-ads/src/main/resources/googleads-logging/jdk-logger.properties
. يقرأ JUL من نظام الملفات فقط، لذلك لا تنسخه إلى دليل الموارد.شغِّل تطبيقك مع تحديد
-Djava.util.logging.config.file=./jdk-logger.properties
.