API বিশ্লেষণ ওভারভিউ

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

এই বিষয় এজ এপিআই অ্যানালিটিক্স প্রবর্তন করে।

ভিডিও: এজ এপিআই অ্যানালিটিক্স পরিষেবাগুলির একটি ওভারভিউয়ের জন্য একটি ছোট ভিডিও দেখুন।

বিশ্লেষণের মাধ্যমে আপনার API উন্নত করুন

এজ এপিআই অ্যানালিটিক্স অনেক তথ্য সংগ্রহ করে এবং গণনা করে যা API প্রক্সির মাধ্যমে প্রবাহিত হয়। আপনি এজ UI-তে গ্রাফ এবং চার্ট দিয়ে এই ডেটাটি কল্পনা করতে পারেন, অথবা আপনি এজ ম্যানেজমেন্ট API ব্যবহার করে অফলাইন বিশ্লেষণের জন্য কাঁচা ডেটা ডাউনলোড করতে পারেন।

বিশ্লেষণ আপনাকে সাধারণ প্রশ্নের উত্তর দিতে সাহায্য করে, যেমন:

  • সময়ের সাথে সাথে আমার API ট্র্যাফিক কেমন চলছে?
  • কোন API পদ্ধতি সবচেয়ে জনপ্রিয়?
  • আমার শীর্ষ বিকাশকারী কারা?
  • কখন API প্রতিক্রিয়া সময় দ্রুততম? সবচেয়ে ধীর?
  • ভৌগলিকভাবে, আমি সবচেয়ে বেশি API ট্র্যাফিক কোথায় দেখতে পাব?

এই জাতীয় প্রশ্নের উত্তরগুলি আপনাকে আপনার APIগুলি উন্নত করতে, সমস্যার সমাধান করতে এবং আপনার API প্রোগ্রামের সাথে সম্পর্কিত আরও ভাল ব্যবসায়িক সিদ্ধান্ত নিতে সহায়তা করে৷

API অ্যানালিটিক্স সকলকে উন্নতি করতে সাহায্য করে

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

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

কি ধরনের তথ্য সংগ্রহ ও বিশ্লেষণ করা হয়?

এজ এপিআই অ্যানালিটিক্স একটি বিস্তৃত বর্ণালী ডেটা সংগ্রহ করে এবং বিশ্লেষণ করে যা API প্রক্সি জুড়ে প্রবাহিত হয় যেমন:

  • প্রতিক্রিয়া সময়
  • বিলম্বের অনুরোধ করুন
  • অনুরোধের আকার
  • লক্ষ্য ত্রুটি
  • API পণ্যের নাম
  • বিকাশকারীর ইমেল ঠিকানা
  • অ্যাপের নাম
  • আরও অনেকে

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

আমি কিভাবে কাস্টম বিশ্লেষণ ডেটা সংগ্রহ করব?

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

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

Analytics ডেটা এবং API মনিটরিং ডেটার মধ্যে পার্থক্য

এই বিভাগটি এজ অ্যানালিটিক্স বনাম API মনিটরিং দ্বারা সংগৃহীত ডেটার মধ্যে কিছু ছোটখাটো পার্থক্য বর্ণনা করে। যেহেতু API মনিটরিং এবং অ্যানালিটিক্স বিভিন্ন ডেটা পাইপলাইন ব্যবহার করে, আপনি মনিটরিং দ্বারা তৈরি কাস্টম রিপোর্ট এবং অ্যানালিটিক্স দ্বারা তৈরি রিপোর্টগুলির মধ্যে সামান্য পার্থক্য দেখতে পারেন৷ উদাহরণস্বরূপ, আপনি টাইমআউট ত্রুটির জন্য রিপোর্ট করা ফলাফলে অসঙ্গতি দেখতে পারেন—উভয় ব্যাকএন্ড টাইমআউট (অনুরোধে HTTP স্ট্যাটাস কোড 504) এবং ক্লায়েন্ট টাইমআউট (HTTP স্ট্যাটাস কোড 499)। এগুলি অ্যানালিটিক্স কাস্টম রিপোর্টে স্ট্যাটাস কোড 200 এর সাথে দেখা যেতে পারে, কিন্তু কাস্টম রিপোর্ট মনিটরিং এ স্ট্যাটাস কোড 504 বা 499 এর সাথে দেখাবে।

আমার বিশ্লেষণ ডেটা কখন এবং কতক্ষণের জন্য উপলব্ধ?

দুটি সময়ের ব্যবধান রয়েছে যা নিয়ন্ত্রণ করে কখন এবং কতক্ষণ আপনি আপনার বিশ্লেষণ ডেটা দেখতে পারবেন:

  • ডেটা বিলম্বের ব্যবধান - একটি API প্রক্সিতে কল করার পরে, প্রদর্শনের জন্য বা পরিচালনা API কলগুলির মাধ্যমে ডেটা অ্যাক্সেসযোগ্য হতে 10 মিনিট পর্যন্ত সময় লাগতে পারে।
  • ডেটা ধারণ - এজ দ্বারা বিশ্লেষণ ডেটা ধরে রাখার দৈর্ঘ্য পরিকল্পনা অনুসারে আলাদা হয় ৷ আপনার পরিকল্পনার উপর নির্ভর করে, বিগত 30, 60, 90 বা 365 দিনের জন্য বিশ্লেষণ ডেটা উপলব্ধ হতে পারে।

আমি কিভাবে আমার বিশ্লেষণ ডেটা অ্যাক্সেস করতে পারি?

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

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

বিশ্লেষণ ড্যাশবোর্ড

এজ UI পূর্বনির্ধারিত ড্যাশবোর্ডের একটি সেট সরবরাহ করে যা আপনি বিশ্লেষণ ডেটা দেখতে ব্যবহার করতে পারেন। উদাহরণস্বরূপ, নিম্নলিখিত চিত্রগুলি প্রক্সি পারফরম্যান্স ড্যাশবোর্ড দেখায়:

এই ড্যাশবোর্ড এর জন্য চার্ট অন্তর্ভুক্ত করে:

  • মোট ট্র্যাফিক - একটি প্রতিষ্ঠানে API পরিবেশের জন্য এজ দ্বারা প্রাপ্ত API অনুরোধের মোট সংখ্যা।
  • ট্রাফিক সাফল্য - একটি সফল প্রতিক্রিয়ার ফলে মোট অনুরোধের সংখ্যা। ত্রুটি প্রতিক্রিয়া গণনা করা হয় না.
  • ট্র্যাফিক ত্রুটি - অসফল সমস্ত API অনুরোধের মোট সংখ্যা; যে, অনুরোধ একটি প্রতিক্রিয়া প্রদান করে না. গণনার মধ্যে প্রক্সি ত্রুটি (অ্যাপিজি সাইড) এবং লক্ষ্য ত্রুটি (ব্যাকএন্ড পরিষেবা) উভয়ই অন্তর্ভুক্ত রয়েছে।
  • গড় TPS - API অনুরোধের গড় সংখ্যা এবং প্রতি সেকেন্ডে ফলস্বরূপ প্রতিক্রিয়া।

অতিরিক্ত পূর্বনির্ধারিত ড্যাশবোর্ড অন্তর্ভুক্ত:

এই পূর্বনির্ধারিত ড্যাশবোর্ড সম্পর্কে আরও তথ্যের জন্য, বিশ্লেষণ ড্যাশবোর্ড ব্যবহার করা দেখুন।

কাস্টম রিপোর্ট

কাস্টম রিপোর্টগুলি আপনাকে নির্দিষ্ট API মেট্রিক্সে ড্রিল-ডাউন করতে দেয় এবং আপনি যে সঠিক ডেটা দেখতে চান তা দেখতে দেয়। আপনি এজ-এ তৈরি যেকোনও অ্যানালিটিক্স ডেটা ব্যবহার করে একটি কাস্টম রিপোর্ট তৈরি করতে পারেন অথবা StatisticsCollector পলিসি দ্বারা সংগৃহীত কাস্টম অ্যানালিটিক্স ডেটা।

একটি কাস্টম রিপোর্ট তৈরি করার সময়, আপনি যে ডেটা দেখতে চান তা নির্বাচন করুন (মেট্রিক্স), অর্থপূর্ণ উপায়ে (মাত্রা) ডেটা গোষ্ঠীবদ্ধ করুন এবং ডেটার নির্দিষ্ট বৈশিষ্ট্যের (ফিল্টারিং) উপর ভিত্তি করে ঐচ্ছিকভাবে প্রত্যাবর্তিত ডেটা সীমাবদ্ধ করুন।

আপনি একটি কলাম বা লাইন চার্ট হিসাবে কাস্টম রিপোর্টে প্রদর্শিত চার্টের ধরন সেট করতে পারেন। নিম্নলিখিত চিত্রগুলি API প্রক্সি দ্বারা গোষ্ঠীবদ্ধ প্রতি সেকেন্ডে লেনদেনের জন্য চার্ট উদাহরণগুলি দেখায়:

  • কলাম - প্রতিটি API প্রক্সি একটি ভিন্ন কলাম দ্বারা প্রতিনিধিত্ব করা হয়:

    কাস্টম কলাম চার্ট

  • লাইন - প্রতিটি API প্রক্সি একটি ভিন্ন লাইন হিসাবে উপস্থাপিত হয়:

    কাস্টম লাইন চার্ট

আরও তথ্যের জন্য, কাস্টম রিপোর্ট তৈরি এবং পরিচালনা দেখুন।

বিশ্লেষণ API

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

API প্রক্সিগুলির জন্য বিশ্লেষণ ডেটা পুনরুদ্ধারের জন্য এখানে একটি উদাহরণ API কল রয়েছে:

curl  https://api.enterprise.apigee.com/v1/o/org_name/environments/test/stats/apiproxy?"select=sum(message_count)&timeRange=6/24/2018%2000:00~6/24/2018%2023:59&timeUnit=hour" \
-u email:password

এই কলটি ফিরে আসে:

  • API প্রক্সি প্রতি অনুরোধের সমষ্টি (বার্তা সংখ্যা)
  • একটি 24 ঘন্টা সময়ের জন্য
  • ঘন্টা অনুসারে গোষ্ঠীবদ্ধ

timeRange ক্যোয়ারী প্যারামিটার ফর্মে সময়কাল নির্দিষ্ট করে:

?timeRange=MM/DD/YYYY%20HH:MM~MM/DD/YYYY%20HH:MM

HH:MM এর আগে %20 লক্ষ্য করুন। timeRange প্যারামিটারের জন্য HH:MM এর আগে একটি URL-এনকোড করা স্পেস অক্ষর প্রয়োজন, বা একটি + অক্ষর, যেমন: MM/DD/YYYY+HH:MM~MM/DD/YYYY+HH:MM

আরও তথ্যের জন্য, API প্রোগ্রাম কর্মক্ষমতা পরিমাপ করতে মেট্রিক্স API ব্যবহার করুন দেখুন।

Google ক্লাউডে বিশ্লেষণ ডেটা রপ্তানি করুন

আপনি এজ থেকে আপনার নিজস্ব ডেটা রিপোজিটরি, যেমন Google ক্লাউড স্টোরেজ বা BigQuery- এ পুরো দিনের জন্য সমস্ত বিশ্লেষণ ডেটা রপ্তানি করতে এজ ম্যানেজমেন্ট API ব্যবহার করতে পারেন। তারপরে আপনি আপনার নিজস্ব ডেটা বিশ্লেষণ করার জন্য Google Cloud BigQuery এবং TensorFlow দ্বারা অফার করা শক্তিশালী ক্যোয়ারী এবং মেশিন লার্নিং ক্ষমতার সুবিধা নিতে পারেন।

আরও জানতে, বিশ্লেষণ থেকে ডেটা রপ্তানি দেখুন।

আমি কিভাবে অ্যাপ ডেভেলপারদের সাথে ডেটা শেয়ার করব?

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

alt_text

অ্যাপ ডেভেলপাররা শুধুমাত্র তাদের অ্যাপের গুণমান নিয়েই চিন্তিত নয়, তারা আপনার এপিআই-এর প্রতি খুব আগ্রহী। ড্রুপাল-ভিত্তিক বিকাশকারী পোর্টালগুলিতে একটি ঐচ্ছিক অ্যাপ পারফরম্যান্স পৃষ্ঠা রয়েছে যা অ্যাপ বিকাশকারীদের তাদের অ্যাপগুলির জন্য গুরুত্বপূর্ণ মেট্রিক্সে অ্যাক্সেস দেওয়ার জন্য ডিজাইন করা হয়েছে। এই পৃষ্ঠাটি বিকাশকারীদের সম্পর্কে তথ্য দেয়:

  • ত্রুটি: আমার অ্যাপটি কোন API ত্রুটিগুলি দেখছে?
  • কর্মক্ষমতা: এপিআই কি এখনই ধীর? কোন এপিআই পদ্ধতিগুলি এই মুহুর্তে সাধারণত ধীর বা ধীর হয়?
  • উপলব্ধতা: এপিআই কি এখনই উপরে বা নিচে?
  • কোটা: আপনার API-এর কি কোটা আছে? আর অ্যাপ ডেভেলপার হিসেবে আমি কোটার বিরুদ্ধে কিভাবে কাজ করছি?

আরো জন্য, দেখুন:

উপরন্তু, আপনি আপনার ডেভেলপারদের সাথে বিশ্লেষণ শেয়ার করতে পারেন:

আমি কিভাবে সম্পূর্ণ বিশ্লেষণ ডেটা তৈরি করব?

সম্পূর্ণ বিশ্লেষণ বলতে আমরা কী বুঝি? আপনি, উদাহরণস্বরূপ, একটি API প্রক্সি তৈরি করতে পারেন এবং এজ সেই প্রক্সি সম্পর্কে বিশ্লেষণ ডেটা সংগ্রহ করবে৷ কিন্তু এপিআই প্রক্সি বলে ডেভেলপার বা অ্যাপের মেট্রিক্স সম্পর্কে কী? যদি এজ না জানে কে একটি API কল করেছে, তবে এটি সেই ডেটা সংগ্রহ করতে পারে না।

এজকে কোন ডেভেলপার এবং কোন ডেভেলপার অ্যাপগুলি আপনার API প্রক্সিগুলিকে কল করছে তা নির্ধারণ করতে কয়েকটি পদক্ষেপের প্রয়োজন৷ এখানে আরও বিস্তারিত তথ্যের লিঙ্ক সহ সেই পদক্ষেপগুলির একটি তালিকা রয়েছে:

  1. এক বা একাধিক API পণ্য তৈরি করুন , যা একটি পরিষেবা পরিকল্পনার সাথে API প্রক্সিগুলির একটি গ্রুপিং। API পণ্য পরিচালনা দেখুন।
  2. এজ দিয়ে অ্যাপ ডেভেলপারদের নিবন্ধন করুনঅ্যাপ ডেভেলপারদের নিবন্ধন করুন দেখুন।
  3. অ্যাপ নিবন্ধন করুন এবং আপনার বিকাশকারীদের জন্য API কী তৈরি করুন। অ্যাপগুলি নিবন্ধন করুন এবং API কীগুলি পরিচালনা করুন দেখুন।
  4. আপনার API প্রক্সিগুলিতে নিরাপত্তা নীতি যোগ করুন যা API কী এবং/অথবা নিরাপত্তা টোকেন যাচাই করে। নিম্নলিখিত বিষয়গুলি দেখুন: API কী নীতি যাচাই করুন , OAuthV2 নীতি , এবং JWT নীতি যাচাই করুন
  5. আপনি যদি এজ মাইক্রোগেটওয়ে ব্যবহার করেন তবে নিশ্চিত করুন যে আপনি বিশ্লেষণ প্লাগইন সক্ষম করেছেন (যা ডিফল্টরূপে সক্ষম)৷ বিশ্লেষণ প্লাগইন নিষ্ক্রিয় থাকলে, এজ মাইক্রোগেটওয়ে এজ বিশ্লেষণে বিশ্লেষণ ডেটা পাঠাবে না।

নিম্নলিখিত টিউটোরিয়ালগুলি আপনাকে প্রয়োজনীয় পদক্ষেপগুলির মাধ্যমে গাইড করে যা আপনাকে বিকাশকারী এবং অ্যাপগুলির বিশ্লেষণ দেখতে দেয়: API কীগুলির প্রয়োজন করে একটি API সুরক্ষিত করুন এবং OAuth এর সাথে একটি API সুরক্ষিত করুন

API বিশ্লেষণের সাথে API মনিটরিং তুলনা করুন

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

এপিআই মনিটরিং এবং এপিআই অ্যানালিটিক্সের মধ্যে প্রাথমিক পার্থক্যগুলির মধ্যে একটি হল এপিআই মনিটরিং-এ তৈরি সতর্কতা প্রক্রিয়া। সতর্কতার সাথে, আপনি একটি HTTP স্ট্যাটাস কোড (2xx/4xx/5xx), লেটেন্সি, বা ফল্ট কোড থ্রেশহোল্ড নির্দিষ্ট করেন যা অতিক্রম করলে, আপনার অপস টিমের কাছে একটি সতর্কতা বিজ্ঞপ্তি ট্রিগার করে। সতর্কতা বিজ্ঞপ্তিগুলি ইমেল, স্ল্যাক, পেজার বা ওয়েবহুকের মতো বিভিন্ন চ্যানেলের মাধ্যমে পাঠানো যেতে পারে, যা আপনাকে অবিলম্বে সমস্যার প্রতিক্রিয়া জানাতে দেয়।

এই পরিষেবাগুলির মধ্যে আরও বিশদ তুলনার জন্য এজ এপিআই অ্যানালিটিক্সের সাথে তুলনা API মনিটরিং দেখুন।

আরও তথ্য