পরিসংখ্যান সংগ্রাহক নীতি

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

কি

পণ্য আইডি, মূল্য, REST অ্যাকশন, ক্লায়েন্ট এবং টার্গেট URL এবং বার্তার দৈর্ঘ্যের মতো একটি বার্তায় ডেটার জন্য পরিসংখ্যান সংগ্রহ করতে আপনাকে সক্ষম করে। ডেটা Apigee দ্বারা পূর্বনির্ধারিত ফ্লো ভেরিয়েবল বা আপনার সংজ্ঞায়িত কাস্টম ভেরিয়েবল থেকে আসতে পারে।

পরিসংখ্যান ডেটা বিশ্লেষণ সার্ভারে প্রেরণ করা হয়, যা পরিসংখ্যান বিশ্লেষণ করে এবং প্রতিবেদন তৈরি করে। আপনি এজ ম্যানেজমেন্ট ইউআই বা এজ এপিআই ব্যবহার করে রিপোর্ট দেখতে পারেন।

নমুনা

মৌলিক উদাহরণ

<StatisticsCollector name="publishPurchaseDetails">
  <Statistics>
    <Statistic name="productID" ref="product.id" type="string">999999</Statistic>
    <Statistic name="price" ref="product.price" type="string">0</Statistic>
  </Statistics>
</StatisticsCollector>

এই উদাহরণে, আপনি দুটি কাস্টম ভেরিয়েবল সম্পর্কে পরিসংখ্যানগত তথ্য সংগ্রহ করেন: product.id এবং product.price । প্রতিটি অনুরোধে, পরিসংখ্যান সংগ্রাহক নীতি বিশ্লেষণ সার্ভারে এই দুটি ভেরিয়েবলের মান লিখে।

এই উদাহরণটি প্রতিটি ভেরিয়েবলের জন্য একটি ঐচ্ছিক ডিফল্ট মানও সেট করে, যেখানে product.id- এর ডিফল্ট মান হল 999999 এবং ডিফল্ট product.price হল 0৷ যদি একটি ভেরিয়েবল অনির্ধারিত থাকে এবং আপনি একটি ডিফল্ট মান নির্দিষ্ট না করেন, তাহলে কোনও ডেটা রেকর্ড করা হয় না৷ পরিবর্তনশীল জন্য. আপনি যদি একটি ডিফল্ট মান নির্দিষ্ট করেন, তাহলে ডিফল্ট মানটি রেকর্ড করা হয় যখন ভেরিয়েবলটি অনির্ধারিত থাকে।

পরিসংখ্যানগত তথ্য সংগ্রহ করার পরে, আপনি পরিসংখ্যান পুনরুদ্ধার করতে এজ ম্যানেজমেন্ট UI বা API ব্যবহার করতে পারেন। পরিসংখ্যান পুনরুদ্ধার করার সময়, আপনি যথাক্রমে productID এবং মূল্য হিসাবে এই ভেরিয়েবলগুলির জন্য সংগৃহীত ডেটা উল্লেখ করেন।

পরিসংখ্যান অ্যাক্সেস করা

এই উদাহরণে, আপনি productID নামক সংগ্রহের পরিসংখ্যানগত ডেটা দেখতে এজ ম্যানেজমেন্ট API ব্যবহার করেন। এই অনুরোধটি প্রতিটি পণ্য আইডির জন্য প্রতিটি দিনের জন্য জমা দেওয়া বার্তা গণনার যোগফলের উপর ভিত্তি করে পণ্য আইডিগুলির জন্য একটি কাস্টম প্রতিবেদন তৈরি করে। ভেরিয়েবলের জন্য আপনার প্রতিষ্ঠানের নাম প্রতিস্থাপন করুন {org_name} , এবং আপনার অ্যাকাউন্টের জন্য ইমেল এবং পাসওয়ার্ড প্রতিস্থাপন করুন email:password জন্য Apigee Edge-এ।

যখন আপনার ডেটা সংগ্রহ করা হয়েছিল তখন সময়ের ব্যবধান অন্তর্ভুক্ত করতে timeRange প্যারামিটার সেট করুন। বর্তমান তারিখ থেকে ছয় মাসের বেশি পুরানো ডেটা ডিফল্টরূপে অ্যাক্সেসযোগ্য নয়। আপনি যদি ছয় মাসের বেশি পুরানো ডেটা অ্যাক্সেস করতে চান, Apigee Edge সাপোর্টের সাথে যোগাযোগ করুন।

$ curl https://api.enterprise.apigee.com/v1/o/{org_name}/environments/test/stats/productID?"select=sum(message_count)&timeRange=1/19/2015%2000:00~6/21/2015%2000:00&timeUnit=day"
-u email:password

প্রতিক্রিয়ায়, নামের ক্ষেত্রে পণ্যের আইডি থাকে এবং মান প্রতিটি দিনের জন্য অনুরোধের সংখ্যা দেখায়:

{
  "environments" : [ {
    "dimensions" : [ {
      "metrics" : [ {
        "name" : "sum(message_count)",
        "values" : [ {
          "timestamp" : 1353369600000,
          "value" : "4.0"
        } ]
      } ],
      "name" : "52"
    }, {
      "metrics" : [ {
        "name" : "sum(message_count)",
        "values" : [ {
          "timestamp" : 1353369600000,
          "value" : "19.0"
        } ]
      } ],
      "name" : "14"
    }, ...
  } ],
  "metaData" : {
    "samplingRate" : "100"
  }
}

সংগ্রহের জন্য ডেটা বের করা হচ্ছে

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ExtractVariables async="false" continueOnError="false" enabled="true" name="GetWeatherData">
    <VariablePrefix>weather</VariablePrefix>
    <XMLPayload>
       <Namespaces>
          <Namespace prefix="yweather">http://xml.weather.yahoo.com/ns/rss/1.0</Namespace>
       </Namespaces>
       <Variable name="location" type="string">
          <XPath>/rss/channel/yweather:location/@city</XPath>
       </Variable>
       <Variable name="condition" type="string">
          <XPath>/rss/channel/item/yweather:condition/@text</XPath>
       </Variable>
    </XMLPayload>
</ExtractVariables>

পরিসংখ্যান সংগ্রাহক নীতির প্রয়োজন যে সংগৃহীত ডেটা ভেরিয়েবলে সংরক্ষণ করা হবে। এই ভেরিয়েবলগুলি Apigee দ্বারা পূর্বনির্ধারিত হতে পারে, অথবা আপনার সংজ্ঞায়িত কাস্টম ভেরিয়েবল।

এই উদাহরণে, আপনি এক্সএমএল পেলোড থেকে ডেটা বের করতে এক্সট্র্যাক্ট ভেরিয়েবল নীতি ব্যবহার করেন যাতে আবহাওয়ার তথ্য রয়েছে। এই নীতি:

  • শহরের নাম এক্সট্র্যাক্ট করে এবং এটিকে আবহাওয়া. অবস্থান নামে একটি ভেরিয়েবলে লেখে
  • বর্তমান অবস্থা বের করে আবহাওয়া.কন্ডিশন নামের একটি ভেরিয়েবলে লিখে

তারপরে আপনি ভেরিয়েবল সম্পর্কে তথ্য সংগ্রহ করতে পরিসংখ্যান সংগ্রাহক নীতি ব্যবহার করতে পারেন, যেমনটি নীচে দেখানো হয়েছে:

<StatisticsCollector name="publishPurchaseDetails">
  <Statistics>
    <Statistic name="weatherLocation" ref="weather.location" type="string"></Statistic>
    <Statistic name="weatherCondition" ref="weather.condition" type="string"></Statistic>
  </Statistics>
</StatisticsCollector>

পরিসংখ্যান সংগ্রাহক নীতির জন্য একটি XML পেলোড থেকে কীভাবে ডেটা বের করতে হয় তা দেখায় একটি সম্পূর্ণ টিউটোরিয়ালের জন্য, কাস্টম বিশ্লেষণ ব্যবহার করে API বার্তা সামগ্রী বিশ্লেষণ করুন দেখুন।


পরিসংখ্যান সংগ্রাহক নীতি সম্পর্কে

যখন কার্যকর করা হয়, পরিসংখ্যান সংগ্রাহক নীতি এক বা একাধিক ভেরিয়েবলের বর্তমান মান রেকর্ড করে। এই ভেরিয়েবলগুলি Apigee দ্বারা পূর্বনির্ধারিত ফ্লো ভেরিয়েবল বা আপনার সংজ্ঞায়িত কাস্টম ভেরিয়েবল হতে পারে। এই ডেটা এজ অ্যানালিটিক্স সার্ভারে লেখা হয়।

নীতি দ্বারা সংগৃহীত পরিসংখ্যানগত ডেটা অ্যাক্সেস করতে, আপনি এজ এপিআই বা এজ ম্যানেজমেন্ট UI ব্যবহার করেন। উদাহরণস্বরূপ, আপনি একটি কাস্টম রিপোর্ট তৈরি করতে এজ ম্যানেজমেন্ট UI ব্যবহার করতে পারেন যা বিভিন্ন ফর্ম্যাটে সংগৃহীত ডেটা দেখায়।

পরিসংখ্যান সংগ্রাহক নীতি ব্যবহার করে একটি সম্পূর্ণ টিউটোরিয়ালের জন্য, কাস্টম বিশ্লেষণ ব্যবহার করে API বার্তা সামগ্রী বিশ্লেষণ দেখুন।

কোথায় পলিসি লাগাতে হবে

আপনি একটি API প্রক্সির অনুরোধ বা প্রতিক্রিয়া প্রবাহে একটি পরিসংখ্যান সংগ্রাহক নীতি রাখতে পারেন। যাইহোক, যদি আপনি একটি প্রক্সিতে একাধিক পরিসংখ্যান সংগ্রাহক নীতি রাখেন, তাহলে শেষটি কার্যকর করার জন্য বিশ্লেষণ সার্ভারে লেখা ডেটা নির্ধারণ করে এবং পূর্ববর্তী কোনো পরিসংখ্যান সংগ্রাহক নীতি দ্বারা লেখা ডেটা হারিয়ে যায়।

একটি এপিআই প্রক্সিতে আপনার একাধিক পরিসংখ্যান সংগ্রাহক নীতি থাকতে পারে এমন একটি দৃশ্য হল যখন আপনার অনুরোধ বা প্রতিক্রিয়া প্রবাহে একটি থাকে এবং অন্যটি একটি ফল্ট হ্যান্ডলারে থাকে৷ যদি API প্রক্সিতে কোনো ত্রুটি দেখা দেয়, তাহলে ফল্ট হ্যান্ডলারের পরিসংখ্যান সংগ্রাহক সংগৃহীত ডেটা নির্ধারণ করে। আপনি সেই পরিসংখ্যান সংগ্রাহকের ত্রুটি সম্পর্কে তথ্য রেকর্ড করতে বা আপনার প্রয়োজনীয় মনে করেন এমন অন্য কোনো তথ্য রেকর্ড করতে ব্যবহার করতে পারেন। ফল্ট হ্যান্ডলারে পরিসংখ্যান সংগ্রাহক সংগৃহীত ডেটা নির্ধারণ করে তা নির্বিশেষে পরিসংখ্যান সংগ্রাহক অনুরোধ/প্রতিক্রিয়ায় ইতিমধ্যেই সম্পাদিত হয়েছে কিনা।

আরও জানতে, হ্যান্ডলিং ফল্টগুলি দেখুন।

উপাদান রেফারেন্স

উপাদান রেফারেন্স পরিসংখ্যান সংগ্রহকারী নীতির উপাদান এবং বৈশিষ্ট্য বর্ণনা করে।

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<StatisticsCollector async="false" continueOnError="false" enabled="true" name="Statistics-Collector-1">
    <DisplayName>Statistics Collector 1</DisplayName>
    <Statistics>
        <Statistic name="statName" ref="varName" type="refDataType">defaultStatValue</Statistic>
    </Statistics>
</StatisticsCollector>

<StatisticsCollector> গুণাবলী

<StatisticsCollector async="false" continueOnError="false" enabled="true" name="Stats-1">

নিম্নলিখিত সারণী সমস্ত নীতির মূল উপাদানগুলির জন্য সাধারণ বৈশিষ্ট্যগুলি বর্ণনা করে:

বৈশিষ্ট্য বর্ণনা ডিফল্ট উপস্থিতি
name

নীতির অভ্যন্তরীণ নাম। name বৈশিষ্ট্যের মানটিতে অক্ষর, সংখ্যা, স্পেস, হাইফেন, আন্ডারস্কোর এবং পিরিয়ড থাকতে পারে। এই মান 255 অক্ষরের বেশি হতে পারে না।

ঐচ্ছিকভাবে, ম্যানেজমেন্ট UI প্রক্সি এডিটরে নীতিটিকে একটি ভিন্ন, প্রাকৃতিক-ভাষা নামের সাথে লেবেল করতে <DisplayName> উপাদানটি ব্যবহার করুন।

N/A প্রয়োজন
continueOnError

একটি নীতি ব্যর্থ হলে একটি ত্রুটি ফেরত দিতে false সেট করুন৷ এটি বেশিরভাগ নীতির জন্য প্রত্যাশিত আচরণ।

একটি নীতি ব্যর্থ হওয়ার পরেও ফ্লো এক্সিকিউশন চালিয়ে যেতে true সেট করুন৷

মিথ্যা ঐচ্ছিক
enabled

নীতি প্রয়োগ করতে true সেট করুন৷

নীতি বন্ধ করতে false সেট করুন। নীতিটি প্রবাহের সাথে সংযুক্ত থাকলেও তা কার্যকর করা হবে না।

সত্য ঐচ্ছিক
async

এই বৈশিষ্ট্যটি অবমূল্যায়ন করা হয়েছে৷

মিথ্যা অবচয়

<DisplayName> উপাদান

ম্যানেজমেন্ট UI প্রক্সি এডিটরে নীতিটিকে একটি ভিন্ন, প্রাকৃতিক-ভাষা নামের সাথে লেবেল করতে name বৈশিষ্ট্য ছাড়াও ব্যবহার করুন।

<DisplayName>Policy Display Name</DisplayName>
ডিফল্ট

N/A

আপনি এই উপাদানটি বাদ দিলে, নীতির name বৈশিষ্ট্যের মান ব্যবহার করা হবে।

উপস্থিতি ঐচ্ছিক
টাইপ স্ট্রিং

<পরিসংখ্যান>/<পরিসংখ্যান> উপাদান

<Statistics>
    <Statistic name="statName" ref="varName" type="refDataType">defaultStatValue</Statistic>
</Statistics>
বৈশিষ্ট্য বর্ণনা ডিফল্ট উপস্থিতি
নাম

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

যদি ref দ্বারা নির্দিষ্ট ভেরিয়েবলটি একটি অনুরোধ বা প্রতিক্রিয়াতে অনির্দিষ্ট হয়, তাহলে defaultStatValue ভেরিয়েবলের জন্য সংগৃহীত মান নির্দিষ্ট করে। আপনি যদি ডিফল্ট মান বাদ দেন, ভেরিয়েবলের জন্য কোনো ডেটা সংগ্রহ করা হয় না যখন ভেরিয়েবলটি অনির্ধারিত থাকে।

নামকরণের সীমাবদ্ধতা

নিম্নলিখিত নামকরণ সীমাবদ্ধতা কাস্টম বিশ্লেষণ ভেরিয়েবলের ক্ষেত্রে প্রযোজ্য:

N/A প্রয়োজন
রেফ

ফ্লো ভেরিয়েবল যার জন্য আপনি পরিসংখ্যান সংগ্রহ করছেন। এই ভেরিয়েবলটি Apigee দ্বারা পূর্বনির্ধারিত একটি ফ্লো ভেরিয়েবল বা আপনার API প্রক্সিতে সংজ্ঞায়িত একটি কাস্টম ভেরিয়েবল হতে পারে।

রেফ অ্যাট্রিবিউট প্রায়ই এক্সট্র্যাক্ট ভেরিয়েবল নীতি দ্বারা সংজ্ঞায়িত একটি কাস্টম ভেরিয়েবল উল্লেখ করে। আরো জন্য এক্সট্র্যাক্ট ভেরিয়েবল নীতি দেখুন.

N/A প্রয়োজন
টাইপ

রেফ অ্যাট্রিবিউট দ্বারা নির্দিষ্ট ভেরিয়েবলের ডেটা টাইপ নির্দিষ্ট করে। বৈধ মান হল: স্ট্রিং/পূর্ণসংখ্যা/ফ্লোট/লং/ডবল/বুলিয়ান।

টাইপ স্ট্রিংয়ের ডেটার জন্য, একটি কাস্টম রিপোর্টে পরিসংখ্যানগত ডেটাকে একটি মাত্রা হিসাবে উল্লেখ করুন। সংখ্যাসূচক ডেটা প্রকারের জন্য (পূর্ণসংখ্যা/ফ্লোট/লং/ডাবল), একটি কাস্টম রিপোর্টে পরিসংখ্যানগত ডেটাকে একটি মাত্রা বা একটি মেট্রিক হিসাবে উল্লেখ করুন। আরো জন্য কাস্টম রিপোর্ট পরিচালনা দেখুন.

টাইপের মান শুধুমাত্র তখনই বাদ দেওয়া যেতে পারে যদি রেফ একটি পূর্বনির্ধারিত Apigee ফ্লো ভেরিয়েবলকে নির্দেশ করে বা Extract ভেরিয়েবল নীতির XML পেলোডে টাইপটি ঘোষণা করা হয়।

স্ট্রিং ঐচ্ছিক

ত্রুটি উল্লেখ

This section describes the error messages and flow variables that are set when this policy triggers an error. This information is important to know if you are developing fault rules for a proxy. To learn more, see What you need to know about policy errors and Handling faults.

Runtime errors

None.

Deployment errors

Error name Cause Fix
UnsupportedDatatype If the type of the variable specified by the ref attribute in the <Statistic> element of the Statistics Collector policy is unsupported, then the deployment of the API proxy fails. The supported data types are string, integer, float, long, double, and boolean.
InvalidName If the name used to reference the data collected for the specified variable defined within the <Statistic> element of the Statistics Collector policy conflicts with a system-defined variable, then the deployment of the API proxy fails. Some of the known system-defined variables are organization and environment.
DatatypeMissing If the type of the variable specified by the ref attribute in the <Statistic> element of the Statistics Collector policy is missing, then the deployment of the API proxy fails.

Fault variables

None.

স্কিমা

প্রতিটি নীতির ধরন একটি XML স্কিমা ( .xsd ) দ্বারা সংজ্ঞায়িত করা হয়। রেফারেন্সের জন্য, নীতি স্কিমা GitHub এ উপলব্ধ।

সম্পর্কিত বিষয়

আরও তথ্যের জন্য, দেখুন: