আপনি Apigee Edge-এর ডকুমেন্টেশন দেখছেন।
Apigee X ডকুমেন্টেশন .info- তে যান।
সংস্করণ ১.৬.১
ক্লাউড লগিং লগে এন্ট্রিগুলো লিখুন।
এই বিষয়বস্তুতে এই এক্সটেনশনটি কনফিগার ও ব্যবহার করার জন্য নির্দেশিকা দেওয়া হয়েছে।
পূর্বশর্ত
একটি এপিআই প্রক্সি থেকে এই এক্সটেনশনটি ব্যবহার করার আগে, আপনাকে অবশ্যই:
In IAM, assign the Logging > Logs Writer role to the project member that will represent your extension to the Cloud Logging system. For instructions on how to grant roles, see Granting roles to a service account for specific resources . For more on logging roles, see Access Control Guide .
সার্ভিস অ্যাকাউন্টের জন্য একটি কী তৈরি করতে গুগল ক্লাউড কনসোল ব্যবহার করুন ।
কনফিগারেশন রেফারেন্স ব্যবহার করে এক্সটেনশনটি যোগ ও কনফিগার করার সময়, প্রাপ্ত কী JSON ফাইলের বিষয়বস্তু ব্যবহার করুন।
এই এক্সটেনশনটি PostClientFlow- তে অবস্থিত একটি ExtensionCallout পলিসি দ্বারা কল হওয়া সমর্থন করে। আপনি যদি একটি PostClientFlow থেকে এই এক্সটেনশনটি কল করার জন্য ExtensionCallout পলিসি ব্যবহার করতে চান, তাহলে নিশ্চিত করুন যে আপনার প্রতিষ্ঠানে features.allowExtensionsInPostClientFlow ফ্ল্যাগটি true তে সেট করা আছে।
আপনি যদি Apigee Edge for Public Cloud-এর গ্রাহক হন, তাহলে আপনার প্রতিষ্ঠানে
features.allowExtensionsInPostClientFlowফ্ল্যাগটিtrueতে সেট করা আছে কিনা তা নিশ্চিত করতে আপনাকে অবশ্যই Apigee Edge Support-এর সাথে যোগাযোগ করতে হবে।আপনি যদি Apigee Edge for Private Cloud-এর গ্রাহক হন, তাহলে Update organization properties API ব্যবহার করে
features.allowExtensionsInPostClientFlowফ্ল্যাগটিকেtrueতে সেট করুন।
ক্লাউড লগিং সম্পর্কে
Cloud Logging is part of the Google Cloud's operations suite. It includes storage for logs, a user interface called the Logs explorer, and an API to manage logs programmatically. With Cloud Logging, you can read and write log entries, search and filter your logs, export your logs, and create logs-based metrics.
ক্লাউড লগিং এক্সটেনশনটি বর্তমানে লগে এন্ট্রি লেখে। আরও তথ্যের জন্য, ক্লাউড লগিং ডক্স দেখুন।
নমুনা
নিম্নলিখিত উদাহরণগুলিতে ExtensionCallout পলিসি ব্যবহার করে ক্লাউড লগিং এক্সটেনশন অ্যাকশনের জন্য সাপোর্ট কীভাবে কনফিগার করতে হয় তা দেখানো হয়েছে।
গ্লোবাল লগ
The following policy writes the message This is a test to a log called example-log in the Cloud Global resource. In actual use, you'd probably have the message be contained in a flow variable whose value you set elsewhere in the API proxy.
<?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 কনসোল ব্যবহার করে একটি এক্সটেনশন কনফিগার করার ধাপগুলোর জন্য, “একটি এক্সটেনশন যোগ এবং কনফিগার করা” দেখুন।
কর্ম
লগ
লগে একটি বার্তা লেখে।
This action writes a Cloud Logging log entry. Log entries consist of metadata and the entry data. For more about log entries, see the Entry reference . For information about the contents of the metadata property, see the LogEntry object in the Cloud Logging documentation.
সিনট্যাক্স
<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>
উদাহরণ: JSON
<Action>log</Action>
<Input><![CDATA[{
"logName" : "example-log",
"metadata" : { "resource" : { "type" : "global" } },
"message" : { "info" : "This is a test." }
}]]></Input>
অনুরোধের পরামিতি
| প্যারামিটার | বর্ণনা | প্রকার | ডিফল্ট | প্রয়োজনীয় |
|---|---|---|---|---|
logName | যে লগটির এই এন্ট্রিটি অন্তর্গত, তার নাম। | স্ট্রিং | কোনোটিই না | হ্যাঁ |
metadata | লগ এন্ট্রি সম্পর্কিত মেটাডেটা।metadata type এবং labels সেট করার বিষয়ে আরও তথ্য ও বিকল্পের জন্য MonitoredResource দেখুন। | JSON | কোনোটিই না | না |
message | এই লগ এন্ট্রির মান হিসেবে ব্যবহার করার জন্য ডেটা। আপনি একটি সাধারণ স্ট্রিং নির্দিষ্ট করতে পারেন অথবা আরও সুসংগঠিত বার্তা লগ করার জন্য JSON ব্যবহার করতে পারেন। | স্ট্রিং বা JSON | কোনোটিই না | হ্যাঁ |
প্রতিক্রিয়া
যদি বার্তাটি লগে লেখা হয়ে থাকে, তবে কোনো মান দেওয়া হবে None । অন্যথায়, অনুরোধটি একটি ত্রুটি ফেরত দেবে। আরও দেখুন একটি এক্সটেনশন ডিবাগ করা ।
কনফিগারেশন রেফারেন্স
এপিআই প্রক্সিতে ব্যবহারের জন্য এই এক্সটেনশনটি কনফিগার ও ডেপ্লয় করার সময় নিম্নলিখিত বিষয়গুলো ব্যবহার করুন।
সাধারণ সম্প্রসারণ বৈশিষ্ট্য
নিম্নলিখিত বৈশিষ্ট্যগুলি প্রতিটি এক্সটেনশনের জন্য উপস্থিত রয়েছে।
| সম্পত্তি | বর্ণনা | ডিফল্ট | প্রয়োজন |
|---|---|---|---|
name | আপনি এক্সটেনশনের এই কনফিগারেশনের নাম দিন। | কোনোটিই নয় | হ্যাঁ |
packageName | Apigee Edge দ্বারা প্রদত্ত এক্সটেনশন প্যাকেজের নাম। | কোনোটিই নয় | হ্যাঁ |
version | যে এক্সটেনশন প্যাকেজ থেকে আপনি একটি এক্সটেনশন কনফিগার করছেন তার সংস্করণ নম্বর। | কোনোটিই নয় | হ্যাঁ |
configuration | আপনি যে এক্সটেনশনটি যোগ করছেন তার জন্য নির্দিষ্ট কনফিগারেশন মান। এই এক্সটেনশন প্যাকেজের বৈশিষ্ট্য দেখুন | কোনোটিই নয় | হ্যাঁ |
এই এক্সটেনশন প্যাকেজের জন্য বৈশিষ্ট্যসমূহ
এই এক্সটেনশনের জন্য নির্দিষ্ট নিম্নলিখিত কনফিগারেশন প্রোপার্টিগুলোর মান উল্লেখ করুন।
| সম্পত্তি | বর্ণনা | ডিফল্ট | প্রয়োজনীয় |
|---|---|---|---|
projectId | গুগল ক্লাউড প্রজেক্ট আইডি যেখানে লগ তৈরি করা হবে। | কোনোটিই না | হ্যাঁ |
credentials | Apigee Edge কনসোলে প্রবেশ করানো হলে, এটি আপনার সার্ভিস অ্যাকাউন্ট কী ফাইলের বিষয়বস্তু। ম্যানেজমেন্ট API-এর মাধ্যমে পাঠানো হলে, এটি সার্ভিস অ্যাকাউন্ট কী ফাইল থেকে তৈরি একটি base64-এনকোডেড মান। | কোনোটিই না | হ্যাঁ |