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

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

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

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

קיצור היומן המפורט

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

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 קורא רק ממערכת הקבצים, אז אל תעתיקו אותו רק לספריית המשאבים של classpath.

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