הגדרת רישום ביומן

הרישום ביומן בספריית הלקוח של Java מוגדר באמצעות SLF4J, חזית רישום ביומן כללית ל-Java שמאפשרת להפנות יומנים להטמעות שונות של רישום ביומן, כמו Log4j 2,‏ Logback או java.util.logging (JUL). אנחנו מספקים קובצי הגדרה לדוגמה עבור Log4j 2 ו-JUL.

הפריסה והפונקציונליות של היומן

הבקשות מתועדות ביומן עם סיכום בשורה אחת, ועם גוף הבקשה והתשובה וכותרות הבקשה והתשובה.

סוג יומן הביקורת	שם יומן הביקורת	רמת ההצלחה	רמת הכשל
סיכום	com.google.ads.googleads.lib.request.summary	מידע	WARN
פרטים	com.google.ads.googleads.lib.request.detail	ניפוי באגים	מידע

קטיעת יומן מפורט

כברירת מחדל, היומנים המפורטים נחתכים כדי למנוע יצירה של יומנים גדולים. כדי לשנות את האורך שבו היומנים נחתכים, מגדירים את מאפיין ה-JVM‏ -Dapi.googleads.maxLogMessageLength=<number>. ההגדרה -1 משביתה את חיתוך היומנים.

Log4j 2

1. מוסיפים תלות בספריית log4j-slf4j2-impl, ומחליפים את 2.x.y בגרסה של Log4j 2 שבה אתם משתמשים בפרויקט:

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

2. (אופציונלי) יוצרים קובץ הגדרות log4j2.xml בספריית המשאבים (לדוגמה, src/main/resources ב-Maven). ‫Log4j 2 טוען את קובץ ההגדרות שלו מנתיב המחלקה, ולא מספריית העבודה, לכן חשוב לוודא שיוצרים אותו בספריית משאבים.

3. מריצים את האפליקציה ומציינים את -Dlog4j.configurationFile=<CONFIG_FILE_PATH>. אפשר לציין CONFIG_FILE_PATH=googleads-logging/log4j2.xml כדי להשתמש בקובץ ברירת המחדל של ההגדרות שכלול בספריית הלקוח.

‫Log4j 1.2 (מהדור הקודם)

1. מוסיפים תלות בספריית slf4j-log4j12, ומחליפים את 1.x.y בגרסה של 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 טוען את קובץ ההגדרות שלו מנתיב המחלקה, ולא מספריית העבודה, לכן צריך להעתיק אותו לספריית משאבים.

3. מריצים את האפליקציה ומציינים את -Dlog4j.configuration=<CONFIG_FILE_PATH>. אפשר לציין CONFIG_FILE_PATH=googleads-logging/log4j.properties כדי להשתמש בקובץ ההגדרות שמוגדר כברירת מחדל ומצורף לספריית הלקוח.

Java Util Logging

1. מוסיפים תלות בספריית slf4j-jdk14, ומחליפים את 2.x.y בגרסת 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 קורא רק ממערכת הקבצים, לכן אל תעתיקו אותו רק לספריית המשאבים של נתיב המחלקה.

3. מריצים את האפליקציה ומציינים את -Djava.util.logging.config.file=./jdk-logger.properties.