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

लॉग इन करने की प्रोसेस को 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 लाइब्रेरी पर डिपेंडेंसी जोड़ें. साथ ही, अपने प्रोजेक्ट में इस्तेमाल किए जा रहे Log4j 2 के वर्शन 2.x.y को बदलें.

   <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, काम करने वाली डायरेक्ट्री के बजाय, क्लासपाथ से अपनी कॉन्फ़िगरेशन फ़ाइल लोड करता है. इसलिए, पक्का करें कि रिसोर्स डायरेक्ट्री में ही कॉपी हो.

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 के बारे में जानकारी देते हुए अपना ऐप्लिकेशन चलाएं.