लॉग इन हो रहा है

लॉगिंग को 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 को सेट करने से, लॉग में काट-छांट करने की सुविधा बंद हो जाती है.

लॉग4जे 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 यूटिल लॉगिंग

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 तय करके अपना ऐप्लिकेशन चलाएं.