ट्रैफ़िक से जुड़ी सूचनाएं सेट अप करना

आपको Apigee Edge दस्तावेज़ दिख रहा है.
अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया है इस पेज पर जाएं Apigee X दस्तावेज़. जानकारी

बढ़ाने के लिए किसी ट्रैफ़िक सूचना का इस्तेमाल करें किसी एनवायरमेंट, प्रॉक्सी या इलाके के ट्रैफ़िक में तय प्रतिशत तक बदलाव होने पर मिलने वाली सूचना समय सीमा में रखा हुआ है.

आपने समयावधि को इस पर सेट किया है:

• 1 घंटा
• 1 दिन
• 7 दिन
• 15 दिन (सिर्फ़ एपीआई के लिए)
• 30 दिन (सिर्फ़ एपीआई के लिए)

इस अलर्ट के काम करने के लिए, मौजूदा समयसीमा के ट्रैफ़िक की तुलना, पिछली समयसीमा के ट्रैफ़िक से की जाती है. उदाहरण के लिए, आपने एक घंटे की समयसीमा तय की है. इसके बाद अलर्ट सबसे हाल के घंटे के ट्रैफ़िक की तुलना करता है ट्रैफ़िक के पिछले घंटे के ट्रैफ़िक की तुलना में, ट्रैफ़िक के प्रतिशत में हुए बदलाव का हिसाब लगाने के लिए:

percentChange = ((currentTraffic - previousTraffic) / previousTraffic) * 100

पॉज़िटिव वैल्यू का मतलब है कि ट्रैफ़िक में बढ़ोतरी हुई और नेगेटिव वैल्यू का मतलब है कि ट्रैफ़िक में कमी आई.

इसके बाद, एपीआई ट्रैफ़िक में प्रतिशत के हिसाब से बढ़ोतरी या कमी के तौर पर, ट्रैफ़िक अलर्ट को ट्रिगर करने वाला थ्रेशोल्ड सेट किया जाता है किसी खास समयावधि के लिए लागू होता है.

प्रतिशत को सेट करने से पहले, पक्का करें कि यह आपके सामान्य प्रतिशत से मेल खाता हो ट्रैफ़िक पैटर्न के बारे में ज़्यादा जानें. उदाहरण के लिए, अगर आपके एपीआई ट्रैफ़िक में हर घंटे के ट्रैफ़िक में 100% तक बढ़ोतरी होने पर, आम तौर पर दिन भर में उतार-चढ़ाव होता है अगर ऐसा होता है, तो धड़कन की दर में उतार-चढ़ाव होना आम बात है. इसलिए, आपको किसी तरह की चेतावनी नहीं मिलनी चाहिए. हालांकि, अगर इसके बाद, हर घंटे के ट्रैफ़िक में 50% की बढ़ोतरी को ट्रिगर करने के लिए, अलर्ट को कॉन्फ़िगर किया जाता है, आपको सामान्य ट्रैफ़िक के लिए गै़र-ज़रूरी सूचनाएं मिलेंगी.

सूचनाओं के बारे में ज़्यादा जानने के लिए, सूचनाएं और सूचनाएं सेट अप करना लेख पढ़ें.

ट्रैफ़िक अलर्ट और नोटिफ़िकेशन जोड़ें

ट्रैफ़िक सूचनाएं और सूचनाएं जोड़ने के लिए:

1. विश्लेषण करें > पर क्लिक करें Edge के यूज़र इंटरफ़ेस (यूआई) में सूचना के नियम.
2. +सूचना पर क्लिक करें.
3. अलर्ट के बारे में, यहां दी गई सामान्य जानकारी डालें:

   फ़ील्ड	ब्यौरा
   सूचना का नाम	सूचना का नाम. ऐसे नाम का इस्तेमाल करें जिससे ट्रिगर के बारे में जानकारी मिले और जो आपके लिए काम का हो. नाम में 128 से ज़्यादा वर्ण नहीं हो सकते.
   ब्यौरा	सूचना के बारे में जानकारी.
   अलर्ट प्रकार	कुल ट्रैफ़िक को चुनें. यहां जाएं: ज़्यादा जानने के लिए, अलग-अलग तरह की सूचनाओं के बारे में जानकारी.
   परिवेश	ड्रॉप-डाउन सूची से एनवायरमेंट चुनें.
   स्थिति	सूचना पाने की सुविधा को चालू या बंद करने के लिए टॉगल करें.

4. उस शर्त के लिए थ्रेशोल्ड और डाइमेंशन तय करें जो सूचना को ट्रिगर करेगी.

   शर्त वाला फ़ील्ड	ब्यौरा
   गड़बड़ियों की ज़्यादा से ज़्यादा संख्या	जब ट्रैफ़िक बढ़ोतरी हो जाए, तो सूचना दें या पिछली समयावधि की तुलना में एक खास प्रतिशत घट गई है. बढ़ी हुई वैल्यू प्रतिशत को 0% या उससे ज़्यादा पर सेट करें. इतना घटाएं प्रतिशत को 0% या उससे ज़्यादा पर सेट करें, और 100% से कम या इसके बराबर होना चाहिए. इसके लिए, इनमें से कोई समयावधि चुनी जा सकती है: 1 घंटा 1 दिन एक हफ़्ता
   डाइमेंशन	+डाइमेंशन जोड़ें पर क्लिक करें. इसके बाद, उस डाइमेंशन की जानकारी दें जिसके लिए आपको नतीजे देने हैं. इसमें ये भी शामिल हैं API प्रॉक्सी और क्षेत्र को चुनें. कोई खास डाइमेंशन यहां सेट करें: प्रॉक्सी - किसी खास प्रॉक्सी या सभी प्रॉक्सी पर सेट करें. प्रॉक्सी फ़ंक्शन में "कोई भी" वैल्यू इस्तेमाल नहीं की जा सकती. इसके बजाय तो अपनी पसंद के हर प्रॉक्सी के लिए अलग-अलग सूचना जोड़ी जा सकती है. क्षेत्र - किसी खास इलाके या सभी इलाकों पर सेट करें. Region के लिए "कोई" वैल्यू इस्तेमाल नहीं की जा सकती. इसके बजाय तो हर उस इलाके के लिए अलग से सूचना जोड़ी जा सकती है जिसमें आपकी दिलचस्पी है.

5. चेतावनी की सूचना जोड़ने के लिए, + सूचना पर क्लिक करें.

   सूचना की जानकारी	ब्यौरा
   चैनल	सूचना वाले उस चैनल को चुनें जिसका आपको इस्तेमाल करना है और डेस्टिनेशन बताएं: Email, Slack, PagerDuty या Webहुक.
   मंज़िल	चुने गए चैनल टाइप के आधार पर डेस्टिनेशन तय करें: ईमेल - ईमेल पता, जैसे कि joe@company.com Slack - Slack चैनल का यूआरएल, जैसे कि https://hooks.slack.com/services/T00000000/B00000000/XXXXX PagerDuty - PagerDuty कोड, जैसे कि abcd1234efgh56789 वेबहुक - वेबहुक यूआरएल, जैसे कि https://apigee.com/test-webhook ध्यान दें: हर सूचना के लिए सिर्फ़ एक डेस्टिनेशन तय किया जा सकता है. एक ही चैनल टाइप को एक से ज़्यादा डेस्टिनेशन पर भेजने के लिए, अन्य सूचनाएं जोड़ें.

6. अतिरिक्त सूचनाएं जोड़ने के लिए, पिछला चरण दोहराएं.
7. अगर आपने कोई सूचना जोड़ी है, तो इन फ़ील्ड को सेट करें:

   फ़ील्ड	ब्यौरा
   प्लेबुक	(ज़रूरी नहीं) फ़्री-फ़ॉर्म टेक्स्ट फ़ील्ड, ताकि सुझाई गई कार्रवाइयों के बारे में कम शब्दों में जानकारी दी जा सके आग लगने पर सूचनाएं पाने की सुविधा बंद करना. आप अपने आंतरिक विकी पर एक लिंक भी निर्दिष्ट कर सकते हैं या कम्यूनिटी पेज पर जाएं. इस फ़ील्ड में दी गई जानकारी सूचना में शामिल नहीं है. इस फ़ील्ड में 1500 से ज़्यादा वर्ण नहीं हो सकते.
   थ्रॉटल करें	सूचनाएं भेजने की फ़्रीक्वेंसी. ड्रॉप-डाउन सूची से कोई वैल्यू चुनें.

8. सेव करें पर क्लिक करें.

इवेंट डैशबोर्ड में सूचनाएं देखें

जब Edge किसी अलर्ट स्थिति का पता लगाता है, तो यह उस शर्त को अपने-आप Edge यूज़र इंटरफ़ेस (यूआई) में इवेंट डैशबोर्ड. इवेंट डैशबोर्ड में दिखने वाले इवेंट की सूची इसमें फ़िक्स्ड और सर्टिफ़िकेट, दोनों तरह की सभी सूचनाएं शामिल होती हैं.

सूचना देखने के लिए:

1. विश्लेषण करें > पर क्लिक करें Edge यूज़र इंटरफ़ेस (यूआई) में इवेंट. नया इवेंट डैशबोर्ड दिखेगा:

2. इवेंट डैशबोर्ड को इसके अनुसार फ़िल्टर करें:

   • परिवेश
   • क्षेत्र
   • समयावधि
3. कीस्टोर को दिखाने के लिए, इवेंट डैशबोर्ड में एक पंक्ति चुनें. इसमें वह सर्टिफ़िकेट मौजूद है जिसकी समयसीमा खत्म होने वाली है चेतावनी की आगे जांच करें. कीस्टोर पेज से, नया सर्टिफ़िकेट अपलोड किया जा सकता है और सर्टिफ़िकेट की समयसीमा खत्म होने वाली है.

ट्रैफ़िक अलर्ट के साथ अलर्ट एपीआई का इस्तेमाल करें

ट्रैफ़िक अलर्ट बनाने और मैनेज करने के लिए इस्तेमाल किए जाने वाले ज़्यादातर एपीआई, आपके इस्तेमाल किए जा रहे एपीआई से मेल खाते हैं सूचना के अन्य टाइप:

• चेतावनी पाएं - गड़बड़ी या ठीक की गई गड़बड़ी की चेतावनी पाएं.
• सूचनाओं का इतिहास पाएं - चेतावनियों के इतिहास की मेट्रिक पाएं.
• किसी सूचना को मिटाना - किसी गड़बड़ी या ठीक की गई चेतावनी की परिभाषा को मिटाएं.
• चेतावनी वाले इंस्टेंस पाएं - ट्रिगर हुई सूचना के बारे में जानकारी पाएं.
• सूचनाओं की संख्या पाएं - सूचनाओं की कुल संख्या पाएं.

हालांकि, कुछ एपीआई में गड़बड़ी की चेतावनियों के बारे में जानकारी देने के लिए, इस्तेमाल की जाने वाली अतिरिक्त प्रॉपर्टी होती हैं. इनमें ये शामिल हैं:

• चेतावनियां पाएं - गड़बड़ी वाली और ठीक की गई सूचनाओं के साथ-साथ सभी चेतावनियों की सूची बनाएं.
• सूचना बनाएं - ठीक की गई या अनियमितता की सूचना बनाएं.
• सूचना अपडेट करें - ठीक की गई या गड़बड़ी की सूचना की परिभाषा अपडेट करें.

ट्रैफ़िक अलर्ट बनाएं या अपडेट करें

बनाने के लिए उन्हीं एपीआई का इस्तेमाल करें या अपडेट करें जैसा कि आप वर्तमान में अन्य प्रकार की सूचनाओं के लिए करते हैं. ट्रैफ़िक अलर्ट बनाने या अपडेट करने के लिए किए जाने वाले एपीआई कॉल का मुख्य हिस्सा, इसके लिए इस्तेमाल किए गए मुख्य हिस्से जैसा ही होता है अन्य अलर्ट:

• अलर्ट, ट्रैफ़िक से जुड़ी सूचना है, यह बताने के लिए नीचे दी गई नई प्रॉपर्टी जोड़ें:

  "alertType": "runtime"
  "alertSubType": "trafficfixed"

  इन प्रॉपर्टी की डिफ़ॉल्ट वैल्यू ये हैं:

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

• conditions कलेक्शन के dimensions एलिमेंट में:
  • आपको org, env, proxy, और region प्रॉपर्टी. सिर्फ़ इन्हीं प्रॉपर्टी का इस्तेमाल किया जा सकता है. proxy और region को ALL पर सेट किया जा सकता है.
  • आपको traffic प्रॉपर्टी की वैल्यू को total पर सेट करना होगा.

• 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 प्रॉपर्टी का इस्तेमाल नहीं किया जा सकता.

नीचे दिए गए उदाहरण में उस अलर्ट को सेट अप करने का तरीका बताया गया है, जो संगठन और माहौल में एक घंटे की अवधि में 50% की बढ़ोतरी होती है. कोई सूचना ट्रिगर होने पर, तय किए गए 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 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
}'

$ACCESS_TOKEN को अपने OAuth 2.0 ऐक्सेस टोकन पर सेट करें. इसके बारे में यहां बताया गया है OAuth 2.0 ऐक्सेस टोकन पाना. इस उदाहरण में इस्तेमाल किए गए cURL के विकल्पों के बारे में जानकारी के लिए, cURL का इस्तेमाल करना लेख पढ़ें.

इस एपीआई का इस्तेमाल करने के बारे में ज़्यादा जानकारी के लिए, इवेंट देखें लेख पढ़ें.

ट्रैफ़िक अलर्ट पाएं

डिफ़ॉल्ट रूप से, सूचनाएं पाएं एपीआई, तय की गई सभी चेतावनियों के बारे में जानकारी दिखाता है. नतीजों को फ़िल्टर करने के लिए, यह एपीआई अब क्वेरी पैरामीटर का इस्तेमाल करता है:

• enabled - अगर true सिर्फ़ चालू सूचनाएं दिखाता है. डिफ़ॉल्ट वैल्यू false है.
• alertType - इससे जुड़ी सूचना किस तरह की है, इसके बारे में बताता है. runtime, डिफ़ॉल्ट, और cert वैल्यू इस्तेमाल की जा सकती हैं.
• alertSubType - इससे चेतावनी का सब-टाइप तय होता है. डिफ़ॉल्ट वैल्यू सेट नहीं है. इसका मतलब है कि चेतावनी के सभी सब-टाइप दिखेंगे.

उदाहरण के लिए, myorg नाम के संगठन के लिए सिर्फ़ सूचनाएं चालू करने का विकल्प चालू करने के लिए, इस एपीआई कॉल का इस्तेमाल करें:

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 का इस्तेमाल करना लेख पढ़ें.