लॉगिंग कॉन्फ़िगर करें

Java क्लाइंट लाइब्रेरी में लॉग इन करने की सुविधा, SLF4J के साथ कॉन्फ़िगर की जाती है. यह Java के लिए एक सामान्य लॉगिंग फ़साड है. इससे लॉग को कई अलग-अलग लॉगिंग सिस्टम में भेजा जा सकता है. जैसे, Log4j 2, Logback या java.util.logging (JUL). हम Log4j 2 और JUL के लिए, कॉन्फ़िगरेशन फ़ाइलों के सैंपल उपलब्ध कराते हैं.

लॉग का लेआउट और फ़ंक्शन

अनुरोधों को एक लाइन की खास जानकारी के साथ लॉग किया जाता है. साथ ही, अनुरोध और जवाब के पूरे मुख्य हिस्से और हेडर को भी लॉग किया जाता है.

लॉग टाइप लॉग का नाम सफलता का लेवल गड़बड़ी का लेवल
खास जानकारी com.google.ads.googleads.lib.request.summary जानकारी WARN
ब्यौरा com.google.ads.googleads.lib.request.detail डीबग करें जानकारी

लॉग की जानकारी में काट-छांट करना

ज़्यादा जानकारी वाले लॉग को डिफ़ॉल्ट रूप से छोटा कर दिया जाता है, ताकि बड़े लॉग न बन पाएं. लॉग के छोटे किए जाने की लंबाई बदलने के लिए, JVM प्रॉपर्टी -Dapi.googleads.maxLogMessageLength=<number> सेट करें. -1 सेटिंग को चालू करने पर, लॉग ट्रंकेट करने की सुविधा बंद हो जाती है.

Log4j 2

  1. log4j-slf4j2-impl लाइब्रेरी की डिपेंडेंसी जोड़ें. साथ ही, 2.x.y को Log4j 2 के उस वर्शन से बदलें जिसका इस्तेमाल आपके प्रोजेक्ट में किया जा रहा है:

    <dependency>
  <groupId>org.apache.logging.log4j</groupId>
  <artifactId>log4j-slf4j2-impl</artifactId>
  <version>2.x.y</version>
</dependency>

  2. (ज़रूरी नहीं) अपने संसाधन डायरेक्ट्री में log4j2.xml कॉन्फ़िगरेशन फ़ाइल बनाएं. उदाहरण के लिए, Maven में src/main/resources. Log4j 2, अपनी कॉन्फ़िगरेशन फ़ाइल को क्लासपाथ से लोड करता है, न कि वर्किंग डायरेक्ट्री से. इसलिए, पक्का करें कि आपने इसे resources डायरेक्ट्री में बनाया हो.

  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. (ज़रूरी नहीं) अपने प्रोजेक्ट की resources डायरेक्ट्री में एक कॉन्फ़िगरेशन फ़ाइल बनाएं. उदाहरण के लिए, Maven में src/main/resources. Log4j 1.2, अपनी कॉन्फ़िगरेशन फ़ाइल को क्लासपाथ से लोड करता है, न कि वर्किंग डायरेक्ट्री से. इसलिए, पक्का करें कि आपने इसे resources डायरेक्ट्री में कॉपी किया हो.

  3. -Dlog4j.configuration=<CONFIG_FILE_PATH> को तय करके, अपना ऐप्लिकेशन चलाएं. क्लाइंट लाइब्रेरी के साथ शामिल डिफ़ॉल्ट कॉन्फ़िगरेशन फ़ाइल का इस्तेमाल करने के लिए, CONFIG_FILE_PATH=googleads-logging/log4j.properties को सेट किया जा सकता है.

Java Util Logging

  1. slf4j-jdk14 लाइब्रेरी पर डिपेंडेंसी जोड़ें. साथ ही, 2.x.y को अपने प्रोजेक्ट में इस्तेमाल किए गए SLF4J वर्शन से बदलें:

    <dependency>
  <groupId>org.slf4j</groupId>
  <artifactId>slf4j-jdk14</artifactId>
  <version>2.x.y</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 के साथ अपना ऐप्लिकेशन चलाएं.