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

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

वर्शन 1.6.1

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

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

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

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

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

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

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

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

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

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

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

Cloud Logging, Google Cloud के कार्रवाइयों वाले सुइट का हिस्सा है. इसमें लॉग सेव करने की सुविधा, लॉग एक्सप्लोरर नाम का यूज़र इंटरफ़ेस (यूआई), और प्रोग्राम की मदद से लॉग मैनेज करने के लिए एक एपीआई शामिल है. 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 होगा. वरना, अनुरोध में गड़बड़ी दिखेगी. एक्सटेंशन को डीबग करना लेख भी देखें.

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

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

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

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

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

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