ورود به سیستم

Logging با SLF4J یک کتابخانه ورود به سیستم عمومی برای جاوا پیکربندی شده است که به لاگ ها اجازه می دهد تا به بسیاری از پیاده سازی های گزارش گیری مختلف هدایت شوند. ما فایل های پیکربندی را برای 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.xy با نسخه 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.xy با نسخه 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 فایل پیکربندی خود را از مسیر class، نه از دایرکتوری کاری بارگیری می کند، بنابراین مطمئن شوید که در فهرست منابع کپی می کنید.

3. برنامه خود را اجرا کنید و -Dlog4j.configuration=<CONFIG_FILE_PATH> را مشخص کنید. می‌توانید CONFIG_FILE_PATH=googleads-logging/log4j.properties را برای استفاده از فایل پیکربندی پیش‌فرض همراه با کتابخانه‌های سرویس گیرنده مشخص کنید.

جاوا 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 اجرا کنید.