भौगोलिक मैप और भौगोलिक मैप चालू करना

जियो एग्रीगेशन की मदद से, एपीआई कॉल के लिए Analytics डेटा इकट्ठा किया जा सकता है. यह डेटा, क्षेत्र, महाद्वीप, देश, और शहर जैसे भौगोलिक एट्रिब्यूट पर आधारित होता है. इस Analytics डेटा से, Edge के यूज़र इंटरफ़ेस (यूआई) में एक GeoMap देखा जा सकता है. इसमें एपीआई अनुरोधों की जगह दिखाई जाती है:

जियो एग्रीगेशन, तीसरे पक्ष के डेटाबेस से भौगोलिक डेटा को निकालकर काम करते हैं. इसके बाद, वे इस डेटा को Edge से इकट्ठा किए गए Analytics डेटा में जोड़ते हैं. भौगोलिक जानकारी में, एपीआई प्रॉक्सी को किए गए अनुरोध का शहर, देश, महाद्वीप, समय क्षेत्र, और इलाका शामिल हो सकता है.

जियो एग्रीगेशन का इस्तेमाल करने के लिए, आपको Maxmind GeoIp2 डेटाबेस खरीदना होगा. इसमें यह भौगोलिक जानकारी शामिल होती है. ज़्यादा जानकारी के लिए, https://www.maxmind.com/en/geoip2-databases पर जाएं.

जियो एग्रीगेशन की सुविधा चालू करना

डिफ़ॉल्ट रूप से, जगह के हिसाब से एग्रीगेशन की सुविधा चालू नहीं होती. जियो एग्रीगेशन की सुविधा चालू करने के लिए, यह ज़रूरी है कि:

• सभी Qpid सर्वर पर MaxMind डेटाबेस इंस्टॉल करें. साथ ही, Qpid सर्वर को इसे इस्तेमाल करने के लिए कॉन्फ़िगर करें.
• Edge UI में, भौगोलिक मैप डिसप्ले करने की सुविधा चालू करें.

सभी Edge Qpid सर्वर पर MaxMind डेटाबेस इंस्टॉल करें

Edge Qpid के सभी सर्वर पर MaxMind डेटाबेस इंस्टॉल करने के लिए, यह तरीका अपनाएं:

1. Maxmind GeoIp2 डेटाबेस पाएं.
   
2. Qpid सर्वर नोड पर यह फ़ोल्डर बनाएं:

   /opt/apigee/maxmind

3. Maxmind GeoIp2 डेटाबेस को /opt/apigee/maxmind पर डाउनलोड करें.
4. डेटाबेस फ़ाइल का मालिकाना हक 'apigee' उपयोगकर्ता को ट्रांसफ़र करें:

   chown apigee:apigee /opt/apigee/maxmind/GeoIP2-City_20160127.mmdb

5. डेटाबेस के लिए अनुमतियां 744 पर सेट करें:

   chmod 744 /opt/apigee/maxmind/GeoIP2-City_20160127.mmdb

6. /opt/apigee/customer/application/qpid-server.properties में ये टोकन सेट करें. अगर वह फ़ाइल मौजूद नहीं है, तो उसे बनाएं:

   conf_ingestboot-service_vdim.geo.ingest.enabled=true
   conf_ingestboot-service_vdim.geo.maxmind.db.path=/opt/apigee/maxmind/GeoIP2-City_20160127.mmdb

   अगर आपने Maxmind GeoIp2 डेटाबेस को किसी दूसरी जगह पर सेव किया है, तो पाथ प्रॉपर्टी में उसके हिसाब से बदलाव करें.

   ध्यान दें कि इस डेटाबेस फ़ाइल में वर्शन नंबर होता है. अगर आपको बाद में अपडेट की गई डेटाबेस फ़ाइल मिलती है, तो हो सकता है कि उसका वर्शन नंबर अलग हो. इसके अलावा, डेटाबेस फ़ाइल का सिमलंक बनाएं और qpid-server.properties में सिमलंक का इस्तेमाल करें.

   उदाहरण के लिए, "GeoIP2-City-current.mmdb" के लिए "GeoIP2-City_20160127.mmdb" पर एक सिंबल लिंक बनाएं. अगर आपको बाद में किसी दूसरे फ़ाइल नाम वाला नया डेटाबेस मिलता है, तो आपको सिर्फ़ सिंबल लिंक अपडेट करना होगा. इसके लिए, Qpid सर्वर को फिर से कॉन्फ़िगर और रीस्टार्ट करने की ज़रूरत नहीं होगी.

7. 'apigee' उपयोगकर्ता को qpid-server.properties फ़ाइल का मालिकाना हक दें:

   chown apigee:apigee /opt/apigee/customer/application/qpid-server.properties

8. Qpid सर्वर को रीस्टार्ट करें:

   /opt/apigee/bin/apigee-service/bin/apigee-service edge-qpid-server restart

9. इस प्रोसेस को हर Qpid नोड पर दोहराएं.
10. यह पुष्टि करने के लिए कि जियो एग्रीगेशन काम कर रहा है:
    1. किसी सैंपल एपीआई प्रॉक्सी पर कई एपीआई प्रॉक्सी कॉल ट्रिगर करें.
    2. एग्रीगेशन पूरा होने के लिए, करीब 5 से 10 मिनट इंतज़ार करें.
    3. कंसोल खोलें और Edge Postgres सर्वर से कनेक्ट करें:

       psql -h /opt/apigee/var/run/apigee-postgresql/ -U apigee -d apigee

    4. भौगोलिक एट्रिब्यूट वाली लाइनें दिखाने के लिए, analytics.agg_geo टेबल पर SELECT क्वेरी चलाएं:

       select * from analytics.agg_geo;

       आपको क्वेरी के नतीजों में ये कॉलम दिखेंगे. ये कॉलम, Maxmind GeoIp2 डेटाबेस से निकाले गए हैं: ax_geo_city, ax_geo_country, ax_geo_continent, ax_geo_timezone, ax_geo_region.

       अगर agg_geo टेबल में डेटा नहीं दिख रहा है, तो /opt/apigee/var/log/edge-qpid-server/logs/ पर जाकर Qpid सर्वर लॉग देखें. इससे आपको संभावित अपवादों का पता लगाने में मदद मिलेगी.

Edge यूज़र इंटरफ़ेस (यूआई) में जियो मैप चालू करना

Edge UI में जियो मैप चालू करने के लिए, यह तरीका अपनाएं:

1. जियो मैप चालू करने के लिए, /opt/apigee/customer/application/ui.properties में यह टोकन सेट करें. अगर वह फ़ाइल मौजूद नहीं है, तो उसे बनाएं:

   conf_apigee_apigee.feature.disablegeomap=false

   में प्रॉपर्टी conf_apigee_apigee.feature.disablegeomap को true पर सेट किया गया हो
2. ui.properties फ़ाइल का मालिकाना हक 'apigee' उपयोगकर्ता को ट्रांसफ़र करें:

   chown apigee:apigee /opt/apigee/customer/application/ui.properties

3. Edge UI को रीस्टार्ट करने के लिए:

   /opt/apigee/bin/apigee-service/bin/apigee-service edge-ui restart

4. Edge के यूज़र इंटरफ़ेस (यूआई) में, Analytics > GeoMap को चुनें, ताकि भौगोलिक जानकारी के आधार पर एग्रीगेट किया गया डेटा दिखाया जा सके.

MaxMind GeoIp2 डेटाबेस को अपडेट करना

MaxMind, Maxmind GeoIp2 डेटाबेस को समय-समय पर अपडेट करता है. अगर आपको अपडेट किया गया डेटाबेस मिलता है, तो उसे Edge पर इंस्टॉल करने के लिए यह तरीका अपनाएं:

1. Maxmind GeoIp2 का अपडेट किया गया डेटाबेस पाएं.
2. Maxmind GeoIp2 डेटाबेस को /opt/apigee/maxmind पर डाउनलोड करें.
3. डेटाबेस फ़ाइल का नाम देखें. अगर यह पुरानी फ़ाइल के जैसा ही है, जैसा कि /opt/apigee/customer/application/qpid-server.properties में बताया गया है, तो अगले चरण पर जाएं. हालांकि, अगर फ़ाइल का नाम अलग है, तो आपको qpid-server.properties फ़ाइल में बदलाव करना होगा, ताकि नई डेटाबेस फ़ाइल का नाम बताया जा सके. इसके बाद, ऊपर बताए गए तरीके से Qpid सर्वर को फिर से शुरू करें.

   इसके अलावा, फ़ाइल का सिंबॉलिक लिंक भी बनाया जा सकता है. उदाहरण के लिए, "GeoIP2-City-current.mmdb" के लिए "GeoIP2-City_20160127.mmdb" पर एक सिंबल लिंक बनाएं. अगर आपको बाद में किसी दूसरे फ़ाइल नाम वाला नया डेटाबेस मिलता है, तो आपको सिर्फ़ सिंबल लिंक अपडेट करना होगा. इसके लिए, Qpid सर्वर को फिर से कॉन्फ़िगर करने की ज़रूरत नहीं होगी.

4. डेटाबेस फ़ाइल का मालिकाना हक 'apigee' उपयोगकर्ता को ट्रांसफ़र करें:

   chown apigee:apigee /opt/apigee/maxmind/GeoIP2-City_20160127.mmdb

5. डेटाबेस के लिए अनुमतियां 744 पर सेट करें:

   chmod 744 /opt/apigee/maxmind/GeoIP2-City_20160127.mmdb

6. Qpid सर्वर को रीस्टार्ट करें:

   /opt/apigee/bin/apigee-service/bin/apigee-service edge-qpid-server restart

7. इस प्रोसेस को हर Qpid नोड पर दोहराएं.