लॉगिंग को 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लाइब्रेरी पर डिपेंडेंसी जोड़ें. इसके लिए,2.x.yकी जगह अपने प्रोजेक्ट में इस्तेमाल किए जा रहे Log4j 2 के वर्शन का इस्तेमाल करें.<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>फ़ाइल सिस्टम पर, अपने ऐप्लिकेशन से पढ़े जा सकने वाले पाथ में JUL कॉन्फ़िगरेशन फ़ाइल बनाएं. उदाहरण के लिए,
./jdk-logger.properties.google-ads/src/main/resources/googleads-logging/jdk-logger.propertiesपर एक टेंप्लेट दिया गया है. JUL सिर्फ़ फ़ाइल सिस्टम से पढ़ता है. इसलिए, इसे संसाधन डायरेक्ट्री में कॉपी न करें.-Djava.util.logging.config.file=./jdk-logger.propertiesकी जानकारी देकर, अपना ऐप्लिकेशन चलाएं.