Cato API - EventsFeed (বড় স্কেলে ইভেন্ট পর্যবেক্ষণ)

আমরা দৃঢ়ভাবে সুপারিশ করছি যে আপনি Cato API ব্যবহার শুরু করার আগে, Cato API এর জন্য সাপোর্ট নীতি পর্যালোচনা করুন।

ইভেন্টসফিড ওভারভিউ

ইভেন্টসফিড কোয়েরি আপনাকে নেটওয়ার্কিং, নিরাপত্তা, সোকেটস, ক্যাটো ক্লায়েন্টস এবং আরও সম্পর্কিত কার্যকলাপ দ্বারা উৎপাদিত ইভেন্টস বিশ্লেষণ করতে সাহায্য করে। এই কোয়েরি যে ইভেন্ট ডেটা ফেরত দেয় তা Cato ম্যানেজমেন্ট অ্যাপ্লিকেশন এর মনিটরিং > ইভেন্টস পৃষ্ঠার মত।

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

ঞ্চিত ইভেন্টগুলি বোঝা

ইভেন্টসফিড এপিআই কল আপনার অ্যাকাউন্টের ইভেন্টস এর উচ্চ স্কেলের বিশ্লেষণ এবং মনিটরিং এর জন্য ডিজাইন করা হয়েছে। এই এপিআই কোয়েরির ডেটা প্রায় রিয়েল-টাইমে আপডেট হয়।

কাটো এর ইভেন্ট ডেটা সাত দিনের জন্য সংরক্ষিত থাকে। প্রতিদিন প্রতি ২৪ ঘণ্টায়, সাত দিনের বেশী পুরাতন ডেটা মুছে ফেলা হয়।

যখন এপিআই সার্ভার কিউয়ে ৩০০০ এর বেশি ইভেন্ট থাকে, তখন ফলাফলগুলি পেজ করা হয়। এটি আপনাকে পুনরায় প্রত্যাহার করতে দেয় যতক্ষণ না তারা কিউয়ের শেষ প্রান্তে পৌঁছে যায়।

এই ক্ষেত্রগুলি ইভেন্টগুলির পেজিংয়ের সাথে সম্পর্কিত: চিহ্ন, এবং ফেচডকাউন্ট। এই ক্ষেত্রগুলির ব্যাখ্যার জন্য নিচে দেখুন।

আপনার অ্যাকাউন্টের জন্য ইভেন্টসফিড সক্রিয় করা

আপনার অ্যাকাউন্টকে ক্যাটো এপিআই সার্ভার এ ইভেন্ট পাঠাতে সক্ষম করতে এপিআই অ্যাক্সেস ব্যবস্থাপনা উইন্ডোটি ব্যবহার করুন। আপনি ইভেন্টসফিড সক্ষম করার পরে, এপিআই সার্ভারকে কোয়েরির জন্য ডেটা ফেরত করার জন্য যথেষ্ট ইভেন্ট সংগ্রহ করতে প্রায় ৩০ মিনিট অপেক্ষা করুন।

আপনার অ্যাকাউন্টের জন্য ইভেন্টসফিড সক্রিয় করতে:

  1. নেভিগেশন পেনেলে, প্রশাসন > এপিআই & ইন্টিগ্রেশন নির্বাচন করুন এবং ইভেন্টস ইন্টিগ্রেশন ট্যাবে ক্লিক করুন।
  2. Cato ইভেন্টগুলির সাথে ইন্টিগ্রেশন সক্রিয় করুন নির্বাচন করুন। আপনার অ্যাকাউন্ট ক্যাটো এপিআই সার্ভারে ইভেন্ট পাঠানো শুরু করে।

EventFeed.png

ইভেন্টসফিড ক্ষেত্রগুলির জন্য বিস্তারিত

এইসব বিশদ বিবরণগুলি ইভেন্টসফিড ক্ষেত্রগুলি কোয়েরির জন্য প্রদর্শন করতে পারে:

  • চিহ্ন - চিহ্ন ক্ষেত্র হল সেই শেষ ইভেন্টের জন্য অনন্য পরিচিতি যা এপিআই কোয়েরি ফেরত দিয়েছে।
  • ফেচডকাউন্ট - পুনরুদ্ধারকৃত ইভেন্টের সংখ্যা (প্রতিটি ফেচের সর্বাধিক ৩০০০ ইভেন্ট)
  • অ্যাকাউন্ট (ইভেন্টসফিডঅ্যাকাউন্টরেকর্ডস) - অ্যাকাউন্টের ইভেন্ট ডেটা (নেস্টেড কোয়েরি এবং ক্ষেত্রগুলির সাথে অ্যারে)

ইভেন্টসফিড চিহ্ন

যখন এপিআই সার্ভার কিউয়ে ৩০০০ এর বেশি ইভেন্ট থাকে, তখন চিহ্ন ক্ষেত্রটি এমন একটি পরিচিতি দেখায় যা ইভেন্ট পুনরুদ্ধার করার একটি নতুন পুনরাবৃত্তি শুরু করার নির্দেশ দেয়। উদাহরণস্বরূপ, যদি কোয়েরি ৭৫০০ টি ইভেন্ট ফেরত দেয়, তাহলে এই ফেচ পুনরাবৃত্তিগুলির সময় ফলাফলগুলি হয়:

  • প্রথম পুনরাবৃত্তি - ফেচডকাউন্ট = 3000 (ইভেন্ট), মার্কার = 1234abc
  • দ্বিতীয় পুনরাবৃত্তি - ফেচডকাউন্ট = 3000 (ইভেন্ট), মার্কার = 4567def
  • তৃতীয় পুনরাবৃত্তি - ফেচডকাউন্ট = 1500 (ইভেন্ট), মার্কার = 8901xyz

    আপনি চূড়ান্ত পুনরাবৃত্তির জন্য মার্কার মানটিকে উপেক্ষা করতে পারেন

ইভেন্টসফীড ফেচডকাউন্ট

ফেচডকাউন্ট ক্ষেত্রগুলি বর্তমান ফেচ কার্যক্রমে ইভেন্টগুলির মোট সংখ্যা দেখায়। এই ক্ষেত্রের সর্বোচ্চ মান হল 3000।

ইভেন্টসফীড অ্যাকাউন্টস

অ্যাকাউন্টগুলি (ইভেন্টসফীডঅ্যাকাউন্টরেকর্ডস) ক্ষেত্রগুলি এই প্রশ্নের জন্য অ্যাকাউন্ট আইডি এবং ইভেন্ট ডেটা দেখায়। প্রদর্শিত প্রশ্নের জন্য ইভেন্ট ডেটা ফিল্টার করতে ইভেন্টসফীডঅ্যাকাউন্টসরেকর্ডস > ইভেন্টরেকর্ড > ইভেন্টক্ষেত্র নামের আর্গুমেন্ট ব্যবহার করুন। ইভেন্টরেকর্ড সম্পর্কে আরও তথ্যের জন্য, Cato API - ইভেন্টসফীড > ইভেন্টরেকর্ড দেখুন।

ইভেন্টসফীড > রেকর্ডস > ইভেন্টক্ষেত্র নাম

বিভিন্ন প্রকারের ইভেন্টগুলির জন্য ইভেন্টক্ষেত্র নামের এনাম মান সম্পর্কে আরও তথ্যের জন্য, Cato Networks GraphQL API রেফারেন্স দেখুন।

ইভেন্টসফীডের জন্য আর্গুমেন্টস

এগুলি সেই আর্গুমেন্টস যা আপনি প্রশ্ন দ্বারা ফেরত আনা ডেটা সংজ্ঞায়িত করতে ব্যবহার করতে পারেন:

  • অ্যাকাউন্ট আইডিস - অ্যাকাউন্ট আইডিস (একাধিক অ্যাকাউন্টের জন্য, আইডিসগুলো একটি অ্যারের মধ্যে প্রবেশ করান)
  • ফিল্টারস (ইভেন্টক্ষেত্রফিল্টারইনপুট) - প্রশ্ন করা ইভেন্ট এবং অডিট লগ ডেটা ফিল্টার করা (নেইস্টেড প্রশ্ন সহ অ্যারে)
  • মার্কার - একটি নির্দিষ্ট ফেচ পুনরাবৃত্তির জন্য শুধুমাত্র ইভেন্টগুলি দেখান মার্কার মান অনুযায়ী

ইভেন্টসফীড আইডি আর্গুমেন্ট

প্রশ্ন দ্বারা ফিরিয়ে আনা ডেটার জন্য একটি বা একাধিক ক্যাটো অ্যাকাউন্ট আইডি লিখুন। এই আর্গুমেন্টটি বাধ্যতামূলক।

এই অ্যাকাউন্ট আইডি ক্যাটো ম্যানেজমেন্ট অ্যাপ্লিকেশন-এ দেখানো হয় না; পরিবর্তে এটি ক্যাটো ম্যানেজমেন্ট অ্যাপ্লিকেশন ইউআরএল-এর মধ্যে সংখ্যা। উদাহরণস্বরূপ, নিম্নলিখিত ইউআরএল-এ জন্য অ্যাকাউন্ট আইডি হল 26: https://cc2.catonetworks.com/#!/26/topology।

ইভেন্টসফীড ফিল্টারস আর্গুমেন্ট

ফিল্টারস (ইভেন্টক্ষেত্রফিল্টারইনপুট) আর্গুমেন্টটি আপনাকে প্রশ্নে অন্তর্ভুক্ত নির্দিষ্ট ইভেন্টগুলি সংজ্ঞায়িত করার অনুমতি দেয়। এগুলি সেই আর্গুমেন্টস যা আপনি সংজ্ঞায়িত করতে পারেন:

  • ক্ষেত্র নাম > ইভেন্টফিডফিল্টারক্ষেত্র নাম - ইভেন্ট আবিষ্কার থেকে ইভেন্ট প্রকার বা উপপ্রকার সংজ্ঞায়িত করুন
  • অপারেটর - ইভেন্ট ডেটা ফিল্টার করার জন্য মানগুলি কিভাবে সক্রিয় হবে সংজ্ঞায়িত করুন
  • মানগুলো - অপারেটরের সাথে যে ফিল্টার মানটি ব্যবহার হয় তা সংজ্ঞায়িত করুন

নিম্নলিখিত ফিল্টার সিনট্যাক্স হল একটি প্রশ্নের উদাহরণ যা ইভেন্ট প্রকারগুলি নিরাপত্তা মান দিয়ে দেখানোর জন্য ফিল্টার করা হয়েছে:

"ফিল্টারস": [
{
"ক্ষেত্র নাম": "event_type",
"অপারেটর": "হল",
"মান": ["নিরাপত্তা"]
}
]

নিম্নলিখিত ফিল্টার সিনট্যাক্স একটি উদাহরণ যা শুধুমাত্র ইভেন্ট উপপ্রকারগুলি মান সহ দেখায় ইন্টারনেট ফায়ারওয়াল:

"ফিল্টার": [
{
"fieldName": "event_sub_type",
"operator": "হল",
"values": ["ইন্টারনেট ফায়ারওয়াল"]
}
]

eventsFeed মার্কার আর্গুমেন্ট

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

  • প্রথম ইটারেশন - fetchedCount = 3000 (ইভেন্ট), মার্কার = 1234abc
  • দ্বিতীয় ইটারেশন - fetchedCount = 3000 (ইভেন্ট), মার্কার = 4567def
  • তৃতীয় ইটারেশন - fetchedCount = 3000 (ইভেন্ট), মার্কার = 8901xyz

শুধুমাত্র দ্বিতীয় ইটারেশনের জন্য ইভেন্টগুলি দেখানোর জন্য, মার্কার আর্গুমেন্ট 4567def এ সেট করুন।

সকল ইভেন্টগুলি ফেচ করতে, একটি খালি মার্কার আর্গুমেন্ট (মার্কার:"") সহ প্রাথমিক GraphQL কোয়েরি চালান।

Was this article helpful?

2 out of 4 found this helpful

0 comments