আপনি Apigee Edge ডকুমেন্টেশন দেখছেন।
Apigee X ডকুমেন্টেশনে যান । তথ্য
একটি পরিবেশ, প্রক্সি, বা অঞ্চলের ট্রাফিক সময় সীমার সাথে একটি নির্দিষ্ট শতাংশ দ্বারা পরিবর্তিত হলে একটি বিজ্ঞপ্তি বাড়ানোর জন্য একটি ট্র্যাফিক সতর্কতা ব্যবহার করুন৷
আপনি সময়সীমা সেট করেছেন:
- 1 ঘন্টা
- 1 দিন
- 7 দিন
- 15 দিন (শুধুমাত্র API)
- 30 দিন (শুধুমাত্র API)
সতর্কতাটি বর্তমান সময়ের সীমার ট্র্যাফিককে পূর্ববর্তী সময়ের সীমার ট্র্যাফিকের সাথে তুলনা করে কাজ করে। উদাহরণস্বরূপ, আপনি একটি এক-ঘণ্টার সময়সীমা নির্দিষ্ট করুন৷ সতর্কতা তারপর ট্র্যাফিকের শতাংশ পরিবর্তন গণনা করতে পূর্ববর্তী ঘন্টার ট্র্যাফিকের সাথে সাম্প্রতিক সময়ের ট্র্যাফিকের তুলনা করে:
percentChange = ((currentTraffic - previousTraffic) / previousTraffic) * 100
একটি ইতিবাচক মান মানে ট্র্যাফিক বেড়েছে এবং একটি নেতিবাচক মান মানে ট্র্যাফিক কমেছে৷
তারপরে আপনি নির্দিষ্ট সময়ের জন্য API ট্র্যাফিকের শতাংশ বৃদ্ধি বা হ্রাস হিসাবে একটি ট্র্যাফিক সতর্কতা ট্রিগার করে এমন থ্রেশহোল্ড সেট করুন।
আপনি সেই শতাংশ সেট করার আগে, এটি আপনার স্বাভাবিক ট্রাফিক প্যাটার্নের সাথে সারিবদ্ধ কিনা তা নিশ্চিত করুন। উদাহরণ স্বরূপ, যদি আপনার API ট্র্যাফিক সাধারণত নির্দিষ্ট পিক সময়ে প্রতি ঘণ্টায় 100% পর্যন্ত ট্র্যাফিক স্পাইক সহ দিনে ওঠানামা করে, তবে এই স্পাইকগুলি স্বাভাবিক এবং কোনও সতর্কতা ট্রিগার করা উচিত নয়। যাইহোক, আপনি যদি ঘণ্টায় 50% বৃদ্ধির জন্য ট্রিগার করার জন্য একটি সতর্কতা কনফিগার করেন, তাহলে আপনি আপনার স্বাভাবিক ট্র্যাফিকের জন্য অপ্রয়োজনীয় সতর্কতা পাবেন।
সতর্কতা সম্পর্কে আরও জানতে, সতর্কতা এবং বিজ্ঞপ্তি সেট আপ দেখুন।
ট্রাফিক সতর্কতা এবং বিজ্ঞপ্তি যোগ করুন
ট্রাফিক সতর্কতা এবং বিজ্ঞপ্তি যোগ করতে:- এজ UI-তে বিশ্লেষণ > সতর্কতার নিয়ম-এ ক্লিক করুন।
- + সতর্কতা ক্লিক করুন।
- সতর্কতা সম্পর্কে নিম্নলিখিত সাধারণ তথ্য লিখুন:
মাঠ বর্ণনা সতর্কতার নাম সতর্কতার নাম। ট্রিগার বর্ণনা করে এমন একটি নাম ব্যবহার করুন এবং এটি আপনার জন্য অর্থবহ হবে। নাম 128 অক্ষরের বেশি হতে পারে না। বর্ণনা সতর্কতার বর্ণনা। সতর্কতার ধরন মোট ট্রাফিক নির্বাচন করুন। আরো জন্য সতর্কতা প্রকার সম্পর্কে দেখুন. পরিবেশ ড্রপ-ডাউন তালিকা থেকে পরিবেশ নির্বাচন করুন। স্ট্যাটাস সতর্কতা সক্ষম বা নিষ্ক্রিয় করতে টগল করুন। - সতর্কতা ট্রিগার করবে এমন অবস্থার জন্য থ্রেশহোল্ড এবং মাত্রা নির্ধারণ করুন।
কন্ডিশন ফিল্ড বর্ণনা থ্রেশহোল্ড পূর্ববর্তী সময়ের ব্যবধানের তুলনায় যখন ট্র্যাফিক একটি নির্দিষ্ট শতাংশ বৃদ্ধি বা হ্রাস পায় তখন সতর্কতা বাড়ানোর জন্য নির্দিষ্ট করুন।
শতাংশ দ্বারা বর্ধিত মান 0% এর চেয়ে বড় বা সমান হিসাবে সেট করুন। 0% এর চেয়ে বেশি বা সমান, এবং 100% এর কম বা সমান একটি মান শতাংশ দ্বারা হ্রাস করা সেট করুন৷
আপনি একটি সময়ের ব্যবধান বেছে নিতে পারেন:
- 1 ঘন্টা
- 1 দিন
- ১ সপ্তাহ
মাত্রা +মাত্রা যোগ করুন-এ ক্লিক করুন এবং API প্রক্সি এবং অঞ্চল সহ ফলাফল প্রদানের জন্য মাত্রার বিবরণ নির্দিষ্ট করুন।
একটি নির্দিষ্ট মাত্রা সেট করুন:
- প্রক্সি - একটি নির্দিষ্ট প্রক্সি বা সমস্ত প্রক্সিতে সেট করুন। প্রক্সি "কোনও" এর মান সমর্থন করে না। পরিবর্তে আপনি আগ্রহী প্রতিটি প্রক্সির জন্য একটি পৃথক সতর্কতা যোগ করতে পারেন৷
- অঞ্চল - একটি নির্দিষ্ট অঞ্চল বা সমস্ত অঞ্চলে সেট করুন৷ অঞ্চল "কোনও" এর মান সমর্থন করে না। পরিবর্তে আপনি আগ্রহী প্রতিটি অঞ্চলের জন্য একটি পৃথক সতর্কতা যোগ করতে পারেন।
- একটি সতর্কতা বিজ্ঞপ্তি যোগ করতে + বিজ্ঞপ্তিতে ক্লিক করুন।
বিজ্ঞপ্তি বিবরণ বর্ণনা চ্যানেল আপনি যে বিজ্ঞপ্তি চ্যানেলটি ব্যবহার করতে চান সেটি নির্বাচন করুন এবং গন্তব্য নির্দিষ্ট করুন: ইমেল, স্ল্যাক, পেজারডিউটি বা ওয়েবহুক। গন্তব্য নির্বাচিত চ্যানেল প্রকারের উপর ভিত্তি করে গন্তব্য নির্দিষ্ট করুন: - ইমেল - ইমেল ঠিকানা, যেমন
joe@company.com
- স্ল্যাক - স্ল্যাক চ্যানেল URL, যেমন
https://hooks.slack.com/services/T00000000/B00000000/XXXXX
- PagerDuty - PagerDuty কোড, যেমন
abcd1234efgh56789
- ওয়েবহুক - ওয়েবহুক ইউআরএল, যেমন
https://apigee.com/test-webhook
দ্রষ্টব্য : আপনি প্রতি বিজ্ঞপ্তিতে শুধুমাত্র একটি গন্তব্য নির্দিষ্ট করতে পারেন। একই চ্যানেলের জন্য একাধিক গন্তব্য নির্দিষ্ট করতে, অতিরিক্ত বিজ্ঞপ্তি যোগ করুন।
- ইমেল - ইমেল ঠিকানা, যেমন
- অতিরিক্ত বিজ্ঞপ্তি যোগ করতে, পূর্ববর্তী ধাপ পুনরাবৃত্তি করুন.
- আপনি একটি বিজ্ঞপ্তি যোগ করলে, নিম্নলিখিত ক্ষেত্রগুলি সেট করুন:
মাঠ বর্ণনা প্লেবুক (ঐচ্ছিক) ফ্রি-ফর্ম টেক্সট ফিল্ড যখন তারা ফায়ার করে তখন সতর্কতাগুলি সমাধানের জন্য প্রস্তাবিত ক্রিয়াগুলির একটি সংক্ষিপ্ত বিবরণ প্রদান করে। আপনি আপনার অভ্যন্তরীণ উইকি বা সম্প্রদায় পৃষ্ঠার একটি লিঙ্কও নির্দিষ্ট করতে পারেন যেখানে আপনি সর্বোত্তম অনুশীলনগুলি উল্লেখ করেন। এই ক্ষেত্রের তথ্য বিজ্ঞপ্তিতে অন্তর্ভুক্ত করা হবে। এই ক্ষেত্রের বিষয়বস্তু 1500 অক্ষরের বেশি হতে পারে না। থ্রটল ফ্রিকোয়েন্সি যা দিয়ে বিজ্ঞপ্তি পাঠাতে হয়। ড্রপ-ডাউন তালিকা থেকে একটি মান নির্বাচন করুন। - Save এ ক্লিক করুন।
ইভেন্ট ড্যাশবোর্ডে সতর্কতা দেখুন
যখন এজ একটি সতর্কতা শর্ত সনাক্ত করে, তখন এটি স্বয়ংক্রিয়ভাবে সেই শর্তটি এজ UI-তে ইভেন্ট ড্যাশবোর্ডে লগ করে। ইভেন্ট ড্যাশবোর্ডে প্রদর্শিত ইভেন্টের তালিকায় স্থির এবং শংসাপত্র উভয়ই সমস্ত সতর্কতা রয়েছে৷
একটি সতর্কতা দেখতে:
এজ UI এ বিশ্লেষণ > ইভেন্টে ক্লিক করুন। নতুন ইভেন্ট ড্যাশবোর্ড প্রদর্শিত হবে:
এর দ্বারা ইভেন্ট ড্যাশবোর্ড ফিল্টার করুন:
- পরিবেশ
- অঞ্চল
- সময়কাল
- সতর্কতাটি আরও তদন্ত করতে মেয়াদ শেষ হওয়ার শংসাপত্র ধারণকারী কীস্টোর দেখানোর জন্য ইভেন্ট ড্যাশবোর্ডে একটি সারি নির্বাচন করুন। কীস্টোর পৃষ্ঠা থেকে, আপনি একটি নতুন শংসাপত্র আপলোড করতে পারেন এবং মেয়াদ শেষ হওয়া শংসাপত্রটি মুছে ফেলতে পারেন৷
ট্রাফিক সতর্কতার সাথে সতর্কতা API ব্যবহার করুন
ট্র্যাফিক সতর্কতা তৈরি এবং পরিচালনা করতে আপনি যে APIগুলি ব্যবহার করেন তার বেশিরভাগই আপনি অন্যান্য সতর্কতার প্রকারের সাথে ব্যবহার করেন একই রকম:
- একটি সতর্কতা পান - একটি নির্দিষ্ট বা অসঙ্গতি সতর্কতা সংজ্ঞা পান।
- সতর্কতা ইতিহাস পান - সতর্কতা ইতিহাস মেট্রিক্স পান।
- একটি সতর্কতা মুছুন - একটি নির্দিষ্ট বা অসঙ্গতি সতর্কতা সংজ্ঞা মুছুন।
- সতর্কতার উদাহরণ পান - একটি ট্রিগার করা সতর্কতা সম্পর্কে তথ্য পান।
- সতর্কতা গণনা পান - সতর্কতার মোট গণনা পান।
যাইহোক, কিছু এপিআই-এর অতিরিক্ত বৈশিষ্ট্য রয়েছে যা অসঙ্গতি সতর্কতা সমর্থন করতে ব্যবহৃত হয়, যার মধ্যে রয়েছে:
- সতর্কতা পান - স্থির এবং অসঙ্গতি সতর্কতা সহ সমস্ত সতর্কতা তালিকাভুক্ত করুন।
- একটি সতর্কতা তৈরি করুন - একটি নির্দিষ্ট বা অসঙ্গতি সতর্কতা তৈরি করুন।
- একটি সতর্কতা আপডেট করুন - একটি নির্দিষ্ট বা অসঙ্গতি সতর্কতা সংজ্ঞা আপডেট করুন।
একটি ট্রাফিক সতর্কতা তৈরি বা আপডেট করুন
ট্রাফিক সতর্কতা তৈরি বা আপডেট করতে একই API ব্যবহার করুন আপনি বর্তমানে অন্যান্য সতর্কতার প্রকারের জন্য করেন। ট্রাফিক সতর্কতা তৈরি বা আপডেট করার জন্য API কলের মূল অংশটি নিম্নলিখিত পরিবর্তন সহ অন্যান্য সতর্কতার জন্য ব্যবহৃত হয়:
সতর্কতাটি একটি ট্রাফিক সতর্কতা তা নির্দিষ্ট করতে নিম্নলিখিত নতুন বৈশিষ্ট্যগুলি যোগ করুন:
"alertType": "runtime" "alertSubType": "trafficfixed"
এই বৈশিষ্ট্যগুলির ডিফল্ট মান হল:
"alertType": "runtime" "alertSubType": "fixed"
-
conditions
অ্যারেরdimensions
উপাদানে:- আপনাকে অবশ্যই
org
,env
,proxy
, এবংregion
বৈশিষ্ট্যের মান নির্ধারণ করতে হবে। শুধুমাত্র ঐ বৈশিষ্ট্য সমর্থিত. আপনিproxy
এবংregion
ALL
এ সেট করতে পারেন। - আপনাকে
total
traffic
সম্পত্তির মান সেট করতে হবে।
- আপনাকে অবশ্যই
conditions
বিন্যাসে:-
metrics
সম্পত্তির অবশ্যইtrafficChange
মান থাকতে হবে। -
comparator
বৈশিষ্ট্য অবশ্যইincreasedBy
বাdecreasedBy
সেট করা উচিত। -
threshold
প্রপার্টিতে একটি ইতিবাচক মান রয়েছে যা ট্রাফিকের শতাংশ বৃদ্ধি বা হ্রাস নির্দিষ্ট করে যেখানে1.0
এর মান 100% এর সাথে মিলে যায়।increasedBy
জন্য মান অবশ্যই 0.0 (0%) এর চেয়ে বেশি বা সমান হতে হবে।decreasedBy
জন্য মান অবশ্যই 0.0 (0%) এর চেয়ে বেশি বা সমান এবং 1.0 (100%) এর চেয়ে কম বা সমান হতে হবে। -
durationSeconds
বৈশিষ্ট্য অবশ্যই নিম্নলিখিত মানগুলির মধ্যে একটিতে সেট করতে হবে:3600
(1 ঘন্টা),86400
(1 দিন),604800
(7 দিন),1296000
(15 দিন),2592000
(30 দিন)।
-
-
reportEnabled
সম্পত্তি ট্রাফিক সতর্কতা জন্য সমর্থিত নয়.
curl 'https://apimonitoring.enterprise.apigee.com/alerts' \ -X POST \ -H 'Accept: application/json, text/plain, */*' -H "Content-Type: application/json" \ -H "Authorization: Bearer $ACCESS_TOKEN" \ -d '{ "organization":"myorg", "name":"My Traffic Alert", "description":"My traffic alert", "environment":"prod", "enabled":true, "alertType":"runtime", "alertSubType":"trafficfixed", "conditions":[ { "description":"", "dimensions": { "org":"nyorg", "env":"prod", "proxy":"ALL", "region":"ALL", "traffic":"total" }, "metric": "trafficChange", "threshold": 0.5, "durationSeconds": 3600, "comparator": "increasedBy" } ], "notifications":[{ "channel":"pagerduty", "destination":"abcd1234efgh56789"}], "playbook":"http://acme.com/myplaybook.html", "throttleIntervalSeconds":3600, "reportEnabled":true }'
আপনার OAuth 2.0 অ্যাক্সেস টোকেনে $ACCESS_TOKEN
সেট করুন, যেমনটি বর্ণনা করা হয়েছে একটি OAuth 2.0 অ্যাক্সেস টোকেন পান । এই উদাহরণে ব্যবহৃত cURL বিকল্পগুলি সম্পর্কে তথ্যের জন্য, CURL ব্যবহার করুন দেখুন।
এই API ব্যবহার করার বিষয়ে আরও তথ্যের জন্য ইভেন্ট দেখুন দেখুন।
ট্রাফিক সতর্কতা পান
ডিফল্টরূপে, Get Alerts API সমস্ত সংজ্ঞায়িত সতর্কতা সম্পর্কে তথ্য প্রদান করে। এই API এখন আপনাকে ফলাফলগুলি ফিল্টার করার জন্য ক্যোয়ারী প্যারামিটার নেয়:
-
enabled
- যদিtrue
শুধুমাত্র সক্রিয় সতর্কতা ফেরত দিতে নির্দিষ্ট করে। ডিফল্ট মানfalse
। -
alertType
- ফিরে আসার জন্য সতর্কতার ধরন নির্দিষ্ট করে। অনুমোদিত মান হলruntime
, ডিফল্ট এবংcert
। -
alertSubType
- ফিরে আসার জন্য সতর্কতা সাবটাইপ নির্দিষ্ট করে। ডিফল্ট মান সেট করা নেই, মানে সমস্ত সতর্কতা সাবটাইপ ফেরত দিন।
উদাহরণ স্বরূপ, myorg
নামের প্রতিষ্ঠানের জন্য শুধুমাত্র সক্রিয় সতর্কতা ফেরাতে নিম্নলিখিত API কল ব্যবহার করুন:
curl -H "Authorization: Bearer $ACCESS_TOKEN" \ 'https://apimonitoring.enterprise.apigee.com/alerts?org=myorg&enabled=true'
নিম্নলিখিত কল শুধুমাত্র ট্র্যাফিক সতর্কতা প্রদান করে, উভয় সক্রিয় এবং অক্ষম:
curl -H "Authorization: Bearer $ACCESS_TOKEN" \ 'https://apimonitoring.enterprise.apigee.com/alerts?org=myorg&alertType=runtime&alertSubType=trafficfixed'
আপনার OAuth 2.0 অ্যাক্সেস টোকেনে $ACCESS_TOKEN
সেট করুন, যেমনটি বর্ণনা করা হয়েছে একটি OAuth 2.0 অ্যাক্সেস টোকেন পান । এই উদাহরণে ব্যবহৃত cURL বিকল্পগুলি সম্পর্কে তথ্যের জন্য, CURL ব্যবহার করুন দেখুন।