پیکربندی ورود به سیستم، پیکربندی ورود به سیستم

ثبت وقایع در کتابخانه کلاینت جاوا با SLF4J پیکربندی شده است، یک نمای عمومی ثبت وقایع برای جاوا که امکان هدایت وقایع به پیاده‌سازی‌های مختلف ثبت وقایع، مانند Log4j 2، Logback یا java.util.logging (JUL) را فراهم می‌کند. ما فایل‌های پیکربندی نمونه برای Log4j 2 و JUL ارائه می‌دهیم.

طرح‌بندی و عملکرد لاگ

درخواست‌ها با یک خلاصه تک‌خطی و متن کامل درخواست و پاسخ و سرآیندها ثبت می‌شوند.

نوع گزارش	نام لاگ	سطح موفقیت	سطح شکست
خلاصه	com.google.ads.googleads.lib.request.summary	اطلاعات	هشدار
جزئیات	com.google.ads.googleads.lib.request.detail	اشکال‌زدایی	اطلاعات

کوتاه‌سازی لاگ جزئیات

گزارش‌های تفصیلی به طور پیش‌فرض کوتاه می‌شوند تا از ایجاد گزارش‌های بزرگ جلوگیری شود. برای تغییر طولی که گزارش‌ها کوتاه می‌شوند، ویژگی JVM را به صورت -Dapi.googleads.maxLogMessageLength=<number> تنظیم کنید. تنظیم -1 کوتاه‌سازی گزارش را غیرفعال می‌کند.

لاگ۴جی ۲

1. یک وابستگی به کتابخانه log4j-slf4j2-impl اضافه کنید و 2.xy با نسخه Log4j 2 که در پروژه خود استفاده می‌کنید جایگزین کنید:

   <dependency>
     <groupId>org.apache.logging.log4j</groupId>
     <artifactId>log4j-slf4j2-impl</artifactId>
     <version>2.x.y</version>
   </dependency>
   

2. (اختیاری) یک فایل پیکربندی log4j2.xml در دایرکتوری resources خود ایجاد کنید (برای مثال، src/main/resources در Maven). Log4j 2 فایل پیکربندی خود را از classpath بارگذاری می‌کند، نه از دایرکتوری working، بنابراین مطمئن شوید که آن را در دایرکتوری resources ایجاد می‌کنید.

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. (اختیاری) یک فایل پیکربندی در دایرکتوری منابع پروژه خود ایجاد کنید، برای مثال src/main/resources در Maven. Log4j 1.2 فایل پیکربندی خود را از classpath بارگذاری می‌کند، نه از دایرکتوری کاری، بنابراین مطمئن شوید که آن را در دایرکتوری منابع کپی می‌کنید.

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

ثبت وقایع کاربردی جاوا

1. یک وابستگی به کتابخانه slf4j-jdk14 اضافه کنید و 2.xy با نسخه SLF4J مورد استفاده در پروژه خود جایگزین کنید:

   <dependency>
     <groupId>org.slf4j</groupId>
     <artifactId>slf4j-jdk14</artifactId>
     <version>2.x.y</version>
   </dependency>
   

2. یک فایل پیکربندی JUL روی سیستم فایل در مسیری که از برنامه شما قابل خواندن باشد (برای مثال، ./jdk-logger.properties ) ایجاد کنید. یک الگو در google-ads/src/main/resources/googleads-logging/jdk-logger.properties ارائه شده است. JUL فقط از سیستم فایل می‌خواند، بنابراین آن را فقط در دایرکتوری منابع classpath کپی نکنید.

3. برنامه خود را با مشخص کردن -Djava.util.logging.config.file=./jdk-logger.properties اجرا کنید.