API ব্যবহার করে মেট্রিক্স ডেটা দেখুন

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

API মনিটরিং মেট্রিক্স পেতে নীচে বর্ণিত APIগুলি ব্যবহার করুন৷ মেট্রিক্স হল API মনিটরিং লগগুলিতে থাকা কাঁচা ডেটা থেকে API মনিটরিং দ্বারা একত্রিত ডেটা মান।

নিম্নলিখিত বিভাগগুলি বর্ণনা করে কিভাবে API ব্যবহার করে মেট্রিক্স পরিচালনা করতে হয়।

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

এই উদাহরণগুলিতে ব্যবহৃত cURL বিকল্পগুলি সম্পর্কে তথ্যের জন্য, CURL ব্যবহার করুন দেখুন।

মেট্রিক্স API

মেট্রিক্স এপিআইতে একটি GET অনুরোধ করতে আপনি যে বেস URLটি ব্যবহার করেন তা হল:

https://apimonitoring.enterprise.apigee.com/metrics/resource

যেখানে resource একটি নির্দিষ্ট মেট্রিকের সাথে মিলে যায়। নিম্নলিখিত সারণী মেট্রিক্স সংস্থান তালিকাভুক্ত করে:

সম্পদ বর্ণনা
/traffic ট্রাফিক মেট্রিক্স পান। প্রক্সি নাম, ব্যবধান, টাইম উইন্ডো, টার্গেট, স্ট্যাটাস কোড এবং আরও অনেকের মতো ফিল্টারগুলি নির্দিষ্ট করুন৷
/latency অনুরোধের জন্য লেটেন্সি মেট্রিক্স পান

এজ এবং ব্যাকএন্ড লক্ষ্যে। প্রক্সি নাম, ব্যবধান, টার্গেট, স্ট্যাটাস কোড এবং আরও অনেকের মতো ফিল্টারগুলি নির্দিষ্ট করুন৷

/targets একটি নির্দিষ্ট সংস্থা এবং পরিবেশের জন্য সমস্ত লক্ষ্য ডোমেন পান।
/alerthistory একটি নির্দিষ্ট প্রতিষ্ঠান এবং সময় উইন্ডোর জন্য সতর্কতা ইতিহাস মেট্রিক্স পান।
/alertinstance/ instanceid নির্দিষ্ট সতর্কতার উদাহরণ আইডির জন্য সতর্কতার ইতিহাস মেট্রিক্স পান।
/alertsummary একটি প্রতিষ্ঠান এবং সময় উইন্ডোর জন্য সতর্কতার মোট গণনা পান।
/faultcodenames সব ফল্টকোড নাম পান.
/faultcodes ফল্ট কোড পান.
/faultcodecategories ফল্ট কোড বিভাগ পান.
/faultcodesubcategories ফল্ট কোড উপশ্রেণি পান.
/faultcodedetails বিশদ সহ সমস্ত ফল্ট কোড পান।

ভুল তথ্য পান

/fault* রিসোর্সগুলি এজের সম্ভাব্য ত্রুটি সম্পর্কে মেটাডেটা প্রদান করে। উদাহরণস্বরূপ, সমস্ত সম্ভাব্য দোষ বিভাগের তালিকা দেখতে:

curl -X GET \
"https://apimonitoring.enterprise.apigee.com/metrics/faultcodecategories" \
-H "accept: application/json" \
-H "Authorization: Bearer $ACCESS_TOKEN"

আপনার OAuth 2.0 অ্যাক্সেস টোকেনে $ACCESS_TOKEN সেট করুন, যেমনটি বর্ণনা করা হয়েছে একটি OAuth 2.0 অ্যাক্সেস টোকেন পান ।

প্রতিক্রিয়া হিসাবে প্রদর্শিত হবে:

{
  "faultCodeCategories":[
    "","API Protocol","Developer/App","Extension Policy","Gateway",
    "Mediation Policy","Mint","Security Policy","Sense","Traffic Mgmt Policy"
  ]
}

তারপরে আপনি API Protocol বিভাগের জন্য ফল্ট কোডের তালিকা নির্ধারণ করতে পারেন:

curl -X GET \
"https://apimonitoring.enterprise.apigee.com/metrics/faultcodes?faultCodeCategory=API Protocol" \
-H "accept: application/json" \
-H "Authorization: Bearer $ACCESS_TOKEN"

অতিরিক্ত বিকল্পের জন্য, মেট্রিক্স API দেখুন।

ট্র্যাফিক এবং লেটেন্সির জন্য মেট্রিক্স ক্যাপচার করুন

মেট্রিক্স এপিআই-এর ফিল্টার রয়েছে যা আপনি গণনা করা মেট্রিক্সে কাস্টম টাইম রেঞ্জ, প্রক্সি, অঞ্চল, পরিবেশ এবং অন্যান্য ফিল্টার নির্দিষ্ট করতে API এ প্রয়োগ করতে পারেন। উদাহরণস্বরূপ, সমস্ত পরিবেশের জন্য পূর্ববর্তী ঘন্টার জন্য প্রতি 10 মিনিটে প্রতি সেকেন্ড (tps) মেট্রিক লেনদেন দেখতে:

curl -X GET \
"https://apimonitoring.enterprise.apigee.com/metrics/traffic?from=-1h&to=now&select=tps&interval=10m&groupBy=env&org=myorg" \
-H "accept: application/json"  \
-H "Authorization: Bearer $ACCESS_TOKEN"

আপনার OAuth 2.0 অ্যাক্সেস টোকেনে $ACCESS_TOKEN সেট করুন, যেমনটি বর্ণনা করা হয়েছে একটি OAuth 2.0 অ্যাক্সেস টোকেন পান ।

এই কলটি ফর্মে ফলাফল প্রদান করে:

{
  "results":[
    {
      "series":[
        {
          "name":"proxy",
        "tags":
             {
                "env":"prod",
                "intervalSeconds":"60",
                "org":"myorg",
                "region":"myregion"
              },
            "columns":["time","tps"],
            "values":[
              ["2018-08-15T13:10:00Z",5.03],
              ["2018-08-15T13:20:00Z",5.01],
              ["2018-08-15T13:30:00Z",5.81],
              ["2018-08-15T13:40:00Z",5.95],
              …
            ]
          },
       …
       }
    }]
}

লক্ষ্য করুন কিভাবে columns বৈশিষ্ট্য values বিন্যাস নির্দিষ্ট করে। values বৈশিষ্ট্যে পূর্ববর্তী 10 মিনিটের ব্যবধানের জন্য প্রতি 10 মিনিটে গণনা করা টিপিএস রয়েছে।

interval ক্যোয়ারী প্যারামিটার ফলাফলে মেট্রিক সংরক্ষিত হওয়ার ফ্রিকোয়েন্সি এবং ফলাফলের মানের জন্য স্যাম্পলিং উইন্ডো নির্ধারণ করে। উপরের উদাহরণে, পূর্ববর্তী 10 মিনিটে মেট্রিক গণনা করা হয় এবং প্রতি 10 মিনিটে ফলাফলে লেখা হয়।

একটি ISO ফর্ম্যাট করা সময় পরিসীমা নির্দিষ্ট করতে from এবং to প্যারামিটার ব্যবহার করুন। from এবং to দ্বারা নির্দিষ্ট সর্বোচ্চ সময়কাল হল 24 ঘন্টা৷

তারিখ বিন্যাস হতে পারে:

  • yyyy-mm-dd T hh:mm:ss Z
  • yyyy-mm-dd T hh:mm:ss +00:00

যেমন:

curl -X GET \
"https://apimonitoring.enterprise.apigee.com/metrics/traffic?from=2018-08-13T14%3A04%3A00Z&to=2018-08-13T14%3A10%3A00Z&select=tps&interval=1m&groupBy=env&org=myorg&proxy=PublicAPI" \
-H "accept: application/json"  \
-H "Authorization: Bearer $ACCESS_TOKEN"

অথবা একটি আপেক্ষিক সময় পরিসীমা নির্দিষ্ট করতে from এবং to query প্যারামিটার ব্যবহার করুন, উদাহরণস্বরূপ শেষ ঘন্টার জন্য:

curl -X GET \
"https://apimonitoring.enterprise.apigee.com/metrics/traffic?from=-1h&to=now&select=tps&interval=1m&groupBy=env&org=myorg&proxy=PublicAPI" \
-H "accept: application/json"  \
-H "Authorization: Bearer $ACCESS_TOKEN"

আরেকটি বিকল্প হল একটি একক প্রক্সির জন্য প্রতি সেকেন্ডে (tps) লেনদেন প্রদর্শন করতে proxy ক্যোয়ারী প্যারামিটার ব্যবহার করা:

curl -X GET \
"https://apimonitoring.enterprise.apigee.com/metrics/traffic?from=-1h&to=now&select=tps&interval=1m&groupBy=env&org=myorg&proxy=PublicAPI" \
-H "accept: application/json"  \
-H "Authorization: Bearer $ACCESS_TOKEN"

লেটেন্সি মেট্রিক্সের জন্য, ট্রাফিক মেট্রিক্সের মতো একই মানদণ্ডের অনেকগুলি নির্দিষ্ট করুন৷ যাইহোক, /latency রিসোর্সের জন্য:

  • আপনাকে অবশ্যই percentile কোয়েরি প্যারামিটারটি 50 , 90 , 95 , বা 99 হিসাবে নির্দিষ্ট করতে হবে। উদাহরণস্বরূপ, যদি আপনি 90 উল্লেখ করেন, API 90 তম শতাংশে মোট প্রতিক্রিয়া বিলম্বিত মান প্রদান করে।
  • windowsize এক মিনিটে ঠিক করা হয়।

উদাহরণস্বরূপ, 1 মিনিটের উইন্ডোর জন্য 90 তম শতাংশে মোট লেটেন্সির মেট্রিক্স দেখতে: 

curl -X GET \
"https://apimonitoring.enterprise.apigee.com/metrics/latency?percentile=90&select=totalLatency&from=-1h&to=now&interval=5m&windowsize=1m&groupBy=org,env,region&org=myorg" \
-H "accept: application/json" \
-H "Authorization: Bearer $ACCESS_TOKEN"

অতিরিক্ত বিকল্পের জন্য, মেট্রিক্স API দেখুন।

সতর্কতার জন্য মেট্রিক্স ক্যাপচার করুন

মেট্রিক্স এপিআই সমস্ত সতর্কতার জন্য, একটি নির্দিষ্ট সতর্কতার জন্য বা একটি সতর্কতার সারাংশের জন্য মেট্রিক্স প্রদান করে। উদাহরণস্বরূপ, শেষ ঘন্টার জন্য একটি সংস্থার জন্য সতর্কতা ইতিহাস পেতে: 

curl -X GET \
"https://apimonitoring.enterprise.apigee.com/metrics/alerthistory?org=myorg&from=-1h&to=now" \
-H "accept: application/json" \
-H "Authorization: Bearer $ACCESS_TOKEN"

আপনার OAuth 2.0 অ্যাক্সেস টোকেনে $ACCESS_TOKEN সেট করুন, যেমনটি বর্ণনা করা হয়েছে একটি OAuth 2.0 অ্যাক্সেস টোকেন পান ।

এই API কল ফর্মে একটি প্রতিক্রিয়া প্রদান করে: 

[
  {
"id":"983c4c7a-c301-4697-95cc-9a7c53e05fac",
"organization":"myorg",
"environment":"prod",
"name":"Public Api 5xx error rate",
"type":"Alert",
"source":"https://www.apigee.net/sonar",
"raw_payload":"
{
    \"reportUUID\":\"\",
    \"reportEnabled\":false,
    \"organization\":\"myorg\",
    \"name\":\"Public Api 5xx error rate\",
    \"self\":\"/alerts/95cc9ef4-345f-11e8-9fd3-12774584e062\",
    \"description\":\"\",
    \"conditions\":[
    {
        \"comparator\":\"\u003e\",
        \"metric\":\"rate\",
        \"durationSeconds\":3600,
        \"name\":\"\",
        \"description\":\"\",
        \"threshold\":0.01,
        \"dimensions\":
        {
            \"proxy\":\"myAPI\",
            \"org\":\"myorg\",
            \"env\":\"prod\",
            \"region\":\"myRegion\",
            \"statusCode\":\"5xx\"
            }
        }],
        \"uuid\":\"95cc9ef4-345f-11e8-9fd3-12774584e062\",
    \"playbook\":\"This is a test alert.\"
    }",
"time":"2018-08-14T12:45:28Z"
 },
 …
]

তারপরে আপনি একটি নির্দিষ্ট সতর্কতা সম্পর্কে তথ্য পেতে ফিরে আসা অ্যারেতে id ব্যবহার করতে পারেন: 

curl -X GET \
"https://apimonitoring.enterprise.apigee.com/metrics/alertinstance/983c4c7a-c301-4697-95cc-9a7c53e05fac" \
-H "accept: application/json" \
-H "Authorization: Bearer $ACCESS_TOKEN"

অতিরিক্ত বিকল্পের জন্য, মেট্রিক্স API দেখুন।