רישום

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

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

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.