लॉगिंग को SLF4J के साथ कॉन्फ़िगर किया गया है, जो Java के लिए एक सामान्य लॉगिंग लाइब्रेरी है. इसकी मदद से, लॉग को कई अलग-अलग लॉगिंग लागू करने के लिए निर्देशित किया जा सकता है. हम log4j 1.2/2 और Java Util Logging (JUL) के लिए कॉन्फ़िगरेशन फ़ाइलें उपलब्ध कराते हैं.
लॉगिंग लेआउट और फ़ंक्शन
अनुरोधों को एक लाइन की खास जानकारी और अनुरोध/जवाब के पूरे मुख्य हिस्से और हेडर के साथ लॉग किया जाता है.
लॉग टाइप | लॉग का नाम | सफलता का लेवल | गड़बड़ी का लेवल |
---|---|---|---|
खास जानकारी | com.google.ads.googleads.lib.request.summary | जानकारी | WARN |
ब्यौरा | com.google.ads.googleads.lib.request.detail | डीबग करें | जानकारी |
ज़्यादा जानकारी वाले लॉग को छोटा करना
ज़्यादा जानकारी वाले लॉग, डिफ़ॉल्ट रूप से काट दिए जाते हैं, ताकि बड़े लॉग न बनें. लॉग को ट्रिम करने की अवधि बदलने के लिए, -Dapi.googleads.maxLogMessageLength=<number>
सेट करें. -1
सेट करने पर, लॉग को छोटा करने की सुविधा बंद हो जाती है.
Log4j 2
log4j-slf4j-impl
लाइब्रेरी पर डिपेंडेंसी जोड़ें. इसके लिए,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>
(ज़रूरी नहीं) अपनी संसाधन डायरेक्ट्री में कॉन्फ़िगरेशन फ़ाइल बनाएं. उदाहरण के लिए, Maven में:
src/main/resources
. Log4j 2 अपनी कॉन्फ़िगरेशन फ़ाइल को क्लासपाथ से लोड करता है, न कि वर्किंग डायरेक्ट्री से. इसलिए, पक्का करें कि आपने इसे संसाधन डायरेक्ट्री में बनाया हो.-Dlog4j.configurationFile=<CONFIG_FILE_PATH>
की जानकारी देकर, अपना ऐप्लिकेशन चलाएं. क्लाइंट लाइब्रेरी में शामिल डिफ़ॉल्ट कॉन्फ़िगरेशन फ़ाइल का इस्तेमाल करने के लिए,CONFIG_FILE_PATH=googleads-logging/log4j2.xml
का इस्तेमाल किया जा सकता है.
Log4j 1.2 (लेगसी)
slf4j-log4j12
लाइब्रेरी पर डिपेंडेंसी जोड़ें. इसके लिए,1.x.y
की जगह पर, अपने प्रोजेक्ट में इस्तेमाल किए जा रहे Log4j 1.2 के वर्शन का इस्तेमाल करें.<dependency> <groupId>org.slf4j</groupId> <artifactId>slf4j-log4j12</artifactId> <version>1.x.y</version> </dependency>
(ज़रूरी नहीं) अपने प्रोजेक्ट की संसाधन डायरेक्ट्री में कॉन्फ़िगरेशन फ़ाइल बनाएं. उदाहरण के लिए, Maven में पाथ
src/main/resources
है. Log4j 1.2 अपनी कॉन्फ़िगरेशन फ़ाइल को, वर्किंग डायरेक्ट्री से नहीं, बल्कि क्लासपाथ से लोड करता है. इसलिए, पक्का करें कि आपने कॉन्फ़िगरेशन फ़ाइल को रिसॉर्स डायरेक्ट्री में कॉपी किया हो.-Dlog4j.configuration=<CONFIG_FILE_PATH>
की जानकारी देकर, अपना ऐप्लिकेशन चलाएं. क्लाइंट लाइब्रेरी में शामिल डिफ़ॉल्ट कॉन्फ़िगरेशन फ़ाइल का इस्तेमाल करने के लिए,CONFIG_FILE_PATH=googleads-logging/log4j.properties
का इस्तेमाल किया जा सकता है.
Java Util Logging
slf4j-jdk14
लाइब्रेरी पर डिपेंडेंसी जोड़ें.<dependency> <groupId>org.slf4j</groupId> <artifactId>slf4j-jdk14</artifactId> <version>1.7.25</version> </dependency>
फ़ाइल सिस्टम पर, अपने ऐप्लिकेशन से पढ़े जा सकने वाले पाथ (उदाहरण के लिए,
./jdk-logger.properties
) में JUL कॉन्फ़िगरेशन फ़ाइल बनाएं.google-ads/src/main/resources/googleads-logging/jdk-logger.properties
पर एक टेंप्लेट दिया गया है. JUL सिर्फ़ फ़ाइल सिस्टम से पढ़ता है, इसलिए इसे संसाधन डायरेक्ट्री में कॉपी न करें.-Djava.util.logging.config.file=./jdk-logger.properties
की जानकारी देकर, अपना ऐप्लिकेशन चलाएं.