API ব্যবহার করে সতর্কতা এবং বিজ্ঞপ্তি পরিচালনা করা

আপনি Apigee Edge-এর ডকুমেন্টেশন দেখছেন।
Apigee X ডকুমেন্টেশন
.info- তে যান।

নিম্নলিখিত বিভাগগুলিতে এপিআই ব্যবহার করে অ্যালার্টগুলি কীভাবে পরিচালনা করতে হয় তা বর্ণনা করা হয়েছে।

অ্যালার্ট এপিআই সম্পর্কে আরও জানতে অ্যালার্ট এপিআই দেখুন।

এপিআই ব্যবহার করে অ্যালার্ট এবং নোটিফিকেশন সেট আপ করুন

নিম্নলিখিত রিসোর্সে একটি POST অনুরোধ পাঠিয়ে অ্যালার্ট এবং নোটিফিকেশন সেট আপ করুন: https://apimonitoring.enterprise.apigee.com/alerts

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

এপিআই ব্যবহার করে একটি এপিআই প্রক্সির জন্য 5xx স্ট্যাটাস কোড অ্যালার্ট সেট আপ করুন।

নিম্নলিখিত উদাহরণটি দেখায় কিভাবে এমন একটি অ্যালার্ট সেট আপ করতে হয় যা যেকোনো অঞ্চলের প্রোডাকশন এনভায়রনমেন্টে হোটেল এপিআই প্রক্সির জন্য, ১০ মিনিট ধরে প্রতি সেকেন্ডে ১০০টির (TPS) বেশি ট্রানজ্যাকশন হারে 5xx স্ট্যাটাস কোড ঘটলে ট্রিগার হয়। অ্যালার্টটি ট্রিগার হলে নির্দিষ্ট ইমেল ঠিকানায় একটি নোটিফিকেশন পাঠানো হয়।

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 Alert",
     "description":"My 5xx alert",
     "environment":"prod",
     "enabled":true,
     "conditions":[
     {
        "description":"",
        "dimensions":{
            "org":"myorg", 
            "env":"prod", 
            "proxy":"hotels",
            "region":"ANY",
            "statusCode":"5xx"
        },
        "metric":"tps",
        "threshold":100,
        "durationSeconds":600,
        "comparator":">"
     }
     ],
     "notifications":[{ 
         "channel":"email", 
         "destination":"ops@acme.com"
     }],
     "playbook":"http://acme.com/myplaybook.html",
     "throttleIntervalSeconds":3600,
     "reportEnabled":true
    }'

“OAuth 2.0 অ্যাক্সেস টোকেন সংগ্রহ করুন” অংশে বর্ণিত পদ্ধতি অনুসারে, আপনার OAuth 2.0 অ্যাক্সেস টোকেনটি $ACCESS_TOKEN এ সেট করুন।

এই উদাহরণে ব্যবহৃত cURL অপশনগুলো সম্পর্কে জানতে, Use cURL দেখুন।

এপিআই ব্যবহার করে একটি এপিআই প্রক্সির জন্য ৯৫তম পার্সেন্টাইল লেটেন্সি অ্যালার্ট সেট আপ করুন।

নিম্নলিখিত উদাহরণটি দেখায় কিভাবে এমন একটি অ্যালার্ট সেট আপ করতে হয় যা যেকোনো অঞ্চলের জন্য প্রোডাকশন এনভায়রনমেন্টে হোটেল এপিআই প্রক্সির ক্ষেত্রে, ৯৫তম পার্সেন্টাইলের মোট রেসপন্স ল্যাটেন্সি টানা ৫ মিনিট ধরে ১০০ মিলিসেকেন্ডের বেশি হলে ট্রিগার হবে।

অ্যালার্টটি ট্রিগার হলে নির্দিষ্ট ওয়েবহুকে একটি নোটিফিকেশন পাঠানো হয়।

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 Alert",
     "description":"My first alert",
     "environment":"prod",
     "enabled":true,
     "conditions":[
     {
        "description":"",
        "dimensions":{
            "org":"myorg", 
            "env":"prod",
            "proxy" : "hotels",
            "region":"ANY",
            "percentile":"95"
        },
        "metric":"totalLatency",
        "threshold":100,
        "durationSeconds":300,
        "comparator":">"
     }
     ],
     "notifications":[{ "channel":"webhook", "destination":"https://apigee.com/test-webhook"}],
     "playbook":"http://acme.com/myplaybook.html",
     "throttleIntervalSeconds":3600,
     "reportEnabled":true
}'

“OAuth 2.0 অ্যাক্সেস টোকেন সংগ্রহ করুন” অংশে বর্ণিত পদ্ধতি অনুসারে, আপনার OAuth 2.0 অ্যাক্সেস টোকেনটি $ACCESS_TOKEN এ সেট করুন।

এই উদাহরণে ব্যবহৃত cURL অপশনগুলো সম্পর্কে জানতে, Use cURL দেখুন।

এপিআই ব্যবহার করে সকল এপিআই প্রক্সির জন্য একটি ৪০৪ (অ্যাপ্লিকেশন পাওয়া যায়নি) স্ট্যাটাস কোড অ্যালার্ট সেট আপ করুন।

নিম্নলিখিত উদাহরণটি দেখায় কিভাবে এমন একটি অ্যালার্ট সেট আপ করতে হয় যা যেকোনো অঞ্চলের প্রোডাকশন এনভায়রনমেন্টের সমস্ত এপিআই প্রক্সির জন্য টানা ৫ মিনিট ধরে ১০%-এর বেশি হারে HTTP 404 স্ট্যাটাস কোড দেখা দিলে ট্রিগার হবে।

অ্যালার্টটি সক্রিয় হলে নির্দিষ্ট স্ল্যাক চ্যানেলে একটি নোটিফিকেশন পাঠানো হয়।

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":"404 Application Not Found Alert",
     "description":"My 404 alert",
     "environment":"prod",
     "enabled":true,
     "conditions":[
     {
        "description":"",
        "dimensions":{"org":"myorg", 
            "env":"prod", 
            "proxy":"ALL",
            "region":"ANY",
            "statusCode":"404"},
        "metric":"rate",
        "threshold":0.05,
        "durationSeconds":300,
        "comparator":">"
     }],
     "notifications":[{ "channel":"slack", "destination":"https://hooks.slack.com/services/T00000000/B00000000/XXXXX"}],
     "playbook":"http://acme.com/myplaybook.html",
     "throttleIntervalSeconds":3600,
     "reportEnabled":true
}'

“OAuth 2.0 অ্যাক্সেস টোকেন সংগ্রহ করুন” অংশে বর্ণিত পদ্ধতি অনুসারে, আপনার OAuth 2.0 অ্যাক্সেস টোকেনটি $ACCESS_TOKEN এ সেট করুন।

এই উদাহরণে ব্যবহৃত cURL অপশনগুলো সম্পর্কে জানতে, Use cURL দেখুন।

এপিআই ব্যবহার করে এপিআইগুলির জন্য একটি এপিআই প্রক্সি গণনা সতর্কতা সেট আপ করুন

যেকোনো অঞ্চলের জন্য এপিআই-এর 5xx কোডের সংখ্যা টানা ৫ মিনিট ধরে ২০০ ছাড়িয়ে গেলে যে অ্যালার্টটি ট্রিগার হবে, তা সেট আপ করার একটি উদাহরণ নিচে দেওয়া হলো।

এই উদাহরণে, API-গুলো Critical API Proxies কালেকশনে ধারণ করা হয়েছে (যার UUID হলো aeff4394-86b7-11e8-83d7-42010a840040)। কোনো কালেকশনের UUID পেতে, “View all collections using the 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":"Proxy Count Alert",
     "description":"My proxy count alert",
     "environment":"prod",
     "enabled":true,
     "conditions":[
     {
        "description":"",
        "dimensions":{
            "collection":"aeff4394-86b7-11e8-83d7-42010a840040",
            "org":"myorg", 
            "env":"prod",
            "proxy" : "ANY",
            "region":"ANY",
            "statusCode":"5xx"
        },
        "metric":"count",
        "threshold":200,
        "durationSeconds":300,
        "comparator":">"
     }
     ],
     "notifications":[{ 
         "channel":"email", 
         "destination":"ops@acme.com"
     }],
     "playbook":"http://acme.com/myplaybook.html",
     "throttleIntervalSeconds":3600,
     "reportEnabled":true
    }'

“OAuth 2.0 অ্যাক্সেস টোকেন সংগ্রহ করুন” অংশে বর্ণিত পদ্ধতি অনুসারে, আপনার OAuth 2.0 অ্যাক্সেস টোকেনটি $ACCESS_TOKEN এ সেট করুন।

এই উদাহরণে ব্যবহৃত cURL অপশনগুলো সম্পর্কে জানতে, Use cURL দেখুন।

এপিআই ব্যবহার করে টার্গেট সার্ভিসগুলোর জন্য একটি এরর রেট অ্যালার্ট সেট আপ করুন।

যেকোনো অঞ্চলের জন্য নির্দিষ্ট পরিষেবাগুলোর ৫০০ কোড রেট ১ ঘণ্টা ধরে ১০% অতিক্রম করলে যে অ্যালার্টটি চালু হবে, তা সেট আপ করার একটি উদাহরণ নিচে দেওয়া হলো।

এই উদাহরণে, টার্গেট সার্ভিসগুলো Critical targets কালেকশনে (UUID aeff4394-86b7-11e8-83d7-42010a840040 সহ) ক্যাপচার করা হয়েছে। কোনো কালেকশনের UUID পেতে, View all collections using the 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":"Error rate Alert",
     "description":"My error rate alert",
     "environment":"prod",
     "enabled":true,
     "conditions":[
     {
        "description":"",
        "dimensions":{
            "collection":"aeff4394-86b7-11e8-83d7-42010a840040",
            "org":"myorg", 
            "env":"prod",
            "proxy" : "ANY",
            "region":"ANY",
            "statusCode":"500"
        },
        "metric":"rate",
        "threshold":0.1,
        "durationSeconds":3600,
        "comparator":">"
     }
     ],
     "notifications":[{ 
         "channel":"email", 
         "destination":"ops@acme.com"
     }],
     "playbook":"http://acme.com/myplaybook.html",
     "throttleIntervalSeconds":3600,
     "reportEnabled":true
    }'

“OAuth 2.0 অ্যাক্সেস টোকেন সংগ্রহ করুন” অংশে বর্ণিত পদ্ধতি অনুসারে, আপনার OAuth 2.0 অ্যাক্সেস টোকেনটি $ACCESS_TOKEN এ সেট করুন।

এই উদাহরণে ব্যবহৃত cURL অপশনগুলো সম্পর্কে জানতে, Use cURL দেখুন।

এপিআই ব্যবহার করে সার্ভিস কলআউট পলিসির জন্য একটি এরর রেট অ্যালার্ট সেট আপ করুন।

যেকোনো অঞ্চলের জন্য ServiceCallout পলিসি দ্বারা নির্দিষ্ট পরিষেবার 500 কোড রেট ১ ঘন্টা ধরে ১০% অতিক্রম করলে যে অ্যালার্টটি ট্রিগার হবে, তা সেট আপ করার একটি উদাহরণ নিচে দেওয়া হলো।

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":"Error rate Alert",
     "description":"My error rate alert",
     "environment":"prod",
     "enabled":true,
     "conditions":[
     {
        "description":"",
        "dimensions":{
            "target": "sc://docstore-api",
            "org":"myorg", 
            "env":"prod",
            "proxy" : "ANY",
            "region":"ANY",
            "statusCode":"500"
        },
        "metric":"rate",
        "threshold":0.1,
        "durationSeconds":3600,
        "comparator":">"
     }
     ],
     "notifications":[{ 
         "channel":"email", 
         "destination":"ops@acme.com"
     }],
     "playbook":"http://acme.com/myplaybook.html",
     "throttleIntervalSeconds":3600,
     "reportEnabled":true
    }'

“OAuth 2.0 অ্যাক্সেস টোকেন সংগ্রহ করুন” অংশে বর্ণিত পদ্ধতি অনুসারে, আপনার OAuth 2.0 অ্যাক্সেস টোকেনটি $ACCESS_TOKEN এ সেট করুন।

এই উদাহরণে ব্যবহৃত cURL অপশনগুলো সম্পর্কে জানতে, Use cURL দেখুন।

এপিআই ব্যবহার করে একটি পলিসি ফল্ট কোড অ্যালার্ট সেট আপ করুন।

নিম্নলিখিত উদাহরণটি দেখায় কিভাবে এমন একটি অ্যালার্ট সেট আপ করতে হয় যা নিম্নলিখিত শর্তগুলির মধ্যে যেকোনো একটি পূরণ হলে ট্রিগার হবে:

  • যেকোনো অঞ্চলের প্রোডাকশন এনভায়রনমেন্টের এপিআইগুলোর জন্য SpikeArrestViolation ফল্ট কোডের সংখ্যা ৫ মিনিট ধরে ১০-এর বেশি।
  • যেকোনো অঞ্চলের প্রোডাকশন এনভায়রনমেন্টের এপিআইগুলোর ক্ষেত্রে সমস্ত এপিআই প্রোটোকল ফল্ট কোডের সংখ্যা টানা ৫ মিনিট ধরে ৩%-এর বেশি।

এই উদাহরণে, API-গুলো Critical API Proxies কালেকশনে ধারণ করা হয়েছে (যার UUID হলো aeff4394-86b7-11e8-83d7-42010a840040)। কোনো কালেকশনের UUID পেতে, “View all collections using the API” দেখুন।

অ্যালার্টটি ট্রিগার হলে নির্দিষ্ট PagerDuty কোডে একটি নোটিফিকেশন পাঠানো হয়।

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 Fault Code Alert",
     "description":"My fault code alert",
     "environment":"prod",
     "enabled":true,
     "conditions":[
     {
        "description":"",
        "dimensions": { 
            "collection":"aeff4394-86b7-11e8-83d7-42010a840040",
            "org":"myorg",
            "env":"prod",
            "proxy":"ANY",
            "region":"ANY",
            "faultCodeCategory":"Traffic Mgmt Policy",
            "faultCodeSubCategory":"Spike Arrest",
            "faultCodeName":"SpikeArrest Violation"
        },
        "metric":"count,
        "threshold":10,
        "durationSeconds":300,
        "comparator":">"
     },
     {
       "description":"",
       "dimensions": { 
           "collection":"aeff4394-86b7-11e8-83d7-42010a840040",
           "org":"myorg",
           "env":"prod",
           "proxy":"ANY",
           "region":"ANY",
           "faultCodeCategory":"API Protocol",
           "faultCodeSubCategory":"ALL"
       },
       "metric":"rate",
       "threshold":0.03,
       "durationSeconds":300,
       "comparator":">"
     }   
     ],
     "notifications":[{ "channel":"pagerduty", "destination":"abcd1234efgh56789"}],
     "playbook":"http://acme.com/myplaybook.html",
     "throttleIntervalSeconds":3600,
     "reportEnabled":true
}'

“OAuth 2.0 অ্যাক্সেস টোকেন সংগ্রহ করুন” অংশে বর্ণিত পদ্ধতি অনুসারে, আপনার OAuth 2.0 অ্যাক্সেস টোকেনটি $ACCESS_TOKEN এ সেট করুন।

এই উদাহরণে ব্যবহৃত cURL অপশনগুলো সম্পর্কে জানতে, Use cURL দেখুন।

সতর্কতা এবং বিজ্ঞপ্তিগুলি দেখুন

নিম্নলিখিত বিভাগগুলিতে এপিআই ব্যবহার করে অ্যালার্টের সংজ্ঞা এবং ট্রিগার হওয়া অ্যালার্ট সম্পর্কিত তথ্য দেখার উদাহরণ দেওয়া হয়েছে:

একটি সংস্থার জন্য সমস্ত সতর্কতা সংজ্ঞা দেখুন

নিম্নলিখিত API-তে একটি GET অনুরোধ পাঠিয়ে সমস্ত অ্যালার্ট এবং নোটিফিকেশন সংজ্ঞা দেখুন: https://apimonitoring.enterprise.apigee.com/alerts

আপনাকে অবশ্যই org কোয়েরি প্যারামিটার ব্যবহার করে আপনার প্রতিষ্ঠানের নাম উল্লেখ করতে হবে।

উদাহরণস্বরূপ:

curl 'https://apimonitoring.enterprise.apigee.com/alerts?org=myorg'
    -X GET
    -H 'Accept: application/json, text/plain, */*'
    -H "Authorization: Bearer $ACCESS_TOKEN"    

অ্যালার্টের UUID-টি রেসপন্সের uuid ফিল্ডে দেখানো হয়। কোনো অ্যালার্ট ডেফিনিশনের নির্দিষ্ট তথ্য জানার জন্য কল করতে আপনার এই UUID-টি প্রয়োজন। নিচে রেসপন্সের একটি উদাহরণ দেওয়া হলো:

[ 
 {
    "uuid": "4fa49a87-3463023ea7c4",
    "name": "PublicAPI latency alert",
    "enabled": true,
    "description": "Public API Latency alerts, 90th %ile > 6secs for 5 minute window trigger this alert",
    "conditions": [
      {
        "uuid": "4fa49a87-3463023ea7c4",
        "description": "",
        "dimensions": {
          "env": "prod",
          "org": "myorg",
          "percentile": "90",
          "proxy": "PublicAPI",
          "region": "ANY"
        },
        "metric": "totalLatency",
        "threshold": 6000,
        "durationSeconds": 300,
        "comparator": ">",
        "updatedBy": "me@foo.com"
      }
    ],
    "playbook": "PublicAPI Latency alert, setup to go off when 90th %ile is > 4 secs for 5 minute window",
    "throttleIntervalSeconds": 3600,
    "self": "/alerts/4fa49a87-3463023ea7c4",
    "feed": "/o/myorg/events/4fa49a87-3463023ea7c4",
    "organization": "myorg",
    "environment": "prod",
    "notifications": [
      {
        "channel": "email",
        "destination": "me@foo.com"
      }
    ],
    "updatedAt": "2018-07-19T18:19:31.654738Z",
    "updatedBy": "me@foo.com"
  },
  {
    "uuid": "ef1a5249-345ed3023ea7c4",
    "name": "Minty API Latency alert",
    "enabled": true,
    "description": "Minty API Latency alerts, 90th %ile > 6secs for 5 minute window trigger this alert",
    "conditions": [
      {
        "uuid": "ef1a5249-345ed3023ea7c4",
        "description": "",
        "dimensions": {
          "env": "prod",
          "org": "myorg",
          "percentile": "90",
          "proxy": "minty",
          "region": "ANY"
        },
        "metric": "totalLatency",
        "threshold": 6000,
        "durationSeconds": 300,
        "comparator": ">",
        "updatedBy": "me@foo.com"
      }
    ],
    "playbook": "Minty API",
    "throttleIntervalSeconds": 3600,
    "self": "/alerts/ef1a5249-345ed3023ea7c4",
    "feed": "/o/myorg/events/ef1a5249-345ed3023ea7c4",
    "organization": "myorg",
    "environment": "prod",
    "notifications": [
      {
        "channel": "email",
        "destination": "me@foo.com"
      }
    ],
    "updatedAt": "2018-07-19T18:19:33.22479Z",
    "updatedBy": "me@foo.com"
  },
 ...
]

“OAuth 2.0 অ্যাক্সেস টোকেন সংগ্রহ করুন” অংশে বর্ণিত পদ্ধতি অনুসারে, আপনার OAuth 2.0 অ্যাক্সেস টোকেনটি $ACCESS_TOKEN এ সেট করুন।

এই উদাহরণে ব্যবহৃত cURL অপশনগুলো সম্পর্কে জানতে, Use cURL দেখুন।

একটি নির্দিষ্ট সতর্কতা সংজ্ঞা দেখুন

একটি নির্দিষ্ট অ্যালার্ট ডেফিনিশন দেখতে, নিম্নলিখিত রিসোর্সে একটি GET রিকোয়েস্ট পাঠান: https://apimonitoring.enterprise.apigee.com/alerts/alert_uuid alert_uuid যেখানে alert_uuid অ্যালার্ট ডেফিনিশনটির UUID নির্দেশ করে। অ্যালার্ট তৈরি করার সময় UUID-টি সংগ্রহ করুন অথবা সমস্ত অ্যালার্ট এবং তাদের সংশ্লিষ্ট UUID তালিকাভুক্ত করতে পূর্ববর্তী বিভাগে দেখানো API কলটি ব্যবহার করুন।

উদাহরণস্বরূপ:

curl 'https://apimonitoring.enterprise.apigee.com/alerts/4fa49a87-3463023ea7c4'
    -X GET
    -H 'Accept: application/json, text/plain, */*'
    -H "Authorization: Bearer $ACCESS_TOKEN"    

নিম্নলিখিতটি প্রতিক্রিয়ার একটি উদাহরণ:

  {
    "uuid": "4fa49a87-3463023ea7c4",
    "name": "PublicAPI latency alert",
    "enabled": true,
    "description": "Public API Latency alerts, 90th %ile > 6secs for 5 minute window trigger this alert",
    "conditions": [
      {
        "uuid": "4fa49a87-3463023ea7c4",
        "description": "",
        "dimensions": {
          "env": "prod",
          "org": "myorg",
          "percentile": "90",
          "proxy": "PublicAPI",
          "region": "ANY"
        },
        "metric": "totalLatency",
        "threshold": 6000,
        "durationSeconds": 300,
        "comparator": ">",
        "updatedBy": "me@foo.com"
      }
    ],
    "playbook": "PublicAPI Latency alert, setup to go off when 90th %ile is > 4 secs for 5 minute window",
    "throttleIntervalSeconds": 3600,
    "self": "/alerts/4fa49a87-3463023ea7c4",
    "feed": "/o/myorg/events/4fa49a87-3463023ea7c4",
    "organization": "myorg",
    "environment": "prod",
    "notifications": [
      {
        "channel": "email",
        "destination": "me@foo.com"
      }
    ],
    "updatedAt": "2018-07-19T18:19:31.654738Z",
    "updatedBy": "me@foo.com"
  }

“OAuth 2.0 অ্যাক্সেস টোকেন সংগ্রহ করুন” অংশে বর্ণিত পদ্ধতি অনুসারে, আপনার OAuth 2.0 অ্যাক্সেস টোকেনটি $ACCESS_TOKEN এ সেট করুন।

এই উদাহরণে ব্যবহৃত cURL অপশনগুলো সম্পর্কে জানতে, Use cURL দেখুন।

একটি সংস্থার জন্য সক্রিয় হওয়া সমস্ত সতর্কতার ইতিহাস দেখুন

একটি অর্গের জন্য ট্রিগার হওয়া সমস্ত অ্যালার্টের ইতিহাস দেখতে, নিম্নলিখিত রিসোর্সে একটি GET অনুরোধ পাঠান: https://apimonitoring.enterprise.apigee.com/metrics/alerthistory

আপনাকে অবশ্যই ` org কোয়েরি প্যারামিটার ব্যবহার করে আপনার প্রতিষ্ঠানের নাম উল্লেখ করতে হবে। আপনি চাইলে ট্রিগার হওয়া অ্যালার্টগুলো খোঁজার জন্য একটি সময়কাল নির্দিষ্ট করে দিতে পারেন। ডিফল্টভাবে, এটি গত এক ঘণ্টার মধ্যে ট্রিগার হওয়া সমস্ত অ্যালার্ট ফেরত দেয়।

উদাহরণস্বরূপ:

curl 'https://apimonitoring.enterprise.apigee.com/metrics/alerthistory?org=myorg'
    -X GET
    -H 'Accept: application/json, text/plain, */*'
    -H "Authorization: Bearer $ACCESS_TOKEN"    

প্রতিক্রিয়াটিতে অনুরোধকৃত সময়কালে ট্রিগার হওয়া সমস্ত অ্যালার্টের একটি অ্যারে থাকে। প্রতিক্রিয়া বডিতে, ' id ফিল্ডটি ট্রিগার হওয়া অ্যালার্টের UUID নির্দিষ্ট করে, এবং shared_id ফিল্ডটি ট্রিগার হওয়া অ্যালার্টের সাথে যুক্ত অ্যালার্ট ডেফিনিশনের UUID নির্দিষ্ট করে।

নিম্নে প্রতিক্রিয়াটির একটি উদাহরণ দেওয়া হলো।

[
  {
    "id": "80cbe560-f6e0-475c6f7ed2d",
    "shared_id": "4fa49a87-3463023ea7c4",
    "organization": "myorg",
    "environment": "prod",
    "name": "PublicAPI latency alert",
    "type": "Alert",
    "source": "null/current",
    "raw_payload": "{\"reportUUID\":\"\",\"reportEnabled\":false,\"organization\":\"myorg\",\"name\":\"emgmt-api 404\",\"self\":\"/alerts/4fa49a87-3463023ea7c4\",\"description\":\"go/apigee-extensions-playbook\",\"conditions\":[
  {\"comparator\":\">\",\"metric\":\"rate\",\"durationSeconds\":300,\"name\":\"PublicAPI latency alert\",\"description\":\"\",\"threshold\":0.05,\"dimensions\":{\"proxy\":\"emgmt-api\",\"org\":\"myorg\",\"env\":\"prod\",\"region\":\"any\",\"statusCode\":\"404\"}}],\"uuid\":\"4fa49a87-3463023ea7c4\",\"playbook\":\"go/apigee-extensions-playbook\"}",
    "time": "2019-03-25T15:30:18Z"
  },
  {
    "id": "8131d740-6680-45b9c72c3",
    "shared_id": "1a64885b-f9-42010a850039",
    "organization": "apigee-pinpoint",
    "environment": "prod",
    "name": "Demo 5xx alert",
    "type": "Alert",
    "source": "null/current",
    "raw_payload": "{\"reportUUID\":\"\",\"reportEnabled\":false,\"organization\":\"myorg\",\"name\":\"Demo 5xx alert\",\"self\":\"/alerts/1a64885b-f9-42010a850039\",\"description\":\"Demo 5xx alert\",\"conditions\":[
  {\"comparator\":\">\",\"metric\":\"rate\",\"durationSeconds\":300,\"name\":\"Demo 5xx alert\",\"description\":\"\",\"threshold\":0.4,\"dimensions\":{\"proxy\":\"ALL\",\"org\":\"myorg\",\"env\":\"prod\",\"region\":\"any\",\"statusCode\":\"5xx\"}}],\"uuid\":\"1a64885b-f9-42010a850039\",\"playbook\":\"Recommended Playbook\"}",
    "time": "2019-03-25T15:57:30Z"
  },
 ...
]

“OAuth 2.0 অ্যাক্সেস টোকেন সংগ্রহ করুন” অংশে বর্ণিত পদ্ধতি অনুসারে, আপনার OAuth 2.0 অ্যাক্সেস টোকেনটি $ACCESS_TOKEN এ সেট করুন।

এই উদাহরণে ব্যবহৃত cURL অপশনগুলো সম্পর্কে জানতে, Use cURL দেখুন।

নির্দিষ্ট সতর্কতার ইতিহাস দেখুন

একটি নির্দিষ্ট অ্যালার্ট ডেফিনিশনের জন্য ট্রিগার হওয়া অ্যালার্টের ইতিহাস দেখতে, নিম্নলিখিত রিসোর্সে একটি GET রিকোয়েস্ট পাঠান: https://apimonitoring.enterprise.apigee.com/metrics/alerthistory

আপনাকে অবশ্যই ` org কোয়েরি প্যারামিটার ব্যবহার করে আপনার প্রতিষ্ঠানের নাম এবং অ্যালার্ট ডেফিনিশনের UUID প্রদান করতে হবে। আপনি ঐচ্ছিকভাবে অ্যালার্ট অনুসন্ধানের জন্য একটি সময়কাল নির্দিষ্ট করতে পারেন। ডিফল্টভাবে, এটি গত এক ঘণ্টার মধ্যে ট্রিগার হওয়া সমস্ত অ্যালার্ট ফেরত দেয়।

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

উদাহরণস্বরূপ:

curl 'https://apimonitoring.enterprise.apigee.com/metrics/alerthistory?org=myorg&alertId=4fa49a87-3463023ea7c4'
    -X GET
    -H 'Accept: application/json, text/plain, */*'
    -H "Authorization: Bearer $ACCESS_TOKEN"    

প্রতিক্রিয়াটিতে নির্দিষ্ট অ্যালার্ট ডেফিনিশন UUID-এর জন্য অনুরোধ করা সময়কালে ট্রিগার হওয়া সমস্ত অ্যালার্টের একটি অ্যারে থাকে। প্রতিক্রিয়া বডিতে, ' id ফিল্ডটি ট্রিগার হওয়া অ্যালার্টের UUID নির্দিষ্ট করে, এবং shared_id ফিল্ডটি ট্রিগার হওয়া অ্যালার্টের সাথে যুক্ত অ্যালার্ট ডেফিনিশনের UUID নির্দিষ্ট করে।

নিম্নে প্রতিক্রিয়াটির একটি উদাহরণ দেওয়া হলো।

[
  {
    "id": "80cbe560-f6e0-475c6f7ed2d",
    "shared_id": "4fa49a87-3463023ea7c4",
    "organization": "myorg",
    "environment": "prod",
    "name": "PublicAPI latency alert",
    "type": "Alert",
    "source": "null/current",
    "raw_payload": "{\"reportUUID\":\"\",\"reportEnabled\":false,\"organization\":\"myorg\",\"name\":\"emgmt-api 404\",\"self\":\"/alerts/4fa49a87-3463023ea7c4\",\"description\":\"go/apigee-extensions-playbook\",\"conditions\":[
  {\"comparator\":\">\",\"metric\":\"rate\",\"durationSeconds\":300,\"name\":\"PublicAPI latency alert\",\"description\":\"\",\"threshold\":0.05,\"dimensions\":{\"proxy\":\"emgmt-api\",\"org\":\"myorg\",\"env\":\"prod\",\"region\":\"any\",\"statusCode\":\"404\"}}],\"uuid\":\"4fa49a87-3463023ea7c4\",\"playbook\":\"go/apigee-extensions-playbook\"}",
    "time": "2019-03-25T15:30:18Z"
  },
  {
    "id": "9fc442d5-d607-40ef118c4e7",
    "shared_id": "4fa49a87-3463023ea7c4",
    "organization": "myorg",
    "environment": "prod",
    "name": "PublicAPI latency alert",
    "type": "Alert",
    "source": "null/current",
    "raw_payload": "{\"reportUUID\":\"\",\"reportEnabled\":false,\"organization\":\"myorg\",\"name\":\"emgmt-api 404\",\"self\":\"/alerts/4fa49a87-3463023ea7c4\",\"description\":\"go/apigee-extensions-playbook\",\"conditions\":[{\"comparator\":\">\",\"metric\":\"rate\",\"durationSeconds\":300,\"name\":\"PublicAPI latency alert\",\"description\":\"\",\"threshold\":0.05,\"dimensions\":{\"proxy\":\"emgmt-api\",\"org\":\"myorg\",\"env\":\"prod\",\"region\":\"any\",\"statusCode\":\"404\"}}],\"uuid\":\"4fa49a87-3463023ea7c4\",\"playbook\":\"go/apigee-extensions-playbook\"}",
    "time": "2019-03-25T15:17:55Z"
  },
 ...
]

“OAuth 2.0 অ্যাক্সেস টোকেন সংগ্রহ করুন” অংশে বর্ণিত পদ্ধতি অনুসারে, আপনার OAuth 2.0 অ্যাক্সেস টোকেনটি $ACCESS_TOKEN এ সেট করুন।

এই উদাহরণে ব্যবহৃত cURL অপশনগুলো সম্পর্কে জানতে, Use cURL দেখুন।