Edge for Private Cloud v. 4.17.09
सिस्टम की ज़रूरतें
डैशबोर्ड का डेटा इकट्ठा करने के लिए, आपको सभी Edge नोड पर apigee-telegraf इंस्टॉल करना होगा. इसलिए, apigee-telegraf के लिए सिस्टम की ज़रूरतें, उस Edge नोड के लिए सिस्टम की ज़रूरतों जैसी ही होती हैं जिस पर इसे इंस्टॉल किया जा रहा है.
apigee-grafana को किसी अलग नोड पर इंस्टॉल किया जा सकता है. इसके अलावा, मौजूदा Edge नोड में से किसी एक का फिर से इस्तेमाल किया जा सकता है. जैसे, मैनेजमेंट सर्वर या Edge यूज़र इंटरफ़ेस (यूआई) नोड.
apigee-influxdb के लिए, इसे किसी मौजूदा Edge नोड पर इंस्टॉल किया जा सकता है. जैसे, मैनेजमेंट सर्वर नोड या Edge यूज़र इंटरफ़ेस (यूआई) नोड. इसके लिए, सिस्टम की ज़रूरी शर्तों में कोई बदलाव नहीं करना पड़ता.
अगर आपको परफ़ॉर्मेंस को बेहतर बनाने के लिए, apigee-influxdb को इसके नोड पर इंस्टॉल करना है, तो नोड के लिए ये ज़रूरी शर्तें पूरी होनी चाहिए:
- 2 कोर सीपीयू
- 4 जीबी रैम
- 250 जीबी डिस्क में बचा स्टोरेज (मॉनिटरिंग डेटा एक महीने के बाद मिटा दिया जाता है)
- 1,000 या इससे ज़्यादा IOPS
ज़्यादा जानकारी के लिए, InfluxData दस्तावेज़ देखें.
apigee-influxdb के लिए पोर्ट से जुड़ी ज़रूरी शर्तें
apigee-influxdb डेटा नोड पर पोर्ट 8086 और 8183 खुले होने चाहिए, ताकि apigee-grafana और apigee-telegraf को चलाने वाला नोड इन्हें ऐक्सेस कर सके.
डैशबोर्ड के कॉम्पोनेंट इंस्टॉल करने के लिए कॉन्फ़िगरेशन फ़ाइलें
apigee-telegraf और apigee-grafana कॉम्पोनेंट इंस्टॉल करने के लिए, आपको apigee-service यूटिलिटी में एक कॉन्फ़िगरेशन फ़ाइल पास करनी होगी. इन फ़ाइलों को ऐसी डायरेक्ट्री में सेव करें जिसे 'apigee' उपयोगकर्ता ऐक्सेस कर सके. जैसे, /opt/apigee/customer/application. साथ ही, 'apigee' उपयोगकर्ता को इनका मालिकाना हक दें.
apigee-telegraf के लिए कॉन्फ़िगरेशन पैरामीटर
इन प्रॉपर्टी को उस टेक्स्ट फ़ाइल में सेट करें जिसे apigee-telegraf setup कमांड को पास किया जाता है. उदाहरण के लिए, उन्हें sa_telegraf.txt नाम की टेक्स्ट फ़ाइल में सेट करें:
|
प्रॉपर्टी |
ब्यौरा |
|---|---|
|
INFLUXDB_URL |
apigee-influxdb नोड का यूआरएल डालें. इसमें पोर्ट 8086 शामिल करें. उदाहरण के लिए: http://192.168.0.1:8086 |
apigee-grafana के लिए कॉन्फ़िगरेशन पैरामीटर
इन प्रॉपर्टी को उस टेक्स्ट फ़ाइल में सेट करें जिसे apigee-grafana setup कमांड को पास किया जाता है. उदाहरण के लिए, इन्हें sa_grafana.txt नाम की टेक्स्ट फ़ाइल में सेट करें:
|
प्रॉपर्टी |
ब्यौरा |
|---|---|
|
INFLUXDB_HOST |
InfluxDB नोड का आईपी पता या डीएनएस नाम डालें. उदाहरण के लिए: 192.168.0.1 |
|
INFLUXDB_PORT |
Grafana डेटासोर्स के इस्तेमाल किया जाने वाला InfluxDB API पोर्ट. 8086 डालें. |
|
GRAFANA_USERNAME |
डैशबोर्ड के यूज़र इंटरफ़ेस (यूआई) में लॉग इन करने के लिए, Grafana का उपयोगकर्ता नाम. |
|
GRAFANA_PASSWORD |
डैशबोर्ड के यूज़र इंटरफ़ेस (यूआई) में लॉग इन करने के लिए Grafana पासवर्ड. |
इंस्टॉल करने के निर्देश
डैशबोर्ड के कॉम्पोनेंट को इस क्रम में इंस्टॉल करने के लिए, यहां दिए गए निर्देशों का पालन करें:
- apigee-influxdb (सेंट्रल नोड पर)
- apigee-telegraf (हर नोड पर)
- apigee-grafana (सेंट्रल सर्वर पर)
apigee-influxdb को किसी एक Edge नोड या स्टैंडअलोन नोड पर इंस्टॉल करें
स्टैंडअलोन नोड या मैनेजमेंट सर्वर या Edge यूज़र इंटरफ़ेस (यूआई) चलाने वाले Edge नोड पर:
- apigee-influxdb इंस्टॉल करें:
> /opt/apigee/apigee-service/bin/apigee-service apigee-influxdb install - apigee-influxdb डेटाबेस को कॉन्फ़िगर करें:
> /opt/apigee/apigee-service/bin/apigee-service apigee-influxdb setup - apigee-influxdb को चालू करें:
> /opt/apigee/apigee-service/bin/apigee-service apigee-influxdb start
हर Edge नोड पर apigee-telegraf इंस्टॉल करें
Edge इंस्टॉलेशन के हर नोड पर:
- अपने पहले Edge नोड पर, apigee-telegraf इंस्टॉल करें:
> /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf install - apigee-telegraf के लिए, sa_telegraf.txt नाम की एक कॉन्फ़िगरेशन फ़ाइल बनाएं.
आम तौर पर, इस फ़ाइल को ऐसी डायरेक्ट्री में सेव किया जाता है जिसे 'apigee' उपयोगकर्ता ऐक्सेस कर सकता है. जैसे, /opt/apigee/customer/application. साथ ही, इसका मालिकाना हक 'apigee' उपयोगकर्ता को दिया जाता है.
apigee-influxdb नोड का यूआरएल बताने के लिए, फ़ाइल में यह प्रॉपर्टी सेट करें. इसमें पोर्ट 8086 शामिल करें:
INFLUXDB_URL=http://influx_IP:8086 - मालिक को 'apigee' में बदलें:
> chown apigee:apigee /opt/apigee/customer/application/sa_telegraf.txt - apigee-telegraf को कॉन्फ़िगर करें:
> /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf setup -f /opt/apigee/customer/application/sa_telegraf.txt - apigee-telegraf को रीस्टार्ट करें:
> /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf restart - सभी Edge नोड पर यह प्रोसेस दोहराएं.
किसी एक Edge नोड पर apigee-grafana इंस्टॉल करना
Edge इंस्टॉलेशन के किसी एक नोड पर, जैसे कि Edge यूज़र इंटरफ़ेस (यूआई) नोड पर:
- अपने पहले Edge नोड पर, apigee-grafana इंस्टॉल करें:
> /opt/apigee/apigee-service/bin/apigee-service apigee-grafana install - apigee-grafana के लिए, sa_grafana.txt नाम की एक कॉन्फ़िगरेशन फ़ाइल बनाएं. आम तौर पर, इस फ़ाइल को ऐसी डायरेक्ट्री में सेव किया जाता है जिसे 'apigee' उपयोगकर्ता ऐक्सेस कर सकता है. जैसे, /opt/apigee/customer/application. साथ ही, इसका मालिकाना हक 'apigee' उपयोगकर्ता को दिया जाता है.
फ़ाइल में ये प्रॉपर्टी सेट करें. इन प्रॉपर्टी के बारे में ऊपर बताया गया है:
INFLUXDB_HOST=192.168.56.101
INFLUXDB_PORT=8086
GRAFANA_USERNAME=admin
GRAFANA_PASSWORD=admin - मालिक को 'apigee' में बदलें:
> chown apigee:apigee /opt/apigee/customer/application/sa_grafana.txt - कॉन्फ़िगरेशन फ़ाइल का इस्तेमाल करके, apigee-grafana को कॉन्फ़िगर करें:
> /opt/apigee/apigee-service/bin/apigee-service apigee-grafana setup -f /opt/apigee/customer/application/sa_grafana.txt - apigee-grafana को रीस्टार्ट करें:
> /opt/apigee/apigee-service/bin/apigee-service apigee-grafana restart
डैशबोर्ड को ऐक्सेस करने के लिए, ब्राउज़र में यह यूआरएल खोलें:
http://grafana_IP_or_DNS:3000
apigee-grafana के लिए, कॉन्फ़िगरेशन फ़ाइल में दिए गए क्रेडेंशियल का इस्तेमाल करके लॉग इन करें. ऊपर दिए गए उदाहरण में, उपयोगकर्ता नाम/पासवर्ड admin/admin है.
इंस्टॉल करने से जुड़ी समस्या हल करना
अगर आपको डैशबोर्ड में डेटा नहीं दिख रहा है, तो इंस्टॉल करने से जुड़ी समस्या को हल करने के लिए, यह तरीका अपनाएं:
- यह पक्का करने के लिए कि apigee-telegraf
डेटा इकट्ठा कर रहा है
- apigee-service apigee-telegraf setup चलाएं. यह आइडेंपोटेंट है. गड़बड़ियों और डिपेंडेंसी की जांच करें और उन्हें ठीक करें.
- apigee-telegraf को रीस्टार्ट करें और किसी भी गड़बड़ी के लिए, /opt/apigee/var/log/apigee-telegraf/apigee-telegraf.log देखें
- यह पक्का करने के लिए कि apigee-influxdb को डेटा मिल रहा है:
- पक्का करें कि apigee-influxdb डेटा नोड पर ये टीसीपी पोर्ट खुले हों: 8086 और 8183.
- किसी ब्राउज़र में influxdb यूज़र इंटरफ़ेस (यूआई) खोलने के लिए, इस यूआरएल का इस्तेमाल करें:
http://influxdb_IP_or_DNS:8183- क्वेरी फ़ील्ड में, "show databases" डालें.
पक्का करें कि ये डेटाबेस बनाए गए हों: system, application, events, _internal. - क्वेरी फ़ील्ड में, "show servers” डालें.
पक्का करें कि आपको apigee-influxdb नोड, सूची में दिख रहे हों.
- क्वेरी फ़ील्ड में, "show databases" डालें.
- डैशबोर्ड में डेटा सोर्स देखें:
- मुख्य मेन्यू में जाकर, डेटा सोर्स को चुनें. आपको तीन डेटा सोर्स के आइकॉन दिखेंगे.
- हर डेटा सोर्स के लिए, आइकॉन चुनें.
- डेटा सोर्स की ज़्यादा जानकारी वाले पेज पर, सेव करें और टेस्ट करें बटन को चुनें.
- अगर डेटा सोर्स को सही तरीके से कॉन्फ़िगर किया गया है, तो आपको इस तरह का मैसेज दिखेगा:
सफलता
डेटा सोर्स काम कर रहा है
बीटा वर्शन की निगरानी करने वाले डैशबोर्ड को अपडेट करना
Edge के जिस वर्शन को अपग्रेड किया जा रहा है उसके आधार पर, यहां दी गई दो प्रोसेस में से किसी एक का इस्तेमाल करें:
- 4.16.09, 4.17.01, और 4.17.05 में एक ही तरीका इस्तेमाल किया जाता है
- 4.16.05 के लिए ज़रूरी है कि आप अपडेट के हिस्से के तौर पर, apigee-collectd को अनइंस्टॉल करें.
वर्शन 4.16.09, 4.17.01 या 4.17.05 से अपडेट करना
अगर आपने 4.16.09, 4.17.01 या 4.17.05 में Apigee Monitoring Dashboard का बीटा वर्शन इंस्टॉल किया है, तो इसे 4.17.09 के बीटा वर्शन पर अपडेट किया जा सकता है.
बीटा मॉनिटरिंग डैशबोर्ड को अपडेट करने के लिए:
- Edge को 4.17.09 में अपडेट करें. इसके लिए, Apigee Edge 4.17.01/4.17.05 को 4.17.09 में अपडेट करें, Apigee Edge 4.16.09 को 4.17.09 में अपडेट करें, और Apigee Edge 4.16.01/4.16.05 को 4.17.09 में अपडेट करें में बताया गया तरीका अपनाएं.
- मैनेजमेंट सर्वर नोड पर apigee-influxdb को अपडेट करें:
> /opt/apigee/apigee-setup/bin/update.sh -c pp -f configfile
जहां configFile वह कॉन्फ़िगरेशन फ़ाइल है जिसका इस्तेमाल आपने apigee-influx को इंस्टॉल करने के लिए किया था.
अगर आपने मैनेजमेंट सर्वर नोड पर apigee-grafana भी इंस्टॉल किया है, तो इस चरण से apigee-grafana भी अपडेट हो जाता है. अगर ऐसा नहीं है, तो यहां दिए गए तरीके का इस्तेमाल करके apigee-granfana को अपडेट करें. - अगर आपने मैनेजमेंट सर्वर नोड पर apigee-grafana इंस्टॉल नहीं किया है, तो उस नोड पर apigee-grafana को अपडेट करें जहां आपने इसे इंस्टॉल किया है:
> /opt/apigee/apigee-setup/bin/update.sh -c pp -f configfile - नोड 1 पर apigee-telegraf को अपडेट करें:
> /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf update
> /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf setup -f configFile
> /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf restart - हर नोड के लिए, चौथे चरण को दोहराएं.
वर्शन 4.16.05 से अपडेट करें
डैशबोर्ड के 4.16.05 वर्शन में, apigee-telegraf के बजाय apigee-collectd का इस्तेमाल किया गया था. 4.17.09 पर अपडेट करने के लिए, आपको apigee-collectd को अनइंस्टॉल करना होगा और apigee-telegraf को इंस्टॉल करना होगा.
बीटा मॉनिटरिंग डैशबोर्ड को अपडेट करने के लिए:
- Edge को 4.17.09 पर अपडेट करें. इसके लिए, Apigee Edge 4.17.01/4.17.05 को 4.17.09 पर अपडेट करें, Apigee Edge 4.16.09 को 4.17.09 पर अपडेट करें, और Apigee Edge 4.16.01/4.16.05 को 4.17.09 पर अपडेट करें में बताया गया तरीका अपनाएं.
- मैनेजमेंट सर्वर नोड पर apigee-influxdb को अपडेट करें:
> /opt/apigee/apigee-setup/bin/update.sh -c pp -f configfile
जहां configFile वह कॉन्फ़िगरेशन फ़ाइल है जिसका इस्तेमाल आपने apigee-influx को इंस्टॉल करने के लिए किया था.
अगर आपने मैनेजमेंट सर्वर नोड पर apigee-grafana भी इंस्टॉल किया है, तो इस चरण से apigee-grafana भी अपडेट हो जाता है. अगर ऐसा नहीं है, तो यहां दिए गए तरीके का इस्तेमाल करके apigee-granfana को अपडेट करें. - अगर आपने मैनेजमेंट सर्वर नोड पर apigee-grafana इंस्टॉल नहीं किया है, तो उस नोड पर apigee-grafana को अपडेट करें जहां आपने इसे इंस्टॉल किया है:
> /opt/apigee/apigee-setup/bin/update.sh -c pp -f configfile - नोड 1 पर apigee-telegraf इंस्टॉल करें:
> /opt/apigee/apigee-service/bin/apigee-service apigee-collectd stop
> /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf install
> /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf setup -f configFile
> /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf restart
> /opt/apigee/apigee-service/bin/apigee-service apigee-collectd uninstall - हर नोड के लिए, चौथे चरण को दोहराएं.