הרישום ביומן מוגדר באמצעות SLF4J, ספריית רישום כללית ל-Java, שמאפשרת להפנות יומנים להטמעות רבות של רישום ביומן. אנחנו מספקים קובצי תצורה ל-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.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 טוען את קובץ התצורה שלו מה-classpath, ולא מספריית העבודה, ולכן חשוב להקפיד להעתיק לספריית משאבים.מפעילים את האפליקציה, ומציינים את
-Dlog4j.configuration=<CONFIG_FILE_PATH>
. אפשר לציין אתCONFIG_FILE_PATH=googleads-logging/log4j.properties
כך שישתמש בקובץ התצורה שמוגדר כברירת מחדל בספריות הלקוח.
רישום ביומן של Java Util
צריך להוסיף תלות בספרייה
slf4j-jdk14
.<dependency> <groupId>org.slf4j</groupId> <artifactId>slf4j-jdk14</artifactId> <version>1.7.25</version> </dependency>
יוצרים קובץ תצורה של JUL במערכת הקבצים בנתיב שהאפליקציה שלכם יכולה לקרוא (למשל,
./jdk-logger.properties
). התבנית מסופקת ב-google-ads/src/main/resources/googleads-logging/jdk-logger.properties
. מערכת ה-JUL קוראת רק ממערכת הקבצים, אז לא להעתיק לספריית המשאבים.מריצים את האפליקציה כשמציינים את
-Djava.util.logging.config.file=./jdk-logger.properties
.