הרישום ביומן מוגדר באמצעות 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 טוען את קובץ התצורה שלו מה-classpath ולא מספריית העבודה, ולכן חשוב ליצור בספריית משאבים.מריצים את האפליקציה, מציינים
-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
. יולי קורא רק ממערכת הקבצים, אז לא להעתיק אותו לספריית המשאבים.מריצים את האפליקציה בפורמט
-Djava.util.logging.config.file=./jdk-logger.properties
.