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

আপনি Apigee Edge ডকুমেন্টেশন দেখছেন।
Apigee X ডকুমেন্টেশনে যান
তথ্য

সংস্করণ 1.3.7

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

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

পূর্বশর্ত

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

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

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

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

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

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

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

নমুনা

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

গ্লোবাল লগ

নিম্নলিখিত নীতিটি স্ট্যাকড্রাইভার গ্লোবাল রিসোর্সে example-log নামক একটি লগে "This is a test" বার্তাটি লেখে। প্রকৃত ব্যবহারে, আপনি সম্ভবত বার্তাটি একটি ফ্লো ভেরিয়েবলের মধ্যে রাখতে চাইবেন যার মান আপনি 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>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>

অনুরোধের প্যারামিটার

প্যারামিটার বিবরণ আদর্শ ডিফল্ট প্রয়োজনীয়
লগনাম এই এন্ট্রিটি যে লগের সাথে সম্পর্কিত তার নাম। স্ট্রিং কোনোটিই নয়। হ্যাঁ।
মেটাডেটা লগ এন্ট্রি সম্পর্কে মেটাডেটা।
metadata type এবং labels সেট করার বিষয়ে আরও তথ্য এবং বিকল্পগুলির জন্য MonitoredResource দেখুন।
JSON সম্পর্কে কোনোটিই নয়। না।
বার্তা এই লগ এন্ট্রির মান হিসেবে ব্যবহার করার জন্য ডেটা। স্ট্রিং কোনোটিই নয়। হ্যাঁ।

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

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

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

API প্রক্সিতে ব্যবহারের জন্য এই এক্সটেনশনটি কনফিগার এবং স্থাপন করার সময় নিম্নলিখিতগুলি ব্যবহার করুন।

সাধারণ এক্সটেনশন বৈশিষ্ট্য

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

সম্পত্তি বর্ণনা ডিফল্ট প্রয়োজন
name আপনি এক্সটেনশনের এই কনফিগারেশনের নাম দিন। কোনোটিই নয় হ্যাঁ
packageName Apigee Edge দ্বারা প্রদত্ত এক্সটেনশন প্যাকেজের নাম। কোনোটিই নয় হ্যাঁ
version যে এক্সটেনশন প্যাকেজ থেকে আপনি একটি এক্সটেনশন কনফিগার করছেন তার সংস্করণ নম্বর। কোনোটিই নয় হ্যাঁ
configuration আপনি যে এক্সটেনশনটি যোগ করছেন তার জন্য নির্দিষ্ট কনফিগারেশন মান। এই এক্সটেনশন প্যাকেজের বৈশিষ্ট্য দেখুন কোনোটিই নয় হ্যাঁ

এই এক্সটেনশন প্যাকেজের বৈশিষ্ট্যাবলী

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

সম্পত্তি বিবরণ ডিফল্ট প্রয়োজনীয়
প্রজেক্ট আইডি GCP প্রকল্প আইডি যেখানে লগ তৈরি করা উচিত। কোনোটিই নয়। হ্যাঁ।
শংসাপত্র Apigee Edge কনসোলে প্রবেশ করালে, এটি আপনার পরিষেবা অ্যাকাউন্ট কী ফাইলের বিষয়বস্তু। যখন ম্যানেজমেন্ট API এর মাধ্যমে পাঠানো হয়, তখন এটি পরিষেবা অ্যাকাউন্ট কী ফাইল থেকে তৈরি একটি base64-এনকোডেড মান। কোনোটিই নয়। হ্যাঁ।