با مجموعهها، منظم بمانید
ذخیره و طبقهبندی محتوا براساس اولویتهای شما.
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
یک وابستگی به کتابخانه log4j-slf4j-impl اضافه کنید و 2.xy با نسخه Log4j 2 که در پروژه خود استفاده می کنید جایگزین کنید.
(اختیاری) یک فایل پیکربندی در فهرست منابع خود ایجاد کنید، به عنوان مثال، در Maven: src/main/resources . Log4j 2 فایل پیکربندی خود را از مسیر کلاس، نه از دایرکتوری کاری بارگیری می کند، بنابراین مطمئن شوید که در یک فهرست منابع ایجاد می کنید.
برنامه خود را اجرا کنید و -Dlog4j.configurationFile=<CONFIG_FILE_PATH> را مشخص کنید. می‌توانید CONFIG_FILE_PATH=googleads-logging/log4j2.xml را برای استفاده از فایل پیکربندی پیش‌فرض همراه با کتابخانه‌های سرویس گیرنده مشخص کنید.
Log4j 1.2 (میراث)
یک وابستگی به کتابخانه slf4j-log4j12 اضافه کنید و 1.xy با نسخه Log4j 1.2 که در پروژه خود استفاده می کنید جایگزین کنید.
(اختیاری) یک فایل پیکربندی در فهرست منابع پروژه خود ایجاد کنید، به عنوان مثال، در Maven، مسیر src/main/resources است. Log4j 1.2 فایل پیکربندی خود را از مسیر class، نه از دایرکتوری کاری بارگیری می کند، بنابراین مطمئن شوید که در فهرست منابع کپی می کنید.
برنامه خود را اجرا کنید و -Dlog4j.configuration=<CONFIG_FILE_PATH> را مشخص کنید. می‌توانید CONFIG_FILE_PATH=googleads-logging/log4j.properties را برای استفاده از فایل پیکربندی پیش‌فرض همراه با کتابخانه‌های سرویس گیرنده مشخص کنید.
یک فایل پیکربندی JUL در سیستم فایل در مسیری قابل خواندن از برنامه خود ایجاد کنید (به عنوان مثال، ./jdk-logger.properties ). یک الگو در google-ads/src/main/resources/googleads-logging/jdk-logger.properties ارائه شده است. JUL فقط از فایل سیستم می خواند، بنابراین در فهرست منابع کپی نکنید.
برنامه خود را با مشخص کردن -Djava.util.logging.config.file=./jdk-logger.properties اجرا کنید.
تاریخ آخرین بهروزرسانی 2025-08-26 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-08-26 بهوقت ساعت هماهنگ جهانی."],[[["\u003cp\u003eLogging is managed through SLF4J, offering flexibility with log4j 1.2/2 and Java Util Logging configurations.\u003c/p\u003e\n"],["\u003cp\u003eRequest logging includes a summary line along with detailed request/response bodies and headers at configurable log levels.\u003c/p\u003e\n"],["\u003cp\u003eDetailed logs are truncated by default, adjustable via the \u003ccode\u003e-Dapi.googleads.maxLogMessageLength\u003c/code\u003e system property.\u003c/p\u003e\n"],["\u003cp\u003eConfiguration instructions and examples are provided for setup with Log4j 2, Log4j 1.2, and Java Util Logging.\u003c/p\u003e\n"]]],[],null,["# Logging is configured with SLF4J a generic logging library for Java, which\nallows logs to be directed to many different logging implementations. We provide\nconfiguration files for log4j 1.2/2 and Java Util Logging (JUL).\n\nLogging layout and functionality\n--------------------------------\n\nRequests are logged with a one line summary and the full request/response body\nand headers.\n\n| Log type | Log name | Success level | Failure level |\n|----------|----------------------------------------------|---------------|---------------|\n| SUMMARY | com.google.ads.googleads.lib.request.summary | INFO | WARN |\n| DETAIL | com.google.ads.googleads.lib.request.detail | DEBUG | INFO |\n\n| **Key Point:** Mutate requests where [Partial\n| failure](/google-ads/api/samples/handle-partial-failure) is true won't cause the entire request to fail. Thus, partial failure logs are always logged at Success level, not at Failure level as might be expected.\n\nDetail Log Truncation\n---------------------\n\nThe detailed logs are truncated by default to avoid creating large logs. To\nchange the length at which logs are truncated, set\n`-Dapi.googleads.maxLogMessageLength=\u003cnumber\u003e`. Setting `-1` disables\nlog truncation.\n\nLog4j 2\n-------\n\n1. Add a dependency on the `log4j-slf4j-impl` library, substituting\n `2.x.y` with the version of Log4j 2 you are using in your project.\n\n \u003cdependency\u003e\n \u003cgroupId\u003eorg.apache.logging.log4j\u003c/groupId\u003e\n \u003cartifactId\u003elog4j-slf4j-impl\u003c/artifactId\u003e\n \u003cversion\u003e2.x.y\u003c/version\u003e\n \u003c/dependency\u003e\n\n2. (Optional) Create a configuration file in your resources directory, for\n example, in Maven: `src/main/resources`. Log4j 2 loads its configuration\n file from the classpath, not the working directory, so ensure you create in a\n resources directory.\n\n3. Run your application, specifying\n `-Dlog4j.configurationFile=\u003cCONFIG_FILE_PATH\u003e`. You can specify\n `CONFIG_FILE_PATH=googleads-logging/log4j2.xml` to use the default\n configuration file included with the client libraries.\n\nLog4j 1.2 (legacy)\n------------------\n\n1. Add a dependency on the `slf4j-log4j12` library, substituting `1.x.y` with\n the version of Log4j 1.2 you are using in your project.\n\n \u003cdependency\u003e\n \u003cgroupId\u003eorg.slf4j\u003c/groupId\u003e\n \u003cartifactId\u003eslf4j-log4j12\u003c/artifactId\u003e\n \u003cversion\u003e1.x.y\u003c/version\u003e\n \u003c/dependency\u003e\n\n2. (Optional) Create a configuration file in your projects resources directory,\n for example, in Maven, path is `src/main/resources`. Log4j 1.2 loads its\n configuration file from the classpath, not the working directory, so ensure\n you copy to a resources directory.\n\n3. Run your application, specifying `-Dlog4j.configuration=\u003cCONFIG_FILE_PATH\u003e`.\n You can specify `CONFIG_FILE_PATH=googleads-logging/log4j.properties` to use\n the default configuration file includedwith the client libraries.\n\nJava Util Logging\n-----------------\n\n1. Add a dependency on the `slf4j-jdk14` library.\n\n \u003cdependency\u003e\n \u003cgroupId\u003eorg.slf4j\u003c/groupId\u003e\n \u003cartifactId\u003eslf4j-jdk14\u003c/artifactId\u003e\n \u003cversion\u003e1.7.25\u003c/version\u003e\n \u003c/dependency\u003e\n\n2. Create a JUL configuration file on the file system in a path readable from\n your application (for instance, `./jdk-logger.properties`). A template is\n provided at\n `google-ads/src/main/resources/googleads-logging/jdk-logger.properties`. JUL\n reads from the filesystem only, so do not copy to the resources directory.\n\n3. Run your application specifying\n `-Djava.util.logging.config.file=./jdk-logger.properties`."]]
