एपिजी-मोनीट के साथ खुद को ठीक करना

Private Cloud के लिए Apigee Edge में apigee-monit शामिल है. यह ओपन सोर्स monit यूटिलिटी पर आधारित एक टूल है. apigee-monit समय-समय पर Edge सेवाओं की पोलिंग करता है. अगर कोई सेवा उपलब्ध नहीं है, तो apigee-monit उसे रीस्टार्ट करने की कोशिश करता है.

apigee-monit का इस्तेमाल करने के लिए, आपको इसे मैन्युअल तरीके से इंस्टॉल करना होगा. यह स्टैंडर्ड इंस्टॉलेशन का हिस्सा नहीं है.

डिफ़ॉल्ट रूप से, apigee-monit हर 60 सेकंड में Edge की सेवाओं की स्थिति जांचता है.

तुरंत शुरू करने का तरीका

इस सेक्शन में, apigee-monit इस्तेमाल करने का तरीका बताया गया है.

अगर आप Amazon Linux का इस्तेमाल कर रहे हैं, तो पहले Fedora इंस्टॉल करें. अगर आपको ऐसा नहीं करना है, तो यह चरण छोड़ दें.

sudo yum install -y https://kojipkgs.fedoraproject.org/packages/monit/5.25.1/1.el6/x86_64/monit-5.25.1-1.el6.x86_64.rpm

apigee-monit को इंस्टॉल करने के लिए, यह तरीका अपनाएं:

/opt/apigee/apigee-service/bin/apigee-service apigee-monit install
/opt/apigee/apigee-service/bin/apigee-service apigee-monit configure
/opt/apigee/apigee-service/bin/apigee-service apigee-monit start

/opt/apigee/apigee-service/bin/apigee-service apigee-monit unmonitor -c component_name

/opt/apigee/apigee-service/bin/apigee-service apigee-monit unmonitor -c all

/opt/apigee/apigee-service/bin/apigee-service apigee-monit monitor -c component_name

/opt/apigee/apigee-service/bin/apigee-service apigee-monit monitor -c all

/opt/apigee/apigee-service/bin/apigee-service apigee-monit report

/opt/apigee/apigee-service/bin/apigee-service apigee-monit summary

cat /opt/apigee/var/log/apigee-monit/apigee-monit.log

इनमें से हर विषय और अन्य विषयों के बारे में आगे के सेक्शन में बताया गया है.

apigee-monit के बारे में जानकारी

apigee-monit से यह पक्का करने में मदद मिलती है कि किसी नोड के सभी कॉम्पोनेंट चालू रहें और सही से काम करते रहें. ऐसा करने के लिए, यह कई तरह की सेवाएं देता है. जैसे:

• जिन सेवाओं को रीस्टार्ट नहीं किया जा सका उन्हें रीस्टार्ट किया जा रहा है
• सारांश जानकारी प्रदर्शित की जा रही है
• मॉनिटरिंग स्टेटस
• सूचनाएं भेजी जा रही हैं
• नॉन-एज सेवाओं की निगरानी करना

Apigee का सुझाव है कि आप apigee-monit को मॉनिटर करके, यह पक्का करें कि यह चल रहा है. ज़्यादा जानकारी के लिए, apigee-monit को मॉनिटर करें देखें.

एपीआईजी-मॉनिट आर्किटेक्चर

Private Cloud के लिए Apigee Edge को इंस्टॉल और कॉन्फ़िगर करने के दौरान, आपको वैकल्पिक तौर पर अपने क्लस्टर में, हर नोड पर apigee-monit का अलग इंस्टेंस इंस्टॉल करना होगा. ये अलग-अलग apigee-monit इंस्टेंस एक-दूसरे से अलग काम करते हैं: वे न तो अपने कॉम्पोनेंट की स्थिति के बारे में दूसरे नोड को बताते हैं और न ही मॉनिटरिंग यूटिलिटी की फ़ेलियर को किसी भी मुख्य सेवा को नहीं बताते हैं.

यह इमेज, 5-नोड क्लस्टर में apigee-monit आर्किटेक्चर को दिखाती है:

इन प्लैटफ़ॉर्म पर चलाया जा सकता है

आपके Private Cloud क्लस्टर के लिए, apigee-monit इन प्लैटफ़ॉर्म पर काम करता है. (apigee-monit पर काम करने वाला ओएस, प्राइवेट क्लाउड के वर्शन पर निर्भर करता है.)

कॉम्पोनेंट के कॉन्फ़िगरेशन

apigee-monit, कॉम्पोनेंट कॉन्फ़िगरेशन का इस्तेमाल यह तय करने के लिए करता है कि किन कॉम्पोनेंट की निगरानी करनी है, कॉम्पोनेंट के किन पहलुओं की जांच करनी है, और फ़ेल होने पर क्या कार्रवाई करनी है.

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

apigee-monit किसी कॉम्पोनेंट के अलग-अलग पहलुओं की जांच करता है. यह इस बात पर निर्भर करता है कि वह किस कॉम्पोनेंट की जांच कर रहा है. नीचे दी गई टेबल में बताया गया है कि apigee-monit हर कॉम्पोनेंट के लिए क्या जांच करता है. साथ ही, आपको यह भी पता चलता है कि हर कॉम्पोनेंट के लिए कॉम्पोनेंट कॉन्फ़िगरेशन कहां पर है. ध्यान दें कि कुछ कॉम्पोनेंट एक ही कॉन्फ़िगरेशन फ़ाइल में बताए जाते हैं और दूसरे कॉम्पोनेंट के अपने कॉन्फ़िगरेशन होते हैं.

इस उदाहरण में, edge-router कॉम्पोनेंट का डिफ़ॉल्ट कॉम्पोनेंट कॉन्फ़िगरेशन दिखाया गया है:

check host edge-router with address localhost
  restart program = "/opt/apigee/apigee-service/bin/apigee-service edge-router monitrestart"
  if failed host 10.1.1.0 port 8081 and protocol http
    and request "/v1/servers/self/uuid"
    with timeout 15 seconds
    for 2 times within 3 cycles
  then restart

  if failed port 15999 and protocol http
    and request "/v1/servers/self"
    and status < 600
    with timeout 15 seconds
    for 2 times within 3 cycles
  then restart

नीचे दिए गए उदाहरण में, क्लासिक यूज़र इंटरफ़ेस (यूआई) (edge-ui) कॉम्पोनेंट का डिफ़ॉल्ट कॉन्फ़िगरेशन दिखाया गया है:

check process edge-ui
 with pidfile /opt/apigee/var/run/edge-ui/edge-ui.pid
 start program = "/opt/apigee/apigee-service/bin/apigee-service edge-ui start" with timeout 55 seconds
 stop program = "/opt/apigee/apigee-service/bin/apigee-service edge-ui stop"

यह क्लासिक यूज़र इंटरफ़ेस (यूआई) पर लागू होता है, न कि उस नए Edge यूज़र इंटरफ़ेस (यूआई) पर जिसके कॉम्पोनेंट का नाम edge-management-ui है.

आपके पास Private Cloud कॉम्पोनेंट के लिए, किसी भी Apigee Edge के डिफ़ॉल्ट कॉम्पोनेंट के कॉन्फ़िगरेशन को बदलने का विकल्प नहीं होता है. हालांकि, बाहरी सेवाओं के लिए अपने कॉम्पोनेंट कॉन्फ़िगरेशन जोड़े जा सकते हैं, जैसे कि टारगेट एंडपॉइंट या httpd सेवा. ज़्यादा जानकारी के लिए, Apigee कॉम्पोनेंट का कॉन्फ़िगरेशन देखें.

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

• किसी कॉम्पोनेंट की निगरानी करना और उसे रोकना
• apigee-monit को रोकें, शुरू करें, और बंद करें

apigee-monit इंस्टॉल करें

apigee-monit डिफ़ॉल्ट रूप से इंस्टॉल नहीं होता है. Private Cloud के लिए Apigee Edge के 4.19.01 या उसके बाद के वर्शन को अपग्रेड या इंस्टॉल करने के बाद, इसे मैन्युअल तरीके से इंस्टॉल किया जा सकता है.

इस सेक्शन में, काम करने वाले प्लैटफ़ॉर्म पर apigee-monit इंस्टॉल करने का तरीका बताया गया है.

apigee-monit को uninstalling के बारे में जानने के लिए, अनइंस्टॉल करें apigee-monit देखें.

काम करने वाले प्लैटफ़ॉर्म पर apigee-monit इंस्टॉल करें

इस सेक्शन में, काम करने वाले प्लैटफ़ॉर्म पर apigee-monit इंस्टॉल करने का तरीका बताया गया है.

काम करने वाले प्लैटफ़ॉर्म पर apigee-monit इंस्टॉल करने के लिए:

1. apigee-monit को इस निर्देश की मदद से इंस्टॉल करें:

   /opt/apigee/apigee-service/bin/apigee-service apigee-monit install

2. apigee-monit को नीचे दिए गए निर्देश के साथ कॉन्फ़िगर करें:

   /opt/apigee/apigee-service/bin/apigee-service apigee-monit configure

3. apigee-monit को इस निर्देश के साथ शुरू करें:

   /opt/apigee/apigee-service/bin/apigee-service apigee-monit start

4. अपने क्लस्टर के हर नोड पर यह प्रक्रिया दोहराएं.

कॉम्पोनेंट की निगरानी करना बंद और शुरू करें

किसी वजह से जब कोई सेवा बंद हो जाती है, तो apigee-monit उसे फिर से चालू करने की कोशिश करता है.

अगर आपको किसी कॉम्पोनेंट को मकसद बंद करना है, तो इससे समस्या हो सकती है. उदाहरण के लिए, हो सकता है कि आपको किसी कॉम्पोनेंट का बैक अप लेने या उसे अपग्रेड करने की ज़रूरत पड़ने पर, उसे रोकना पड़े. अगर बैकअप या अपग्रेड के दौरान apigee-monit सेवा को फिर से शुरू करता है, तो आपकी रखरखाव प्रक्रिया में रुकावट आ सकती है. इस वजह से हो सकता है कि यह काम न करे.

नीचे दिए गए सेक्शन में कॉम्पोनेंट की निगरानी को रोकने के विकल्प दिखाए गए हैं.

किसी कॉम्पोनेंट को बंद करना और उसकी निगरानी करना बंद करना

किसी कॉम्पोनेंट को बंद करने और उसकी निगरानी बंद करने के लिए, यह कमांड चलाएं:

/opt/apigee/apigee-service/bin/apigee-service apigee-monit stop-component -c component_name

• apigee-cassandra (कैसंड्रा)
• apigee-openldap (OpenLDAP)
• apigee-postgresql (PostgreSQL डेटाबेस)
• apigee-qpidd (सवाल और जवाब)
• apigee-sso (Edge एसएसओ)
• apigee-zookeeper (ZooKeeper)
• edge-management-server (मैनेजमेंट सर्वर)
• edge-management-ui (नया Edge यूज़र इंटरफ़ेस (यूआई))
• edge-message-processor (मैसेज प्रोसेस करने वाला)
• edge-postgres-server (पोस्टग्रेस सर्वर)
• edge-qpid-server (Qpid सर्वर)
• edge-router (एज राऊटर)
• edge-ui (क्लासिक यूज़र इंटरफ़ेस (यूआई))

ध्यान दें कि stop-component के लिए "सभी" मान्य विकल्प नहीं है. stop-component से, एक बार में सिर्फ़ एक कॉम्पोनेंट को बंद किया जा सकता है और उसकी निगरानी नहीं की जा सकती.

कॉम्पोनेंट को फिर से चालू करने और मॉनिटर करने की प्रोसेस फिर से शुरू करने के लिए, यह कमांड चलाएं:

/opt/apigee/apigee-service/bin/apigee-service apigee-monit start-component -c component_name

ध्यान दें कि start-component के लिए "सभी" मान्य विकल्प नहीं है.

सभी कॉम्पोनेंट को बंद करने और उनकी निगरानी बंद करने के तरीके के बारे में जानने के लिए, सभी कॉम्पोनेंट को बंद करें और उनकी निगरानी बंद करें लेख देखें.

किसी कॉम्पोनेंट की निगरानी न करें (लेकिन उसे रोकें नहीं)

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

/opt/apigee/apigee-service/bin/apigee-service apigee-monit unmonitor -c component_name

• apigee-cassandra (कैसंड्रा)
• apigee-openldap (OpenLDAP)
• apigee-postgresql (PostgreSQL डेटाबेस)
• apigee-qpidd (सवाल और जवाब)
• apigee-sso (Edge एसएसओ)
• apigee-zookeeper (ZooKeeper)
• edge-management-server (मैनेजमेंट सर्वर)
• edge-management-ui (नया Edge यूज़र इंटरफ़ेस (यूआई))
• edge-message-processor (मैसेज प्रोसेस करने वाला)
• edge-postgres-server (पोस्टग्रेस सर्वर)
• edge-qpid-server (Qpid सर्वर)
• edge-router (एज राऊटर)
• edge-ui (क्लासिक यूज़र इंटरफ़ेस (यूआई))

कॉम्पोनेंट की निगरानी फिर से शुरू करने के लिए, नीचे दिया गया निर्देश दें:

/opt/apigee/apigee-service/bin/apigee-service apigee-monit monitor -c component_name

सभी कॉम्पोनेंट को मॉनिटर न करें (लेकिन उन्हें न रोकें)

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

/opt/apigee/apigee-service/bin/apigee-service apigee-monit unmonitor -c all

सभी कॉम्पोनेंट की निगरानी फिर से शुरू करने के लिए, यह कमांड चलाएं:

/opt/apigee/apigee-service/bin/apigee-service apigee-monit monitor -c all

सभी कॉम्पोनेंट को बंद करें और उनकी निगरानी हटाएं

सभी कॉम्पोनेंट को रोकने और उनकी निगरानी बंद करने के लिए, ये निर्देश दें:

/opt/apigee/apigee-service/bin/apigee-service apigee-monit unmonitor -c all
/opt/apigee/apigee-service/bin/apigee-all stop

सभी कॉम्पोनेंट को फिर से चालू करने और मॉनिटर करने की प्रोसेस फिर से शुरू करने के लिए, इन निर्देशों का पालन करें:

/opt/apigee/apigee-service/bin/apigee-all start
/opt/apigee/apigee-service/bin/apigee-service apigee-monit monitor -c all

सभी कॉम्पोनेंट की निगरानी करने की सुविधा बंद करने के लिए, apigee-monit को बंद करें, जैसा कि apigee-monit में है, और बंद करें में बताया गया है.

apigee-monit को बंद करना, शुरू करना, और बंद करना

किसी भी अन्य सेवा की तरह, आपके पास apigee-service कमांड का इस्तेमाल करके apigee-monit को रोकने और शुरू करने का विकल्प होता है. इसके अलावा, apigee-monit, unmonitor कमांड के साथ काम करता है. इससे आपको कॉम्पोनेंट की निगरानी कुछ समय के लिए बंद करने की सुविधा मिलती है.

apigee-monit को बंद करो

apigee-monit को रोकने के लिए, नीचे दिए गए निर्देश का इस्तेमाल करें:

/opt/apigee/apigee-service/bin/apigee-service apigee-monit stop

apigee-monit चालू करें

apigee-monit को शुरू करने के लिए, इस निर्देश का इस्तेमाल करें:

/opt/apigee/apigee-service/bin/apigee-service apigee-monit start

apigee-monit बंद करें

इस निर्देश का इस्तेमाल करके, नोड पर मौजूद सभी कॉम्पोनेंट की निगरानी करना निलंबित किया जा सकता है:

/opt/apigee/apigee-service/bin/apigee-service apigee-monit unmonitor -c all

इसके अलावा, अनइंस्टॉल करें apigee-monit में बताए गए तरीके से, apigee-monit को नोड से अनइंस्टॉल करके हमेशा के लिए बंद किया जा सकता है.

apigee-monit अनइंस्टॉल करें

apigee-monit को अनइंस्टॉल करने के लिए:

1. अगर आपने apigee-monit को मॉनिटर करने के लिए cron जॉब सेट अप किया है, तो apigee-monit को अनइंस्टॉल करने से पहले, cron जॉब को हटाएं:

   sudo rm /etc/cron.d/apigee-monit.cron

2. apigee-monit को इस निर्देश से बंद करें:

   /opt/apigee/apigee-service/bin/apigee-service apigee-monit stop

3. नीचे दिए गए निर्देश की मदद से, apigee-monit को अनइंस्टॉल करें:

   /opt/apigee/apigee-service/bin/apigee-service apigee-monit uninstall

4. अपने क्लस्टर के हर नोड पर यह प्रक्रिया दोहराएं.

इंस्टॉल किए गए नए कॉम्पोनेंट पर नज़र रखना

अगर apigee-monit को चलाने वाले किसी नोड में नया कॉम्पोनेंट इंस्टॉल किया जाता है, तो apigee-monit के restart निर्देश को चलाकर उसकी निगरानी की जा सकती है. इससे एक नई monit.conf फ़ाइल जनरेट होती है, जो इसके कॉम्पोनेंट कॉन्फ़िगरेशन में नया कॉम्पोनेंट शामिल करेगी.

नीचे दिया गया उदाहरण, apigee-monit को रीस्टार्ट करता है:

/opt/apigee/apigee-service/bin/apigee-service apigee-monit restart

apigee-monit को पसंद के मुताबिक बनाएं

apigee-monit की अलग-अलग सेटिंग को पसंद के मुताबिक बनाया जा सकता है. इनमें ये सेटिंग शामिल हैं:

1. apigee-monit के लिए डिफ़ॉल्ट कंट्रोल सेटिंग
2. ग्लोबल कॉन्फ़िगरेशन सेटिंग
3. बिना Apigee के कॉम्पोनेंट कॉन्फ़िगरेशन

डिफ़ॉल्ट apigee-monit कंट्रोल सेटिंग

आपके पास apigee-monit को कंट्रोल करने की डिफ़ॉल्ट सेटिंग को पसंद के मुताबिक बनाने का विकल्प होता है. जैसे, स्टेटस की जांच की फ़्रीक्वेंसी और apigee-monit फ़ाइलों की जगह की जानकारी. ऐसा करने के लिए, प्रॉपर्टी फ़ाइल में बदलाव करने के लिए, config वाला कोड तकनीक इस्तेमाल करें. Apigee Edge for Private Cloud को अपग्रेड करने के बाद भी, प्रॉपर्टी फ़ाइलें बनी रहेंगी.

यहां दी गई टेबल में, apigee-monit की उन डिफ़ॉल्ट कंट्रोल सेटिंग के बारे में बताया गया है जिन्हें पसंद के मुताबिक बनाया जा सकता है:

conf_monit_httpd_allow=allow username:"password"\nallow 127.0.0.1

apigee-monit की डिफ़ॉल्ट कंट्रोल सेटिंग को पसंद के मुताबिक बनाने के लिए:

1. इस फ़ाइल में बदलाव करें:

   /opt/apigee/customer/application/monit.properties

   अगर फ़ाइल मौजूद नहीं है, तो इसे बनाएं और मालिक को "apigee" उपयोगकर्ता के तौर पर सेट करें:

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

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

2. प्रॉपर्टी की वैल्यू को नई वैल्यू से बदलें या सेट करें.

   उदाहरण के लिए, लॉग फ़ाइल की जगह को /tmp में बदलने के लिए, नीचे दी गई प्रॉपर्टी को जोड़ें या उसमें बदलाव करें:

   conf_monit_monit_logdir=/tmp/apigee-monit.log

3. अपने बदलावों को monit.properties फ़ाइल में सेव करें.
4. apigee-monit को नीचे दिए गए निर्देश के साथ फिर से कॉन्फ़िगर करें:

   /opt/apigee/apigee-service/bin/apigee-service apigee-monit configure

5. apigee-monit को फिर से लोड करने के लिए, नीचे दिए गए निर्देश का इस्तेमाल करें:

   /opt/apigee/apigee-service/bin/apigee-service apigee-monit reload

   अगर apigee-monit को रीस्टार्ट नहीं किया जा सकता, तो apigee-monit की लॉग फ़ाइलें ऐक्सेस करें में बताए गए तरीके से गड़बड़ियों का पता लगाने के लिए लॉग फ़ाइल देखें.

6. अपने क्लस्टर में मौजूद हर नोड के लिए यह प्रक्रिया दोहराएं.

ग्लोबल कॉन्फ़िगरेशन सेटिंग

apigee-monit के लिए ग्लोबल कॉन्फ़िगरेशन सेटिंग तय की जा सकती हैं. उदाहरण के लिए, अलर्ट के लिए ईमेल सूचनाएं जोड़ी जा सकती हैं. ऐसा करने के लिए, /opt/apigee/data/apigee-monit डायरेक्ट्री में कॉन्फ़िगरेशन फ़ाइल बनाएं और फिर apigee-monit को रीस्टार्ट करें.

apigee-monit के लिए ग्लोबल कॉन्फ़िगरेशन सेटिंग तय करने के लिए:

1. नीचे दी गई जगह पर, कॉम्पोनेंट की नई कॉन्फ़िगरेशन फ़ाइल बनाएं:

   /opt/apigee/data/apigee-monit/filename.conf

   जहां filename कोई मान्य फ़ाइल नाम हो सकता है, सिर्फ़ "monit".

2. नई कॉन्फ़िगरेशन फ़ाइल के मालिक को बदलकर "apigee" उपयोगकर्ता कर दें, जैसा कि नीचे दिए गए उदाहरण में बताया गया है:

   chown apigee:apigee /opt/apigee/data/apigee-monit/my-mail-config.conf

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

   SET MAILSERVER smtp.gmail.com PORT 465
     USERNAME "example-admin@gmail.com" PASSWORD "PASSWORD"
     USING SSL, WITH TIMEOUT 15 SECONDS
   
   SET MAIL-FORMAT {
     from: edge-alerts@example.com
     subject: Monit Alert -- Service: $SERVICE $EVENT on $HOST
   }
   SET ALERT fred@example.com
   SET ALERT nancy@example.com

   ग्लोबल कॉन्फ़िगरेशन विकल्पों की पूरी सूची के लिए, monit दस्तावेज़ देखें.

4. कॉम्पोनेंट कॉन्फ़िगरेशन फ़ाइल में किए गए बदलावों को सेव करें.
5. apigee-monit को फिर से लोड करने के लिए, नीचे दिए गए निर्देश का इस्तेमाल करें:

   /opt/apigee/apigee-service/bin/apigee-service apigee-monit reload

   अगर apigee-monit रीस्टार्ट नहीं होता है, तो apigee-monit की लॉग फ़ाइलें ऐक्सेस करें में बताए गए तरीके से गड़बड़ियों का पता लगाने के लिए लॉग फ़ाइल देखें.

6. अपने क्लस्टर में मौजूद हर नोड के लिए यह प्रक्रिया दोहराएं.

गैर-Apigee कॉम्पोनेंट का कॉन्फ़िगरेशन

आपके पास apigee-monit में अपने खुद के कॉन्फ़िगरेशन जोड़ने का विकल्प है. इससे यह उन सेवाओं की जांच करेगा जो Apigee Edge for Private Cloud का हिस्सा नहीं हैं. उदाहरण के लिए, apigee-monit का इस्तेमाल करके यह देखा जा सकता है कि आपके टारगेट एंडपॉइंट पर अनुरोध भेजकर, आपके एपीआई चल रहे हैं या नहीं.

बिना Apigee कॉम्पोनेंट कॉन्फ़िगरेशन जोड़ने के लिए:

1. नीचे दी गई जगह पर, कॉम्पोनेंट की नई कॉन्फ़िगरेशन फ़ाइल बनाएं:

   /opt/apigee/data/apigee-monit/filename.conf

   जहां filename कोई मान्य फ़ाइल नाम हो सकता है, सिर्फ़ "monit".

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

2. नई कॉन्फ़िगरेशन फ़ाइल के मालिक को बदलकर "apigee" उपयोगकर्ता कर दें, जैसा कि नीचे दिए गए उदाहरण में बताया गया है:

   chown apigee:apigee /opt/apigee/data/apigee-monit/my-config.conf

3. नई फ़ाइल में अपने कस्टम कॉन्फ़िगरेशन जोड़ें. इस उदाहरण में, लोकल सर्वर पर टारगेट एंडपॉइंट की जांच की जाती है:

   CHECK HOST localhost_validate_test WITH ADDRESS localhost
     IF FAILED
       PORT 15999
       PROTOCOL http
       REQUEST "/validate__test"
       CONTENT = "Server Ready"
       FOR 2 times WITHIN 3 cycles
     THEN alert

   संभावित कॉन्फ़िगरेशन सेटिंग की पूरी सूची के लिए, मॉनिट दस्तावेज़ देखें.

4. कॉन्फ़िगरेशन फ़ाइल में अपने बदलाव सेव करें.
5. apigee-monit को फिर से लोड करने के लिए, नीचे दिए गए निर्देश का इस्तेमाल करें:

   /opt/apigee/apigee-service/bin/apigee-service apigee-monit reload

   अगर apigee-monit रीस्टार्ट नहीं होता है, तो apigee-monit की लॉग फ़ाइलें ऐक्सेस करें में बताए गए तरीके से गड़बड़ियों का पता लगाने के लिए लॉग फ़ाइल देखें.

6. अपने क्लस्टर में मौजूद हर नोड के लिए यह प्रक्रिया दोहराएं.

ध्यान दें कि यह सिर्फ़ नॉन-एज कॉम्पोनेंट के लिए है. आप Edge के कॉम्पोनेंट के लिए कॉम्पोनेंट कॉन्फ़िगरेशन को पसंद के मुताबिक नहीं बना सकते.

apigee-monit लॉग फ़ाइलें ऐक्सेस करें

apigee-monit सभी गतिविधियों को लॉग करता है. इनमें इवेंट, रीस्टार्ट, कॉन्फ़िगरेशन में बदलाव, और सूचनाओं शामिल हैं.

लॉग फ़ाइल की डिफ़ॉल्ट जगह यह है:

/opt/apigee/var/log/apigee-monit/apigee-monit.log

डिफ़ॉल्ट जगह को बदलने के लिए, apigee-monit कंट्रोल सेटिंग को पसंद के मुताबिक बनाएं.

लॉग फ़ाइल की एंट्री में इस तरह के फ़ॉर्मैट होते हैं:

'edge-message-processor' trying to restart
[UTC Dec 14 16:20:42] info     : 'edge-message-processor' trying to restart
'edge-message-processor' restart: '/opt/apigee/apigee-service/bin/apigee-service edge-message-processor monitrestart'

apigee-monit लॉग फ़ाइल एंट्री का फ़ॉर्मैट पसंद के मुताबिक नहीं बनाया जा सकता.

apigee-monit के साथ एग्रीगेट किया गया स्टेटस देखें

apigee-monit में नीचे दिए गए निर्देश शामिल होते हैं, जो आपको नोड पर मौजूद घटकों के बारे में एग्रीगेट की गई स्थिति की जानकारी देते हैं:

/opt/apigee/apigee-service/bin/apigee-service apigee-monit report

/opt/apigee/apigee-service/bin/apigee-service apigee-monit summary

आगे के सेक्शन में, इन निर्देशों के बारे में ज़्यादा जानकारी दी गई है.

रिपोर्ट

report कमांड से आपको एक रोल-अप खास जानकारी मिलती है. इससे यह पता चलता है कि कितने कॉम्पोनेंट अभी शुरू हो रहे हैं, कितने कॉम्पोनेंट अभी शुरू हो रहे हैं या कितने मौजूदा कॉम्पोनेंट किसी नोड पर निगरानी नहीं किए जा रहे हैं. नीचे दिए गए उदाहरण में, report कमांड को शुरू किया गया है:

/opt/apigee/apigee-service/bin/apigee-service apigee-monit report

नीचे दिए गए उदाहरण में, AIO (ऑल-इन-वन) कॉन्फ़िगरेशन पर report आउटपुट दिखाया गया है:

/opt/apigee/apigee-service/bin/apigee-service apigee-monit report
up:            11 (100.0%)
down:           0 (0.0%)
initialising:   0 (0.0%)
unmonitored:    1 (8.3%)
total:         12 services

इस उदाहरण में, apigee-monit ने 12 में से 11 सेवाओं के 'ऊपर' के तौर पर रिपोर्ट किया है. फ़िलहाल, एक सेवा की निगरानी नहीं की जा रही है.

पहली बार report निर्देश लागू करने पर, आपको Connection refused गड़बड़ी दिख सकती है. इस मामले में, conf_monit_monit_delay_time प्रॉपर्टी की अवधि तक इंतज़ार करें और फिर से कोशिश करें.

खास जानकारी

summary कमांड हर कॉम्पोनेंट को सूची में शामिल करता है और उसका स्टेटस बताता है. यहां दिए गए उदाहरण में, summary कमांड को शुरू किया गया है:

/opt/apigee/apigee-service/bin/apigee-service apigee-monit summary

नीचे दिए गए उदाहरण में, AIO (ऑल-इन-वन) कॉन्फ़िगरेशन पर summary आउटपुट दिखाया गया है:

/opt/apigee/apigee-service/bin/apigee-service apigee-monit summary
Monit 5.25.1 uptime: 4h 20m
 Service Name                     Status                      Type
 host_name                        OK                          System
 apigee-zookeeper                 OK                          Process
 apigee-cassandra                 OK                          Process
 apigee-openldap                  OK                          Process
 apigee-qpidd                     OK                          Process
 apigee-postgresql                OK                          Process
 edge-ui                          OK                          Process
 edge-qpid-server                 OK                          Remote Host
 edge-postgres-server             OK                          Remote Host
 edge-management-server           OK                          Remote Host
 edge-router                      OK                          Remote Host
 edge-message-processor           OK                          Remote Host

अगर पहली बार summary कमांड लागू करते समय आपको Connection refused गड़बड़ी मिलती है, तो conf_monit_monit_delay_time प्रॉपर्टी के कुल समय का इंतज़ार करें और फिर से कोशिश करें.

apigee-monit पर नज़र रखें

हर नोड पर apigee-monit चल रहा है या नहीं, इसकी नियमित तौर पर जांच करना सबसे सही तरीका है.

यह देखने के लिए कि apigee-monit चल रहा है या नहीं, नीचे दिए गए निर्देश का इस्तेमाल करें:

/opt/apigee/apigee-service/bin/apigee-service apigee-monit monitor_monit

Apigee आपको सुझाव देता है कि आप apigee-monit को चलाने वाले हर नोड पर समय-समय पर यह निर्देश जारी करें. ऐसा करने का एक तरीका यह है कि आप cron जैसी सुविधा का इस्तेमाल करें. यह सुविधा, पहले से तय किए गए समय के अंतराल पर शेड्यूल किए गए टास्क करती है.

cron का इस्तेमाल करके, apigee-monit को मॉनिटर करने के लिए:

1. apigee-monit.cron डायरेक्ट्री को /etc/cron.d डायरेक्ट्री में कॉपी करके, cron के लिए सहायता जोड़ें, जैसा कि नीचे दिए गए उदाहरण में दिखाया गया है:

   cp /opt/apigee/apigee-monit/cron/apigee-monit.cron /etc/cron.d/

2. apigee-monit.cron फ़ाइल में बदलाव करने के लिए, उसे खोलें.

   apigee-monit.cron फ़ाइल, cron जॉब के बारे में जानकारी देती है. साथ ही, यह भी बताती है कि काम को किस फ़्रीक्वेंसी पर लागू किया जाना है. इस उदाहरण में डिफ़ॉल्ट वैल्यू दिखाई गई हैं:

   # Cron entry to check if monit process is running. If not start it
   */2 * * * * root /opt/apigee/apigee-service/bin/apigee-service apigee-monit monitor_monit

   यह फ़ाइल नीचे दिए गए सिंटैक्स का इस्तेमाल करती है, जिसमें पहले पांच फ़ील्ड वह समय तय करते हैं जब apigee-monit अपनी कार्रवाई करता है:

   min hour day_of_month month day_of_week task_to_execute

   उदाहरण के लिए, डिफ़ॉल्ट तौर पर, */2 * * * * लागू होने का समय, cron को हर दो मिनट में apigee-monit प्रोसेस की जांच करने का निर्देश देता है.

   आप cron काम को प्रति मिनट एक से ज़्यादा बार नहीं कर सकते.

   cron का इस्तेमाल करने के बारे में ज़्यादा जानकारी के लिए, अपने सर्वर ओएस के दस्तावेज़ या मैन पेज देखें.

3. cron की सेटिंग में बदलाव करें, ताकि वे आपके संगठन की नीतियों के मुताबिक हों. उदाहरण के लिए, हर पांच मिनट में एक्ज़ीक्यूशन की फ़्रीक्वेंसी बदलने के लिए, जॉब डेफ़िनिशन को इस पर सेट करें:

   */5 * * * * root /opt/apigee/apigee-service/bin/apigee-service apigee-monit monitor_monit

4. apigee-monit.cron फ़ाइल सेव करें.
5. अपने क्लस्टर में मौजूद हर नोड के लिए यह प्रक्रिया दोहराएं.

अगर cron ने apigee-monit देखना शुरू नहीं किया है, तो देखें कि:

• cron जॉब की परिभाषा के बाद एक खाली लाइन है.
• फ़ाइल में सिर्फ़ एक cron जॉब है. (टिप्पणी की गई लाइनों को गिना नहीं जाता.)

अगर आपको apigee-monit को बंद करना है या कुछ समय के लिए बंद करना है, तो आपको यह cron जॉब भी बंद करना होगा. ऐसा न करने पर, cron, apigee-monit को रीस्टार्ट कर देगा.

cron को बंद करने के लिए, इनमें से कोई एक काम करें:

• /etc/cron.d/apigee-monit.cron फ़ाइल मिटाएं:

  sudo rm /etc/cron.d/apigee-monit.cron

  अगर आप बाद में cron को apigee-monit देखने के लिए फिर से चालू करना चाहें, तो आपको इसे दोबारा कॉपी करना होगा.

  OR

• /etc/cron.d/apigee-monit.cron फ़ाइल में बदलाव करें और लाइन की शुरुआत में "#" जोड़कर जॉब की परिभाषा में टिप्पणी करें; उदाहरण के लिए:

  # 10 * * * * root /opt/apigee/apigee-service/bin/apigee-service apigee-monit monitor_monit