অসঙ্গতি সনাক্তকরণ API ব্যবহার করুন

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

অ্যানোমলি অ্যালার্ট তৈরি এবং পরিচালনা করতে এবং অ্যানোমলি মেট্রিক্স সংগ্রহ করতে আপনি যে APIগুলি ব্যবহার করেন তার বেশিরভাগই আপনি স্থির সতর্কতার সাথে যেগুলি ব্যবহার করেন তার মতোই৷ নিম্নলিখিত সতর্কতা APIগুলি স্থির এবং অসঙ্গতি সতর্কতার জন্য একইভাবে কাজ করে:

যাইহোক, কিছু এপিআই-এর অতিরিক্ত বৈশিষ্ট্য রয়েছে যা অসঙ্গতি সতর্কতা সমর্থন করতে ব্যবহৃত হয়, যার মধ্যে রয়েছে:

$ACCESS_TOKEN সেট করা হচ্ছে

নীচে দেখানো সমস্ত API কলগুলি $ACCESS_TOKEN নামক একটি এনভায়রনমেন্ট ভেরিয়েবলে আপনার শংসাপত্রগুলি পাস করে৷ আপনার OAuth 2.0 অ্যাক্সেস টোকেনে $ACCESS_TOKEN সেট করুন, যেমনটি বর্ণনা করা হয়েছে একটি OAuth 2.0 অ্যাক্সেস টোকেন পান । এই উদাহরণগুলিতে ব্যবহৃত cURL বিকল্পগুলি সম্পর্কে তথ্যের জন্য, CURL ব্যবহার করুন দেখুন।

সতর্কতা পান

ডিফল্টরূপে, সতর্কতা পান API সমস্ত সংজ্ঞায়িত সতর্কতা সম্পর্কে তথ্য প্রদান করে। এই API এখন আপনাকে ফলাফলগুলি ফিল্টার করার জন্য ক্যোয়ারী প্যারামিটার নেয়:

  • enabled - যদি true শুধুমাত্র সক্রিয় সতর্কতা ফেরত দিতে নির্দিষ্ট করে। ডিফল্ট মান false ।
  • alertType - ফিরে আসার জন্য সতর্কতার ধরন নির্দিষ্ট করে। অনুমোদিত মান হল runtime , ডিফল্ট, cert ।
  • alertSubType - ফিরে আসার জন্য সতর্কতা সাবটাইপ নির্দিষ্ট করে। ডিফল্ট মান সেট করা নেই, মানে সমস্ত সতর্কতা সাবটাইপ ফেরত দিন। অসঙ্গতি সতর্কতা ফেরত দিতে anomaly নির্দিষ্ট করুন।

উদাহরণ স্বরূপ, 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=anomaly'

একটি অসঙ্গতি সতর্কতা তৈরি বা আপডেট করুন

একটি অসঙ্গতি সতর্কতা তৈরি বা আপডেট করতে আপনি বর্তমানে একটি নির্দিষ্ট সতর্কতার জন্য একই API ব্যবহার করুন৷ একটি অসঙ্গতি সতর্কতা তৈরি বা আপডেট করার জন্য API কলের মূল অংশটি নিম্নলিখিত পরিবর্তন সহ একটি নির্দিষ্ট সতর্কতার জন্য ব্যবহৃত হয়:

  • সতর্কতাটি একটি অসঙ্গতি সতর্কতা তা নির্দিষ্ট করতে আপনাকে অবশ্যই নিম্নলিখিত নতুন বৈশিষ্ট্যগুলি যোগ করতে হবে:

    "alertType": "runtime"
"alertSubType": "anomaly"

    এই বৈশিষ্ট্যগুলির ডিফল্ট মান হল:

    "alertType": "runtime"
"alertSubType": "fixed"

  • conditions বিন্যাসে:

    • metrics সম্পত্তি শুধুমাত্র মান নেয়:

      • count - এইচটিটিপি ত্রুটির সংখ্যায় একটি সতর্কতা বাড়ান।
      • totalLatency - বিলম্বের জন্য একটি সতর্কতা বাড়ান।
    • threshold প্রপার্টি একটি সংখ্যার পরিবর্তে একটি স্ট্রিং নেয়। সমর্থিত মানগুলির মধ্যে রয়েছে: slight , moderate এবং severe ।
    • durationSeconds এবং comparator বৈশিষ্ট্য সমর্থিত নয়।

  • conditions অ্যারের dimensions উপাদানে:

    • আপনাকে অবশ্যই proxy সম্পত্তির মান ALL এ সেট করতে হবে।
    • statusCode প্রপার্টি শুধুমাত্র 4xx, 503, 504, and 5xx এর মান সমর্থন করে।
    • developerApp , collection , faultCodeCategory , faultCodeSubCategory , faultCodeName বৈশিষ্ট্যগুলি সমর্থিত নয়৷
  • reportEnabled সম্পত্তি অসঙ্গতি সতর্কতার জন্য সমর্থিত নয়।

নিম্নলিখিত উদাহরণ API কল একটি অসঙ্গতি সতর্কতা তৈরি করে যেটি ট্রিগার হয় যখন 5xx স্ট্যাটাস কোড যেকোন অঞ্চলের জন্য প্রোড পরিবেশে সমস্ত API প্রক্সির জন্য একটি মাঝারি হারে ঘটে। সতর্কতা ট্রিগার হলে নির্দিষ্ট ইমেল ঠিকানায় একটি বিজ্ঞপ্তি পাঠানো হয়: 

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":"5xx Anomaly Alert",
     "description":"My 5xx alert",
     "environment":"prod",
     "enabled":true,
     "alertType": "runtime",
     "alertSubType": "anomaly",
     "conditions":[
     {
        "description":"",
        "dimensions":{
            "org":"myorg",
            "env":"prod",
            "proxy":"ALL",
            "region":"ANY",
            "statusCode":"5xx"
        },
        "metric":"count",
        "threshold": "moderate"
     }
     ],
     "notifications":[{
         "channel":"email",
         "destination":"ops@acme.com"
     }],
     "playbook":"http://acme.com/myplaybook.html",
     "throttleIntervalSeconds":3600
    }'

অসঙ্গতি সহ ঘটনা API ব্যবহার করুন

একটি নির্দিষ্ট সময়ের ব্যবধানের জন্য একটি প্রতিষ্ঠানের সমস্ত ইভেন্ট পেতে /metrics/events API ব্যবহার করুন। ইভেন্টের তালিকায় এজ দ্বারা শনাক্ত হওয়া অসামঞ্জস্য এবং যেকোনো ট্রিগার করা সতর্কতা অন্তর্ভুক্ত রয়েছে। সতর্কতাগুলি স্থির এবং অসঙ্গতি সতর্কতা উভয়ই অন্তর্ভুক্ত করতে পারে।

ডিফল্টরূপে, API পূর্ববর্তী ঘন্টার জন্য সমস্ত ইভেন্ট প্রদান করে। একটি ভিন্ন সময়কাল নির্দিষ্ট করার জন্য from এবং to প্যারামিটার ব্যবহার করুন। একটি ভিন্ন সময়কাল নির্দিষ্ট করার জন্য from এবং ক্যোয়ারী প্যারামিটার to ।

উদাহরণস্বরূপ, নিম্নোক্ত API কলটি আগের 12 ঘন্টার জন্য সংগঠন myorg এর সমস্ত ইভেন্ট ফেরত দেয়:

curl -H "Authorization: Bearer $ACCESS_TOKEN" \
"https://apimonitoring.enterprise.apigee.com/metrics/events?org=myorg&from=-12h&to=now"

আপনার OAuth 2.0 অ্যাক্সেস টোকেনে $ACCESS_TOKEN সেট করুন, যেমনটি বর্ণনা করা হয়েছে একটি OAuth 2.0 অ্যাক্সেস টোকেন পান । এই উদাহরণে ব্যবহৃত cURL বিকল্পগুলি সম্পর্কে তথ্যের জন্য, CURL ব্যবহার করুন দেখুন।

পরবর্তী কলটি গত 24 ঘন্টার জন্য একটি মাঝারি প্রান্তিকের সাথে সমস্ত অসঙ্গতি ইভেন্ট ফেরত দেয়:

curl -H "Authorization: Bearer $ACCESS_TOKEN" \
"https://apimonitoring.enterprise.apigee.com/metrics/events?org=myorg&type=anomaly&threshold=moderate&from=-24h&to=now"

এই API-এর জন্য শুধুমাত্র org কোয়েরি প্যারামিটার প্রয়োজন। /metrics/events এ API ডক-এ বর্ণিত ক্যোয়ারী প্যারামের সাথে, এই API অসঙ্গতি সনাক্তকরণ সমর্থন করতে নিম্নলিখিত বিকল্পগুলিকে সমর্থন করে:

নাম বর্ণনা ডিফল্ট
threshold

নির্দিষ্ট থ্রেশহোল্ড দ্বারা ইভেন্টগুলি ফিল্টার করুন: slight , moderate বা severe ৷

আপনি type=anomaly সেট করলেই শুধুমাত্র অনুমোদিত।

 সমস্ত তীব্রতা
type নির্দিষ্ট ধরনের দ্বারা ইভেন্টগুলি ফিল্টার করুন: alert বা anomaly । কমা দ্বারা পৃথক করা তালিকা হিসাবে একাধিক মান নির্দিষ্ট করুন। সব ধরনের