গুগল ক্লাউড লগিং এক্সটেনশন

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

সংস্করণ 1.5.0

ক্লাউড লগিং লগগুলিতে এন্ট্রি লিখুন।

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

পূর্বশর্ত

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

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

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

  3. কনফিগারেশন রেফারেন্স ব্যবহার করে এক্সটেনশন যোগ এবং কনফিগার করার সময় ফলাফল কী JSON ফাইলের বিষয়বস্তু ব্যবহার করুন।

এই এক্সটেনশনটি PostClientFlow- এ অবস্থিত একটি ExtensionCallout নীতি দ্বারা কল করা সমর্থন করে। আপনি যদি একটি PostClientFlow থেকে এই এক্সটেনশনটিকে কল করার জন্য ExtensionCallout নীতি ব্যবহার করতে চান, তাহলে নিশ্চিত করুন যে আপনার প্রতিষ্ঠানে features.allowExtensionsInPostClientFlow পতাকাটি true হিসাবে সেট করা আছে৷

  • আপনি যদি পাবলিক ক্লাউড গ্রাহকের জন্য একজন Apigee Edge হন, তাহলে আপনার প্রতিষ্ঠানে features.allowExtensionsInPostClientFlow পতাকা true হিসাবে সেট করা আছে তা নিশ্চিত করতে আপনাকে অবশ্যই Apigee এজ সমর্থনের সাথে যোগাযোগ করতে হবে।

  • আপনি যদি প্রাইভেট ক্লাউড গ্রাহকের জন্য একজন Apigee এজ হন, true features.allowExtensionsInPostClientFlow সেট করতে আপডেট অর্গানাইজেশন বৈশিষ্ট্য API ব্যবহার করুন।

ক্লাউড লগিং সম্পর্কে

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

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

নমুনা

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

গ্লোবাল লগ

নিম্নলিখিত নীতি বার্তাটি লিখেছে 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 Google ক্লাউড প্রকল্প আইডি যেখানে লগ তৈরি করা উচিত। কোনোটিই নয় হ্যাঁ
credentials Apigee Edge কনসোলে প্রবেশ করা হলে, এটি আপনার পরিষেবা অ্যাকাউন্ট কী ফাইলের বিষয়বস্তু। ম্যানেজমেন্ট এপিআই এর মাধ্যমে পাঠানো হলে, এটি একটি বেস64-এনকোডেড মান যা সার্ভিস অ্যাকাউন্ট কী ফাইল থেকে তৈরি হয়। কোনোটিই নয় হ্যাঁ