কাটো এপিআই - অডিটফিড

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

অডিটফিডের ওভারভিউ

অডিটফিড কুয়েরী আপনাকে কাটো ম্যানেজমেন্ট অ্যাপ্লিকেশনে প্রশাসকগণের দ্বারা গৃহীত পদক্ষেপগুলি বিশ্লেষণ করতে সহায়তা করে। যে ডেটা এই কুয়েরী ফিরিয়ে আনে তা Cato ম্যানেজমেন্ট অ্যাপ্লিকেশনের System> Audit Trail উইন্ডোর সাথে সাদৃশ্যপূর্ণ।

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

ফেচ করা ডেটা বোঝা

অডিটফিড এপিআই কলটি প্রতি ঘন্টায় ২ মিলিয়নেরও বেশি আইটেম দরুন অডিট ডেটা পেতে সহায়তা করতে ডিজাইন করা হয়েছে। ফেচ করা ডেটা পেজিনেট করতে সাহায্য করার জন্য, যখন সময়ফ্রেমের সাথে 1000 এর বেশি অডিট আইটেম থাকে, তখন কুয়েরী ফেচ থামিয়ে সমস্ত অডিট ডেটা প্রদর্শন না করা পর্যন্ত তা করে।

এই ফিল্ডগুলি অডিট ডেটার পেজিনেশন সম্পর্কিত: মার্কার, ফেচকাউন্ট, এবং আরও আছে কিনা। এই ক্ষেত্রগুলির ব্যাখ্যা নিচে দেখুন।

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

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

• থেকে - শুরু সময়

• প্রতি - শেষ সময়

• মার্কার - মার্কার ফিল্ডটি ইউনিক আইডেন্টিফায়ার যা শেষ আইটেমের জন্য দেয় যা এপিআই কুয়েরী ফেরত দিয়েছে।

• ফেচকাউন্ট - ফেচ করা আইটেমের সংখ্যা (প্রতি ফেচে সর্বাধিক ১০০০ আইটেম)

• আরও আছে কিনা - যদি সত্য হয়, তা নির্দেশ করে যে আরও আইটেম ফেচ করার জন্য রয়েছে

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

অডিটফিড থেকে

From ক্ষেত্রটি কুয়েরী ডেটার জন্য শুরু সময় দেখায় এবং এটা টাইমফ্রেম আর্গুমেন্টে সংজ্ঞায়িত হয়।

অডিটফিড প্রতি

To ক্ষেত্রটি কুয়েরী ডেটার জন্য শেষ সময় দেখায় এবং এটি টাইমফ্রেম আর্গুমেন্টে সংজ্ঞায়িত হয়।

অডিটফিড মার্কার

যখন কুয়েরীর উপর ১০০০ এর বেশি অডিট ডেটা আইটেম থাকে, তখন মার্কার ক্ষেত্রটি এমন একটি আইডেন্টিফায়ার দেখায় যা নতুন ফেচের আইটেমগুলি পেতে নতুন ইটারেশনের শুরু নির্দেশ করে। উদাহরণস্বরূপ, যদি কুয়েরী ২৫০০ আইটেম ফিরিয়ে দেয়, তবে এইগুলি ফেচ ইটারেশনগুলির উপর ফলাফল:

• প্রথম ইটারেশন - ফেচকাউন্ট = ১০০০ (আইটেম), মার্কার = 1234abc, আরও আছে কিনা = সত্য

• দ্বিতীয় ইটারেশন - ফেচকাউন্ট = ১০০০ (আইটেম), মার্কার = 4567def, আরও আছে কিনা = সত্য

• তৃতীয় ইটারেশন - ফেচকাউন্ট = ৫০০ (আইটেম), মার্কার = 8901xyz, আরও আছে কিনা = মিথ্যা

  শেষ ইটারেশনে মার্কার মান উপেক্ষা করতে পারেন

অডিটফিড ফেচকাউন্ট

ফেচকাউন্ট ক্ষেত্রগুলি বর্তমান ফেচ ক্রিয়ায় আইটেমগুলির মোট সংখ্যা দেখায়। এই ক্ষেত্রের জন্য সর্বাধিক মান হল ১০০০।

অডিটফিড আরও আছে কিনা

যখন আরও আছে কিনা ক্ষেত্রের মান সত্য হয়, তখন এই একই ইটারেশনের পরেও আইটেম ফেচের একটি নতুন ইটারেশন হয়।

অডিটফিড অ্যাকাউন্ট

অ্যাকাউন্টগুলি (অডিটফিড অ্যাকাউন্টরেকর্ডসমূহ) ক্ষেত্রগুলি এই কুয়েরীটির জন্য প্রশাসক আইডিগুলি এবং অডিট ডেটা দেখায়। এই কুয়েরীতে ঘটনার ডেটা ফিল্টার করার জন্য অডিটফিড অ্যাকাউন্টসমূহ > AuditRecord > AuditFieldName আর্গুমেন্ট ব্যবহার করুন। অডিটরেকর্ড ক্ষেত্রগুলির সম্পর্কে আরও তথ্যের জন্য, দেখুন auditFeed > fieldName > AuditFieldName নিচে।

অডিটফিডের জন্য আর্গুমেন্টস

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

• অ্যাকাউন্টআইডি - অ্যাকাউন্ট আইডি (একাধিক অ্যাকাউন্টের জন্য, অ্যারের মতো আইডি প্রবেশ করান)

• আইডিএস - অ্যাকাউন্ট আইডি (লিগ্যাসি আর্গুমেন্ট)

• টাইমফ্রেম - কুয়েরীর শুরু এবং শেষ সময়

• ফিল্টারস (অডিটফিল্ডফিল্টারইনপুট) - অডিট লগ ডেটা ফিল্টার করুন যা কুয়েরী করা হয় (বাস্তুতন্ত্র কুয়েরি সহ অ্যারে)

• মার্কার - একটি নির্দিষ্ট ফেচ ইটারেশনের জন্য শুধুমাত্র আইটেম দেখান মার্কার মান অনুযায়ী

অডিটফিড অ্যাকাউন্টআইডিএস আর্গুমেন্ট

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

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

অডিটফিড টাইমফ্রেম আর্গুমেন্ট

যে ডেটা কুয়েরীটির জন্য আসে তার জন্য টাইম ফ্রেম প্রবেশ করান। আর্গুমেন্টটি ফরম্যাটে রয়েছে <পর্যাপ্ত>.<সময় মান>. এই আর্গুমেন্টটি বাধ্যতামূলক।

টাইম ফ্রেম সংজ্ঞায়িত করতে সমর্থিত বিকল্পগুলি হল:

• লাস্ট.<সময়্সীমা> - লাস্ট টাইপের জন্য সময়্সীমা মান ISO-8601 অনুযায়ী এবং পূর্বনির্ধারিত নির্দিষ্ট সময়ের ডেটা প্রদর্শন করে। উদাহরণস্বরূপঃ

  • টাইমফ্রেম = লাস্ট.PT5M পূর্বের ৫ মিনিট দেখায়

  • টাইমফ্রেম = লাস্ট.PT2H পূর্বের ২ ঘণ্টা দেখায়

  • টাইমফ্রেম = লাস্ট.P1D পূর্বের ১ দিন দেখায়

  • টাইমফ্রেম = লাস্ট.P3M পূর্বের ৩ মাস দেখায়

  • টাইমফ্রেম = লাস্ট.P1Y পূর্বের ১ বছর দেখায়

• <সময়জোন>.<সংক্ষিপ্ত-সময়-ফ্রেম-স্পেসিফিকেশন> - সময়-ফ্রেম একটি শুরু এবং শেষ তারিখের সংমিশ্রণ, যা নির্দিষ্ট সময় জোন অনুযায়ী YY-MM-DD/hh:mm:ss ফরম্যাটে থাকে। উদাহরণস্বরূপ, টাইমফ্রেম = utc.2020-02-{11/04:50:00--21/04:50:00} ১১ ফেব্রুয়ারি, ২০২০ ৪:৫০:০০ am থেকে ২১ ফেব্রুয়ারি, ২০২০ ৪:৫০:০০ am পর্যন্ত বিশ্লেষণ ডেটা দেখায়।

অডিটফিড ফিল্টার আর্গুমেন্ট

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

• fieldName > AuditFieldName - অডিট ট্রেইল থেকে আইটেমগুলি সংজ্ঞায়িত করতে

• অপারেটর - অডিট ডেটা ফিল্টার করার জন্য মানগুলি সক্রিয় করার পদ্ধতি সংজ্ঞায়িত করতে

• মান - অপারেটরের সাথে ব্যবহৃত ফিল্টার মান সংজ্ঞায়িত করতে

অডিটফিড > fieldName > AuditFieldName

এইগুলি হয় বিভিন্ন ধরনের কাটো ম্যানেজমেন্ট অ্যাপ্লিকেশন কনফিগারেশনের জন্য ফিল্ড নাম যা System > Audit Trail-এ পর্যবেক্ষণ করা হয়।

• অ্যাডমিন - সেই অ্যাডমিন যে কার্যত্রইাল রেকর্ড তৈরি করেছে

• মডেল_নাম - যে বিষয়টি প্রভাবিত হয়েছে তার নাম, উদাহরণস্বরূপ আমার সাইট

• অ্যাডমিন_আইডি - সেই অ্যাডমিনের আইডি যার কার্যত্রইাল রেকর্ড তৈরি করেছে

• মডিউল - সিস্টেম মডিউল যা পরিবর্তিত হয়েছে, উদাহরণস্বরূপ MFA কনফিগারেশন, অথবা TLS পরিদর্শন

• নিবেশের তারিখ - পরিবর্তন কমিট বা সংরক্ষণ করার সময়

• পরিবর্তন_প্রকার - অ্যাডমিন যে পরিবর্তন করেছে তা বর্ণনা করে, মানগুলি হল: তৈরি হয়েছে, মুছে ফেলা হয়েছে, পরিবর্তিত হয়েছে, সক্রিয় হয়েছে, নিষ্ক্রিয় হয়েছে, এড়িয়ে গেছে

• সৃষ্টির তারিখ - পরিবর্তন শুরুর সময়

• পরিবর্তন - JSON ফরম্যাটের একটি বিস্তারিত হিসাব

• মডেল_ধরন - যে বিষয়টি পরিবর্তিত হয়েছে তার ধরন, উদাহরণস্বরূপ সাইট, সকেট, সকেটইন্টারফেস

অডিটফিড মার্কার আর্গুমেন্ট

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

উদাহরণস্বরূপ, কুয়েরী যদি ২৫০০ ইভেন্ট ফেরত দেয়, তবে প্রথম তিনটি ফেচ ইটারেশনের উপর ভিত্তি করে এগুলি ফলাফল:

• প্রথম ইটারেশন - ফেচকাউন্ট = ১০০০ (ইভেন্ট), মার্কার = 1234abc, আরও আছে কিনা = সত্য

• দ্বিতীয় ইটারেশন - ফেচকাউন্ট = ১০০০ (ইভেন্ট), মার্কার = 4567def, আরও আছে কিনা = সত্য

• তৃতীয় ইটারেশন - ফেচকাউন্ট = ১০০০ (ইভেন্ট), মার্কার = 8901xyz, আরও আছে কিনা = সত্য

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