קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
הרישום ביומן מוגדר באמצעות SLF4J, ספריית רישום ביומן כללית ל-Java, שמאפשרת להפנות יומנים להטמעות שונות של רישום ביומן. אנחנו מספקים קובצי הגדרות ל-log4j 1.2/2 ול-Java Util Logging (JUL).
פריסה ופונקציונליות של רישום ביומן
הבקשות מתועדות עם סיכום בשורה אחת והגוף והכותרות המלאים של הבקשה או התשובה.
סוג יומן הביקורת
שם יומן הביקורת
רמת ההצלחה
רמת הכשל
סיכום
com.google.ads.googleads.lib.request.summary
מידע
WARN
פרטים
com.google.ads.googleads.lib.request.detail
ניפוי באגים
מידע
חיתוך של יומן מפורט
כברירת מחדל, היומנים המפורטים נחתכים כדי למנוע יצירת יומנים גדולים. כדי לשנות את האורך שבו היומנים נחתכים, מגדירים את -Dapi.googleads.maxLogMessageLength=<number>. ההגדרה -1 משביתה את חיתוך היומן.
Log4j 2
מוסיפים תלות בספרייה log4j-slf4j-impl, ומחליפים את 2.x.y בגרסה של 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.x.y בגרסה של Log4j 1.2 שבה משתמשים בפרויקט.
(אופציונלי) יוצרים קובץ הגדרות בספריית המשאבים של הפרויקט, לדוגמה, ב-Maven, הנתיב הוא src/main/resources. Log4j 1.2 טוען את קובץ ההגדרה שלו מנתיב המחלקה, ולא מספריית העבודה, לכן צריך להעתיק אותו לספריית משאבים.
מריצים את האפליקציה ומציינים את -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.
[null,null,["עדכון אחרון: 2025-08-27 (שעון UTC)."],[[["\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`."]]
