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

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

সংস্করণ 1.3.7

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

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

পূর্বশর্ত

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

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

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

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

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

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

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

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

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

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

নমুনা

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

গ্লোবাল লগ

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