আপনি Apigee Edge ডকুমেন্টেশন দেখছেন।
Apigee X ডকুমেন্টেশনে যান । তথ্য
সংস্করণ 2.0.2
ক্লাউড লগিং লগে এন্ট্রি লিখুন।
এই বিষয়বস্তুটি এই এক্সটেনশনটি কনফিগার এবং ব্যবহারের জন্য রেফারেন্স প্রদান করে।
পূর্বশর্ত
API প্রক্সি থেকে এই এক্সটেনশনটি ব্যবহার করার আগে, আপনাকে অবশ্যই:
IAM-তে, ক্লাউড লগিং সিস্টেমে আপনার এক্সটেনশনের প্রতিনিধিত্বকারী প্রকল্প সদস্যকে লগিং > লগ রাইটার ভূমিকাটি অর্পণ করুন। ভূমিকা কীভাবে প্রদান করবেন সে সম্পর্কে নির্দেশাবলীর জন্য, নির্দিষ্ট সংস্থানগুলির জন্য একটি পরিষেবা অ্যাকাউন্টে ভূমিকা প্রদান দেখুন। লগিং ভূমিকা সম্পর্কে আরও জানতে, অ্যাক্সেস নিয়ন্ত্রণ নির্দেশিকা দেখুন।
পরিষেবা অ্যাকাউন্টের জন্য একটি কী তৈরি করতে Google ক্লাউড কনসোল ব্যবহার করুন ।
কনফিগারেশন রেফারেন্স ব্যবহার করে এক্সটেনশন যোগ এবং কনফিগার করার সময় ফলাফল কী JSON ফাইলের বিষয়বস্তু ব্যবহার করুন।
এই এক্সটেনশনটি PostClientFlow এ অবস্থিত একটি ExtensionCallout নীতি দ্বারা কল করা সমর্থন করে। যদি আপনি PostClientFlow থেকে এই এক্সটেনশনটি কল করার জন্য ExtensionCallout নীতি ব্যবহার করতে চান, তাহলে নিশ্চিত করুন যে features.allowExtensionsInPostClientFlow ফ্ল্যাগটি আপনার প্রতিষ্ঠানে true তে সেট করা আছে।
আপনি যদি Apigee Edge for Public Cloud এর গ্রাহক হন, তাহলে আপনার প্রতিষ্ঠানে
features.allowExtensionsInPostClientFlowফ্ল্যাগটিtrueতে সেট করা আছে কিনা তা নিশ্চিত করতে আপনাকে Apigee Edge সাপোর্টের সাথে যোগাযোগ করতে হবে।আপনি যদি Apigee Edge for Private Cloud গ্রাহক হন, তাহলে
features.allowExtensionsInPostClientFlowফ্ল্যাগটিকেtrueএ সেট করতে Update organization properties API ব্যবহার করুন।
ক্লাউড লগিং সম্পর্কে
ক্লাউড লগিং হল গুগল ক্লাউডের অপারেশন স্যুটের অংশ। এতে লগের জন্য স্টোরেজ, লগ এক্সপ্লোরার নামে একটি ইউজার ইন্টারফেস এবং প্রোগ্রাম্যাটিকভাবে লগ পরিচালনা করার জন্য একটি API রয়েছে। ক্লাউড লগিংয়ের মাধ্যমে, আপনি লগ এন্ট্রি পড়তে এবং লিখতে, আপনার লগগুলি অনুসন্ধান এবং ফিল্টার করতে, আপনার লগগুলি রপ্তানি করতে এবং লগ-ভিত্তিক মেট্রিক্স তৈরি করতে পারেন।
ক্লাউড লগিং এক্সটেনশন লগে এন্ট্রি লেখে। আরও জানতে, ক্লাউড লগিং ডক্স দেখুন।
নমুনা
নিম্নলিখিত উদাহরণগুলি ExtensionCallout নীতি ব্যবহার করে ক্লাউড লগিং এক্সটেনশন অ্যাকশনের জন্য সমর্থন কীভাবে কনফিগার করতে হয় তা ব্যাখ্যা করে।
গ্লোবাল লগ
নিম্নলিখিত নীতিটি " This is a test ক্লাউড গ্লোবাল রিসোর্সে example-log নামক একটি লগের একটি পরীক্ষা" বার্তাটি লিখে। প্রকৃত ব্যবহারে, আপনি সম্ভবত বার্তাটি একটি ফ্লো ভেরিয়েবলের মধ্যে রাখতে চাইবেন যার মান আপনি API প্রক্সিতে অন্য কোথাও সেট করেছেন।
<?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 কনসোল ব্যবহার করে একটি এক্সটেনশন কনফিগার করার ধাপগুলির জন্য, একটি এক্সটেনশন যোগ করা এবং কনফিগার করা দেখুন।
কর্ম
লগ
লগে একটি বার্তা লেখে।
এই অ্যাকশনটি একটি ক্লাউড লগিং লগ এন্ট্রি লিখে। লগ এন্ট্রিগুলিতে মেটাডেটা এবং এন্ট্রি ডেটা থাকে। লগ এন্ট্রি সম্পর্কে আরও জানতে, এন্ট্রি রেফারেন্স দেখুন। 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>
উদাহরণ: 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 । অন্যথায়, অনুরোধটি একটি ত্রুটি ফেরত দেবে। এক্সটেনশন ডিবাগিং আরও দেখুন।
কনফিগারেশন রেফারেন্স
API প্রক্সিতে ব্যবহারের জন্য এই এক্সটেনশনটি কনফিগার এবং স্থাপন করার সময় নিম্নলিখিতগুলি ব্যবহার করুন।
সাধারণ এক্সটেনশন বৈশিষ্ট্য
নিম্নলিখিত বৈশিষ্ট্যগুলি প্রতিটি এক্সটেনশনের জন্য উপস্থিত রয়েছে।
| সম্পত্তি | বর্ণনা | ডিফল্ট | প্রয়োজন |
|---|---|---|---|
name | আপনি এক্সটেনশনের এই কনফিগারেশনের নাম দিন। | কোনোটিই নয় | হ্যাঁ |
packageName | Apigee Edge দ্বারা প্রদত্ত এক্সটেনশন প্যাকেজের নাম। | কোনোটিই নয় | হ্যাঁ |
version | যে এক্সটেনশন প্যাকেজ থেকে আপনি একটি এক্সটেনশন কনফিগার করছেন তার সংস্করণ নম্বর। | কোনোটিই নয় | হ্যাঁ |
configuration | আপনি যে এক্সটেনশনটি যোগ করছেন তার জন্য নির্দিষ্ট কনফিগারেশন মান। এই এক্সটেনশন প্যাকেজের বৈশিষ্ট্য দেখুন | কোনোটিই নয় | হ্যাঁ |
এই এক্সটেনশন প্যাকেজের বৈশিষ্ট্যাবলী
এই এক্সটেনশনের জন্য নির্দিষ্ট নিম্নলিখিত কনফিগারেশন বৈশিষ্ট্যের জন্য মান নির্দিষ্ট করুন।
| সম্পত্তি | বিবরণ | ডিফল্ট | প্রয়োজনীয় |
|---|---|---|---|
projectId | গুগল ক্লাউড প্রোজেক্ট আইডি যেখানে লগ তৈরি করা উচিত। | কোনটিই নয় | হাঁ |
credentials | Apigee Edge কনসোলে প্রবেশ করালে, এটি আপনার পরিষেবা অ্যাকাউন্ট কী ফাইলের বিষয়বস্তু। ম্যানেজমেন্ট API ব্যবহার করে পাঠানো হলে, এটি পরিষেবা অ্যাকাউন্ট কী ফাইল থেকে তৈরি একটি base64-এনকোডেড মান। | কোনটিই নয় | হাঁ |