רישום

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

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

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

סוג יומן הביקורת	שם יומן הביקורת	רמת הצלחה	רמת כישלון
סיכום	com.google.ads.googleads.lib.request.summary	מידע	אזהרה
פרטים	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

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

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