רישום

הרישום ביומן מוגדר באמצעות SLF4J, ספריית רישום ביומן גנרית ל-Java שמאפשרת להפנות יומנים להטמעות רבות של רישום ביומן. אנחנו מספקים קובצי תצורה ל-log4j 1.2/2 ול-Java Util Logging‏ (JUL).

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

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

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

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

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

Log4j 2

1. מוסיפים תלות בספרייה 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>
   

2. (אופציונלי) יוצרים קובץ תצורה בתיקיית המשאבים, למשל ב-Maven: src/main/resources. 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. (אופציונלי) יוצרים קובץ תצורה בספריית המשאבים של הפרויקט. לדוגמה, ב-Maven הנתיב הוא src/main/resources. Log4j 1.2 טוען את קובץ התצורה שלו מ-classpath, ולא מספריית העבודה, לכן חשוב להעתיק אותו לספריית משאבים.

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

Java Util Logging

1. מוסיפים תלות בספרייה slf4j-jdk14.

   <dependency>
     <groupId>org.slf4j</groupId>
     <artifactId>slf4j-jdk14</artifactId>
     <version>1.7.25</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.