Google Stackdriver লগিং এক্সটেনশন

আপনি Apigee Edge-এর ডকুমেন্টেশন দেখছেন।
Apigee X ডকুমেন্টেশন .info- তে যান।

সংস্করণ ১.৩.৭

স্ট্যাকড্রাইভার লগিং লগগুলিতে এন্ট্রি লিখুন।

এই বিষয়বস্তুতে এই এক্সটেনশনটি কনফিগার ও ব্যবহার করার জন্য নির্দেশিকা দেওয়া হয়েছে।

পূর্বশর্ত

একটি এপিআই প্রক্সি থেকে এই এক্সটেনশনটি ব্যবহার করার আগে, আপনাকে অবশ্যই:

1. IAM-এ, সেই প্রোজেক্ট সদস্যকে Logging > Logs Writer এবং Logging > Logs Viewer রোলটি অ্যাসাইন করুন, যিনি Stackdriver Logging সিস্টেমে আপনার এক্সটেনশনটির প্রতিনিধিত্ব করবেন। কীভাবে রোল প্রদান করতে হয়, তার নির্দেশাবলীর জন্য, নির্দিষ্ট রিসোর্সের জন্য একটি সার্ভিস অ্যাকাউন্টে রোল প্রদান দেখুন। লগিং রোল সম্পর্কে আরও জানতে, অ্যাক্সেস কন্ট্রোল গাইড দেখুন।

2. সার্ভিস অ্যাকাউন্টের জন্য একটি কী তৈরি করতে GCP কনসোল ব্যবহার করুন ।

3. কনফিগারেশন রেফারেন্স ব্যবহার করে এক্সটেনশনটি যোগ ও কনফিগার করার সময়, প্রাপ্ত কী 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 তে সেট করুন।

স্ট্যাকড্রাইভার লগিং সম্পর্কে

স্ট্যাকড্রাইভার লগিং হলো গুগল ক্লাউড প্ল্যাটফর্ম (GCP)-এর স্ট্যাকড্রাইভার প্রোডাক্ট স্যুটের একটি অংশ। এতে লগ সংরক্ষণের ব্যবস্থা, লগস ভিউয়ার নামক একটি ইউজার ইন্টারফেস এবং প্রোগ্রাম্যাটিকভাবে লগ পরিচালনা করার জন্য একটি এপিআই (API) অন্তর্ভুক্ত রয়েছে। স্ট্যাকড্রাইভার লগিং-এর মাধ্যমে আপনি লগ এন্ট্রি পড়তে ও লিখতে, আপনার লগ অনুসন্ধান ও ফিল্টার করতে, লগ এক্সপোর্ট করতে এবং লগ-ভিত্তিক মেট্রিক তৈরি করতে পারেন।

এই এক্সটেনশনটি বর্তমানে লগে এন্ট্রি লেখে। আরও তথ্যের জন্য, স্ট্যাকড্রাইভার লগিং ডক্স দেখুন।

নমুনা

নিম্নলিখিত উদাহরণগুলিতে ExtensionCallout পলিসি ব্যবহার করে কীভাবে Stackdriver Logging এক্সটেনশন অ্যাকশনগুলির জন্য সমর্থন কনফিগার করতে হয় তা দেখানো হয়েছে।

গ্লোবাল লগ

নিম্নলিখিত পলিসিটি স্ট্যাকড্রাইভার গ্লোবাল রিসোর্সের 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>stackdriver-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" : "stackdriver-log-name-to-use",
  "metadata" : JSON-structured-metadata,
  "message" : "data-to-log-as-entry"
}]]></Input>

<Action>log</Action>
<Input><![CDATA[{
  "logName" : "stackdriver-log-name-to-use",
  "metadata" : { "resource" : { "type" : "global" } },
  "message" : "data-to-log-as-entry"
}]]></Input>

অনুরোধের পরামিতি

প্রতিক্রিয়া

যদি বার্তাটি লগে লেখা হয়ে থাকে, তবে কোনো মান দেওয়া হবে না। অন্যথায়, অনুরোধটি একটি ত্রুটি ফেরত দেবে। আরও দেখুন একটি এক্সটেনশন ডিবাগ করা ।

কনফিগারেশন রেফারেন্স

এপিআই প্রক্সিতে ব্যবহারের জন্য এই এক্সটেনশনটি কনফিগার ও ডেপ্লয় করার সময় নিম্নলিখিত বিষয়গুলো ব্যবহার করুন।

সাধারণ সম্প্রসারণ বৈশিষ্ট্য

নিম্নলিখিত বৈশিষ্ট্যগুলি প্রতিটি এক্সটেনশনের জন্য উপস্থিত রয়েছে।

এই এক্সটেনশন প্যাকেজের জন্য বৈশিষ্ট্যসমূহ

এই এক্সটেনশনের জন্য নির্দিষ্ট নিম্নলিখিত কনফিগারেশন প্রোপার্টিগুলোর মান উল্লেখ করুন।