Google Cloud लॉगिंग एक्सटेंशन

यहां Apigee Edge का दस्तावेज़ देखा जा रहा है.
Go to the Apigee X documentation. info

वर्शन 2.0.0

Cloud Logging के लॉग में एंट्री लिखें.

इस कॉन्टेंट में, इस एक्सटेंशन को कॉन्फ़िगर करने और इसका इस्तेमाल करने के बारे में जानकारी दी गई है.

ज़रूरी शर्तें

एपीआई प्रॉक्सी से इस एक्सटेंशन का इस्तेमाल करने से पहले, आपको ये काम करने होंगे:

1. आईएएम में, प्रोजेक्ट के उस सदस्य को Logging > लॉग राइटर की भूमिका असाइन करें जो Cloud Logging सिस्टम के लिए आपके एक्सटेंशन का प्रतिनिधित्व करेगा. भूमिकाएं असाइन करने के निर्देशों के लिए, खास संसाधनों के लिए सेवा खाते को भूमिकाएं असाइन करना लेख पढ़ें. लॉगिंग की भूमिकाओं के बारे में ज़्यादा जानने के लिए, ऐक्सेस कंट्रोल गाइड देखें.

2. सेवा खाते के लिए कुंजी जनरेट करने के लिए, Google Cloud Console का इस्तेमाल करें.

3. कॉन्फ़िगरेशन रेफ़रंस का इस्तेमाल करके, एक्सटेंशन को जोड़ने और कॉन्फ़िगर करते समय, जनरेट की गई कुंजी वाली JSON फ़ाइल के कॉन्टेंट का इस्तेमाल करें.

इस एक्सटेंशन को ExtensionCallout नीति से कॉल किया जा सकता है जो PostClientFlow में मौजूद है. अगर आपको ExtensionCallout नीति का इस्तेमाल करके, इस एक्सटेंशन को PostClientFlow से कॉल करना है, तो पक्का करें कि आपके संगठन में features.allowExtensionsInPostClientFlow फ़्लैग की वैल्यू true पर सेट हो.

• अगर आप पब्लिक क्लाउड के लिए Apigee Edge के ग्राहक हैं, तो आपको Apigee Edge की सहायता टीम से संपर्क करना होगा, ताकि यह पक्का किया जा सके कि आपके संगठन में features.allowExtensionsInPostClientFlow फ़्लैग की वैल्यू true पर सेट हो.

• अगर आप प्राइवेट क्लाउड के लिए Apigee Edge के ग्राहक हैं, तो features.allowExtensionsInPostClientFlow फ़्लैग की वैल्यू true पर सेट करने के लिए, संगठन की प्रॉपर्टी अपडेट करें एपीआई का इस्तेमाल करें.

Cloud Logging के बारे में जानकारी

Cloud Logging, Google Cloud के कार्रवाइयों वाले सुइट का हिस्सा है. इसमें लॉग सेव करने की सुविधा, Logs explorer नाम का यूज़र इंटरफ़ेस (यूआई) और प्रोग्राम की मदद से लॉग मैनेज करने के लिए एक एपीआई शामिल है. Cloud Logging की मदद से, लॉग एंट्री पढ़ी और लिखी जा सकती हैं. साथ ही, अपने लॉग खोजे और फ़िल्टर किए जा सकते हैं, एक्सपोर्ट किए जा सकते हैं, और लॉग के आधार पर मेट्रिक बनाई जा सकती हैं.

Cloud Logging एक्सटेंशन, लॉग में एंट्री लिखता है. ज़्यादा जानकारी के लिए, देखें Cloud Logging के दस्तावेज़.

सैंपल

यहां दिए गए उदाहरणों में, ExtensionCallout नीति का इस्तेमाल करके, Cloud Logging एक्सटेंशन की कार्रवाइयों के लिए सहायता कॉन्फ़िगर करने का तरीका बताया गया है.

ग्लोबल लॉग

यहां दी गई नीति, Cloud Global संसाधन में example-log नाम के लॉग में This is a test मैसेज लिखती है. असल में, आपके पास मैसेज को फ़्लो वैरिएबल में शामिल करने का विकल्प होता है. इसकी वैल्यू, एपीआई प्रॉक्सी में कहीं और सेट की जाती है.

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ConnectorCallout async="false" continueOnError="true" enabled="true" name="Logging-Extension">
    <DisplayName>Logging Connector</DisplayName>
    <Connector>cloud-extension-sample</Connector>
    <Action>log</Action>
    <Input><![CDATA[{
        "logName": "example-log",
        "metadata": {
            "resource": {
                "type": "global",
                "labels": {
                    "project_id": "my-test"
                }
            }
        },
        "message": "This is a test."
    }]]></Input>
</ConnectorCallout>

इस कॉन्टेंट में, इस एक्सटेंशन को कॉन्फ़िगर करने और इसका इस्तेमाल करने के बारे में जानकारी दी गई है. Apigee कंसोल का इस्तेमाल करके, एक्सटेंशन को कॉन्फ़िगर करने के चरणों के लिए, एक्सटेंशन जोड़ना और कॉन्फ़िगर करना लेख पढ़ें.

कार्रवाइयां

log

लॉग में कोई मैसेज लिखता है.

इस कार्रवाई से, Cloud Logging की लॉग एंट्री लिखी जाती है. लॉग एंट्री में, मेटाडेटा और एंट्री डेटा शामिल होता है. लॉग एंट्री के बारे में ज़्यादा जानने के लिए, एंट्री रेफ़रंस देखें. metadata प्रॉपर्टी के कॉन्टेंट के बारे में जानने के लिए, Cloud Logging के दस्तावेज़ में LogEntry ऑब्जेक्ट देखें.

<Action>log</Action>
<Input><![CDATA[{
  "logName" : "cloud-log-name-to-use",
  "metadata" : JSON-structured-metadata,
  "message" : "data-to-log-as-entry"
}]]></Input>

<Action>log</Action>
<Input><![CDATA[{
  "logName" : "example-log",
  "metadata" : { "resource" : { "type" : "global" } },
  "message": "This is a test."
}]]></Input>

<Action>log</Action>
<Input><![CDATA[{
  "logName" : "example-log",
  "metadata" : { "resource" : { "type" : "global" } },
  "message" : { "info" :  "This is a test." }
}]]></Input>

अनुरोध के पैरामीटर

जवाब

अगर मैसेज लॉग में लिखा गया है, तो None. वरना, अनुरोध में गड़बड़ी दिखेगी. एक्सटेंशन को डीबग करना भी देखें.

कॉन्फ़िगरेशन रेफ़रंस

एपीआई प्रॉक्सी में इस एक्सटेंशन को कॉन्फ़िगर और डिप्लॉय करते समय, यहां दी गई जानकारी का इस्तेमाल करें.

एक्सटेंशन की सामान्य प्रॉपर्टी

हर प्रॉपर्टी के लिए नीचे दी गई प्रॉपर्टी मौजूद हैं.

इस एक्सटेंशन पैकेज की प्रॉपर्टी

इस एक्सटेंशन के लिए, यहां दी गई कॉन्फ़िगरेशन प्रॉपर्टी की वैल्यू तय करें.