मॉनिटरिंग डैशबोर्ड इंस्टॉलेशन (बीटा)

Edge for Private Cloud v4.18.01

सिस्टम के लिए ज़रूरी शर्तें

डैशबोर्ड डेटा इकट्ठा करने के लिए, आपको सभी Edge नोड पर apigee-telegraf इंस्टॉल करना होगा. इसलिए, apigee-telegraf के लिए सिस्टम की ज़रूरी शर्तें वही हैं जो उस Edge नोड के लिए ज़रूरी हैं जिस पर इसे इंस्टॉल किया जा रहा है.

apigee-grafana को किसी अलग नोड पर इंस्टॉल किया जा सकता है. इसके अलावा, मैनेजमेंट सर्वर या Edge यूज़र इंटरफ़ेस (यूआई) जैसे किसी मौजूदा Edge नोड का फिर से इस्तेमाल किया जा सकता है.

apigee-influxdb के लिए, इसे मैनेजमेंट सर्वर नोड या Edge यूज़र इंटरफ़ेस (यूआई) नोड जैसे किसी मौजूदा Edge नोड पर इंस्टॉल किया जा सकता है. इससे, सिस्टम की ज़रूरी शर्तों में कोई बदलाव नहीं किया जाएगा.

अगर परफ़ॉर्मेंस की वजहों से, apigee-influxdb को इसके नोड पर इंस्टॉल करने का फ़ैसला लिया जाता है, तो नोड को इन शर्तों के मुताबिक पूरा करना होगा:

  • 2 कोर वाला सीपीयू
  • 4 जीबी रैम
  • 250 जीबी का डिस्क स्टोरेज (एक महीने के बाद डेटा को पूरी तरह मिटाना)
  • 1,000 या इससे ज़्यादा आईओपीएस

ज़्यादा जानकारी के लिए, InfluxData दस्तावेज़ देखें.

apigee-influxdb के लिए पोर्ट से जुड़ी ज़रूरी शर्तें

apigee-grafana और apigee-telegraf को चलाने वाले नोड से ऐक्सेस करने के लिए, apigee-influxdb डेटा नोड पर पोर्ट 8086 और 8183 खुले होने चाहिए.

डैशबोर्ड कॉम्पोनेंट इंस्टॉल करने के लिए कॉन्फ़िगरेशन फ़ाइलें

apigee-telegraf और apigee-grafana कॉम्पोनेंट को इंस्टॉल करने के लिए, आपको apigee-service यूटिलिटी को कॉन्फ़िगरेशन फ़ाइल पास करनी होती है. इन फ़ाइलों को किसी ऐसी डायरेक्ट्री में सेव करें जिसे 'apigee' उपयोगकर्ता ऐक्सेस कर सके, जैसे कि /opt/apigee/customer/application. साथ ही, इन फ़ाइलों का मालिकाना हक 'apigee' उपयोगकर्ता के पास हो.

apigee-telegraf के लिए कॉन्फ़िगरेशन पैरामीटर

इन प्रॉपर्टी को उस टेक्स्ट फ़ाइल में सेट करें जिसे apigee-telegraf setup कमांड को भेजा जाता है. उदाहरण के लिए, उन्हें sa_telegraf.txt नाम वाली टेक्स्ट फ़ाइल में सेट करें:

प्रॉपर्टी

Description

INFLUXDB_URL

पोर्ट 8086 के साथ, apigee-influxdb नोड का यूआरएल बताएं. उदाहरण के लिए:

http://192.168.0.1:8086

apigee-grafana के लिए कॉन्फ़िगरेशन पैरामीटर

इन प्रॉपर्टी को उस टेक्स्ट फ़ाइल में सेट करें जिसे apigee-grafana setup कमांड को भेजा जाता है. उदाहरण के लिए, उन्हें sa_grafana.txt नाम वाली टेक्स्ट फ़ाइल में सेट करें:

प्रॉपर्टी

Description

INFLUXDB_HOST

InfluxDB नोड का आईपी पता या डीएनएस नाम बताएं. उदाहरण के लिए:

192.168.0.1

INFLUXDB_PORT

InfluxDB API पोर्ट, जिसका इस्तेमाल Grafana डेटा सोर्स करता है. 8086 बताएं.

GRAFANA_USERNAME

डैशबोर्ड यूज़र इंटरफ़ेस (यूआई) में लॉग इन करने के लिए Grafana उपयोगकर्ता नाम.

GRAFANA_PASSWORD

डैशबोर्ड यूज़र इंटरफ़ेस (यूआई) में लॉग इन करने के लिए Grafana पासवर्ड.

इंस्टॉल करने के निर्देश

डैशबोर्ड के कॉम्पोनेंट इस क्रम में इंस्टॉल करने के लिए, नीचे दिए गए निर्देशों का पालन करें:

  • apigee-influxdb (केंद्रीय नोड पर)
  • apigee-telegraf (हर नोड पर)
  • apigee-grafana (केंद्रीय सर्वर पर)

सिंगल Edge नोड या स्टैंडअलोन नोड पर apigee-influxdb इंस्टॉल करें

स्टैंडअलोन नोड या मैनेजमेंट सर्वर या Edge यूज़र इंटरफ़ेस (यूआई) चलाने वाले EDGE नोड पर:

  1. apigee-influxdb इंस्टॉल करें:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-influxdb install
  2. apigee-influxdb डेटाबेस को कॉन्फ़िगर करें:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-influxdb setup
  3. apigee-influxdb शुरू करें:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-influxdb start

हर Edge नोड पर apigee-telegraf इंस्टॉल करें

Edge इंस्टॉलेशन के हर नोड पर:

  1. अपने पहले Edge नोड पर, apigee-telegraf इंस्टॉल करें:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf install
  2. apigee-telegraf के लिए, sa_telegraf.txt नाम की कॉन्फ़िगरेशन फ़ाइल बनाएं. आम तौर पर, इस फ़ाइल को ऐसी डायरेक्ट्री में सेव किया जाता है जिसे 'apigee' उपयोगकर्ता ऐक्सेस कर सके, जैसे कि /opt/apigee/customer/application. साथ ही, इसका मालिकाना हक 'apigee' उपयोगकर्ता के पास हो.

    इस प्रॉपर्टी को फ़ाइल में सेट करें, ताकि पोर्ट 8086 के साथ-साथ, apigee-influxdb नोड के यूआरएल की जानकारी दी जा सके:

    INFLUXDB_URL=http://influx_IP:8086

  3. मालिक को 'apigee' में बदलें:
    > chown apigee:apigee /opt/apigee/customer/application/sa_telegraf.txt
  4. apigee-telegraf को कॉन्फ़िगर करें:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf setup -f
        /opt/apigee/customer/application/sa_telegraf.txt
  5. apigee-telegraf को रीस्टार्ट करें:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf restart
  6. इस प्रोसेस को सभी एज नोड पर दोहराएं.

सिंगल Edge नोड पर apigee-grafana इंस्टॉल करें

Edge इंस्टॉलेशन के एक ही नोड पर, जैसे कि Edge यूज़र इंटरफ़ेस (यूआई) नोड:

  1. अपने पहले Edge नोड पर, apigee-grafana इंस्टॉल करें:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-grafana install
  2. 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
  3. मालिक को 'apigee' में बदलें:
    > chown apigee:apigee /opt/apigee/customer/application/sa_grafana.txt
  4. कॉन्फ़िगरेशन फ़ाइल का इस्तेमाल करके, apigee-grafana को कॉन्फ़िगर करें:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-grafana setup -f
        /opt/apigee/customer/application/sa_grafana.txt
  5. apigee-grafana को रीस्टार्ट करें:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-grafana restart

डैशबोर्ड ऐक्सेस करने के लिए, ब्राउज़र में इस यूआरएल को खोलें:

http://grafana_IP_or_DNS:3000

apigee-grafana की कॉन्फ़िगरेशन फ़ाइल में दिए गए क्रेडेंशियल का इस्तेमाल करके, लॉग इन करें. ऊपर दिखाए गए उदाहरण में उपयोगकर्ता नाम/पासवर्ड एडमिन/एडमिन है.

इंस्टॉल करने में आने वाली समस्याएं हल करना

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

  1. यह पक्का करने के लिए कि apigee-telegraf डेटा इकट्ठा कर रहा है
    1. apigee-service apigee-telegraf setup चलाएं, यह बिना काम के है. गड़बड़ियों की जांच करें, डिपेंडेंसी मौजूद नहीं है, और उन्हें ठीक करें.
    2. apigee-telegraf को रीस्टार्ट करें और देखें कि /opt/apigee/var/log/apigee-telegraf/apigee-telegraf.log में कोई गड़बड़ी तो नहीं है
  2. यह पक्का करने के लिए कि apigee-influxdb को डेटा मिल रहा है:
    1. पक्का करें कि apigee-influxdb डेटा नोड पर ये टीसीपी पोर्ट खुले हों: 8086 और 8183.
    2. ब्राउज़र में influxdb यूआई खोलने के लिए, इस यूआरएल का इस्तेमाल करें:
      http://influxdb_IP_or_DNS:8183
      1. क्वेरी फ़ील्ड में, "डेटाबेस दिखाएं" डालें. पक्का करें कि ये डेटाबेस बनाए गए हों: system, application, events, _internal.
      2. क्वेरी फ़ील्ड में, "सर्वर दिखाएं" डालें. पक्का करें कि आपको apigee-influxdb नोड, सूची में दिख रहे हों.
  3. डैशबोर्ड पर डेटा सोर्स देखें:
    1. मुख्य मेन्यू में, डेटा सोर्स चुनें. आपको तीन डेटा सोर्स के लिए आइकॉन दिखेंगे.
    2. हर डेटा सोर्स के लिए आइकॉन चुनें.
    3. डेटा सोर्स की ज़्यादा जानकारी वाले पेज में, सेव करें और जांच करें बटन चुनें.
    4. अगर डेटा सोर्स सही तरीके से कॉन्फ़िगर किया गया है, तो आपको इस फ़ॉर्म में एक मैसेज दिखेगा:
      हो गया
      डेटा सोर्स काम कर रहा है

बीटा मॉनिटरिंग डैशबोर्ड अपडेट करना

आपको जिस EDGE वर्शन से अपग्रेड करना है उसके आधार पर, नीचे दी गई दो प्रोसेस में से किसी एक का इस्तेमाल करें:

  • 4.16.09 और 4.17.0x में एक ही प्रोसेस का इस्तेमाल किया जाता है
  • वर्शन 4.16.05 के लिए, ज़रूरी है कि आप अपडेट के तौर पर apigee-collectd को अनइंस्टॉल करें.

वर्शन 4.16.09 या 4.17.0x से अपडेट करना

अगर आपने Apigee मॉनिटरिंग डैशबोर्ड का बीटा वर्शन 4.16.09 या 4.17.0x में इंस्टॉल किया है, तो आप उसे 4.18.01 के बीटा वर्शन में अपडेट कर सकते हैं.

बीटा वर्शन वाले मॉनिटरिंग डैशबोर्ड को अपडेट करने के लिए:

  1. Update 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.9.14.16.16 पर अपडेट करें के अनुसार Edge को 4.18.01 पर अपडेट करें.
  2. मैनेजमेंट सर्वर नोड पर apigee-influxdb अपडेट करें:
    > /opt/apigee/apigee-setup/bin/update.sh -c pp -f configfile

    जहां configFile वह कॉन्फ़िगरेशन फ़ाइल है जिसका इस्तेमाल आपने apigee-influx को इंस्टॉल करने के लिए किया था.

    अगर आपने मैनेजमेंट सर्वर नोड पर भी apigee-grafana इंस्टॉल किया है, तो यह चरण भी apigee-grafana को अपडेट कर देता है. अगर ऐसा नहीं है, तो यहां बताए गए तरीके से apigee-granfana को अपडेट करें.

  3. अगर आपने मैनेजमेंट सर्वर नोड पर apigee-grafana इंस्टॉल नहीं किया है, तो apigee-grafana को उस नोड पर अपडेट करें जहां आपने उसे इंस्टॉल किया था:
    > /opt/apigee/apigee-setup/bin/update.sh -c pp -f configfile
  4. नोड 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
  5. हर नोड के लिए चौथा चरण दोहराएं.

वर्शन 4.16.05 से अपडेट करें

डैशबोर्ड के 4.16.05 वर्शन में apigee-telegraf के बजाय, apigee-collectd का इस्तेमाल किया गया था. 4.18.01 में अपडेट करने के तहत, आप apigee-collectd को अनइंस्टॉल करते हैं और apigee-telegraf को इंस्टॉल करते हैं.

बीटा वर्शन वाले मॉनिटरिंग डैशबोर्ड को अपडेट करने के लिए:

  1. Update Apigee Edge 4.16.01/4.16.05 से 4.17.01 पर और Apigee Edge 4.16.09 से 4.17.01 पर अपडेट करें में बताए गए तरीके से 4.18.01 पर अपडेट करें.
  2. मैनेजमेंट सर्वर नोड पर apigee-influxdb अपडेट करें:
    > /opt/apigee/apigee-setup/bin/update.sh -c pp -f configfile

    जहां configFile वह कॉन्फ़िगरेशन फ़ाइल है जिसका इस्तेमाल आपने apigee-influx को इंस्टॉल करने के लिए किया था.

    अगर आपने मैनेजमेंट सर्वर नोड पर भी apigee-grafana इंस्टॉल किया है, तो यह चरण भी apigee-grafana को अपडेट कर देता है. अगर ऐसा नहीं है, तो यहां बताए गए तरीके से apigee-granfana को अपडेट करें.

  3. अगर आपने मैनेजमेंट सर्वर नोड पर apigee-grafana इंस्टॉल नहीं किया है, तो apigee-grafana को उस नोड पर अपडेट करें जहां आपने उसे इंस्टॉल किया था:
    > /opt/apigee/apigee-setup/bin/update.sh -c pp -f configfile
  4. नोड 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
  5. हर नोड के लिए चौथा चरण दोहराएं.