רישום

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

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

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