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

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

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

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

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

נקודה חשובה: בקשות לשינוי נתונים שבהן הכישלון החלקי הוא true לא גורמות לכישלון של כל הבקשה. לכן, יומנים של כשלים חלקיים תמיד נרשמים ברמת Success, ולא ברמת Failure.

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

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

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.