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

आपको Apigee Edge दस्तावेज़ दिख रहा है.
अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया है इस पेज पर जाएं Apigee X दस्तावेज़. जानकारी

वर्शन 1.6.0

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

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

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

किसी API प्रॉक्सी से इस एक्सटेंशन का उपयोग करने से पहले, आपको यह करना होगा:

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

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

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

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

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

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

क्लाउड लॉगिंग के बारे में

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

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

सैंपल

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

ग्लोबल लॉग

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

<?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

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

यह कार्रवाई, क्लाउड लॉगिंग लॉग एंट्री लिखती है. लॉग एंट्री में मेटाडेटा होता है शामिल है. लॉग एंट्री के बारे में ज़्यादा जानने के लिए, देखें एंट्री रेफ़रंस. metadata प्रॉपर्टी के कॉन्टेंट के बारे में जानने के लिए, यहां देखें 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 अगर मैसेज लॉग पर लिखा गया था. ऐसा न होने पर, अनुरोध में गड़बड़ी दिखेगी. एक्सटेंशन को डीबग करना भी देखें.

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

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

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

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

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

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