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

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

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

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

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

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

• सभी Qpid सर्वर पर, MaxMind डेटाबेस इंस्टॉल करें और Qpid सर्वर को इसका इस्तेमाल करने के लिए कॉन्फ़िगर करें.
• New Edge यूज़र इंटरफ़ेस (यूआई) में, Geo Map डिसप्ले की सुविधा चालू करें.

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

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

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

   /opt/apigee/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 टेबल में डेटा नहीं आ रहा है, तो Qpid सर्वर के लॉग देखें. ये लॉग, /opt/apigee/var/log/edge-qpid-server/logs/ पर मौजूद होते हैं. इससे, संभावित अपवादों का पता लगाया जा सकता है.

New Edge यूज़र इंटरफ़ेस (यूआई) में, भौगोलिक मैप की सुविधा चालू करना

New Edge यूज़र इंटरफ़ेस (यूआई) में, भौगोलिक मैप की सुविधा चालू करने के लिए, यह तरीका अपनाएं:

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

   conf_uebe_disableGeoMap=false

2. management-ui.properties फ़ाइल का मालिकाना हक, apigee उपयोगकर्ता को दें:

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

3. New Edge यूज़र इंटरफ़ेस (यूआई) को रीस्टार्ट करें:

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

4. New Edge यूज़र इंटरफ़ेस (यूआई) में, जगह के हिसाब से एग्रीगेशन का डेटा दिखाने के लिए, विश्लेषण करें > असली उपयोगकर्ता > 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/apigee-service/bin/apigee-service edge-qpid-server restart

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