मॉनिटर करने का तरीका

इस दस्तावेज़ में, उन कॉम्पोनेंट की निगरानी करने के तरीकों के बारे में बताया गया है जिन्हें Apigee Edge for Private Cloud के ऑन-प्राइमिस डिप्लॉयमेंट की मदद से इस्तेमाल किया जा सकता है.

खास जानकारी

Edge में, सेवाओं के बारे में जानकारी पाने और उनकी स्थिति देखने के कई तरीके उपलब्ध हैं. यहां दी गई टेबल में, ज़रूरी शर्तें पूरी करने वाली हर सेवा के लिए, जांच के अलग-अलग टाइप की जानकारी दी गई है:

Mgmt API
कॉम्पोनेंट मेमोरी का इस्तेमाल [JMX*] सेवा की जांच करना उपयोगकर्ता/संगठन/ डिप्लॉयमेंट का स्टेटस axstatus डेटाबेस की जांच apigee-service में डेटा सोर्स का स्टेटस apigee-monit**
मैनेजमेंट सर्वर
मैसेज प्रोसेसर
राऊटर
Qpid
Postgres
ज़्यादा जानकारी ज़्यादा जानकारी ज़्यादा जानकारी ज़्यादा जानकारी ज़्यादा जानकारी ज़्यादा जानकारी ज़्यादा जानकारी

* JMX का इस्तेमाल करने से पहले, आपको इसे चालू करना होगा. इसके बारे में JMX चालू करना में बताया गया है.

** apigee-monit सेवा यह जांच करती है कि कोई कॉम्पोनेंट चालू है या नहीं. अगर वह चालू नहीं है, तो उसे रीस्टार्ट करने की कोशिश की जाएगी. ज़्यादा जानकारी के लिए, apigee-monit की मदद से, अपने-आप ठीक होने की सुविधा देखें.

पोर्ट और कॉन्फ़िगरेशन फ़ाइलों की निगरानी करना

हर कॉम्पोनेंट, अलग-अलग पोर्ट पर Java Management Extensions (JMX) और मैनेजमेंट एपीआई मॉनिटरिंग कॉल के साथ काम करता है. यहां दी गई टेबल में, हर तरह के सर्वर के लिए JMX और मैनेजमेंट एपीआई पोर्ट और कॉन्फ़िगरेशन फ़ाइल की जगहों की सूची दी गई है:

कॉम्पोनेंट JMX पोर्ट Management API पोर्ट कॉन्फ़िगरेशन फ़ाइल की जगह
मैनेजमेंट सर्वर 1099 8080 $APIGEE_ROOT/customer/application/management-server.properties
मैसेज प्रोसेसर 1101 8082 $APIGEE_ROOT/customer/application/message-processor.properties
राऊटर 1100 8081 $APIGEE_ROOT/customer/application/router.properties
Qpid 1102 8083 $APIGEE_ROOT/customer/application/qpid-server.properties
Postgres 1103 8084 $APIGEE_ROOT/customer/application/postgres-server.properties

कॉम्पोनेंट को मॉनिटर करने के लिए JMX का इस्तेमाल करना

नीचे दिए गए सेक्शन में, Edge कॉम्पोनेंट को मॉनिटर करने के लिए JMX का इस्तेमाल करने का तरीका बताया गया है.

JMX चालू करना

पुष्टि या एसएसएल आधारित कम्यूनिकेशन के बिना JMX को चालू करने के लिए, यह तरीका अपनाएं. ध्यान दें: प्रोडक्शन सिस्टम में, सुरक्षा के लिए एन्क्रिप्ट (सुरक्षित) की गई पुष्टि और एसएसएल, दोनों को चालू किया जाना चाहिए.

  1. सही कॉन्फ़िगरेशन फ़ाइल में बदलाव करें ( कॉन्फ़िगरेशन फ़ाइल का रेफ़रंस देखें). अगर कॉन्फ़िगरेशन फ़ाइल मौजूद नहीं है, तो उसे बनाएं.
    conf_system_jmxremote_enable=true
  2. कॉन्फ़िगरेशन फ़ाइल सेव करें और पक्का करें कि उसका मालिकाना हक apigee:apigee के पास हो.
  3. सही Edge कॉम्पोनेंट को रीस्टार्ट करें
    apigee-service edge-management-server restart

JMX को बंद करने के लिए, प्रॉपर्टी conf_system_jmxremote_enable को हटाएं या इसकी वैल्यू को false पर सेट करें. इसके बाद, सही Edge कॉम्पोनेंट को रीस्टार्ट करें.

JMX में पुष्टि करना

Edge for Private Cloud, फ़ाइलों में सेव की गई जानकारी का इस्तेमाल करके, पासवर्ड के आधार पर पुष्टि करने की सुविधा देता है. ज़्यादा सुरक्षा के लिए, पासवर्ड को हैश के तौर पर सेव किया जा सकता है.

  1. किसी edge-* कॉम्पोनेंट में JMX पुष्टि करने की सुविधा चालू करने के लिए, सही कॉन्फ़िगरेशन फ़ाइल में बदलाव करें ( कॉन्फ़िगरेशन फ़ाइल का रेफ़रंस देखें). अगर कॉन्फ़िगरेशन फ़ाइल मौजूद नहीं है, तो उसे बनाएं:
    conf_system_jmxremote_enable=true
    conf_system_jmxremote_authenticate=true
    conf_system_jmxremote_encrypted_auth=true
    conf_system_jmxremote_access_file=/opt/apigee/customer/application/management-server/jmxremote.access
    conf_system_jmxremote_password_file=/opt/apigee/customer/application/management-server/jmxremote.password
    कॉन्फ़िगरेशन फ़ाइल सेव करें और पक्का करें कि उसका मालिकाना हक apigee:apigee के पास हो.
  2. पासवर्ड का SHA256 हैश बनाएं:
    echo -n '' | openssl dgst -sha256
  3. JMX उपयोगकर्ता क्रेडेंशियल के साथ jmxremote.password फ़ाइल बनाएं:
    1. अपनी $JAVA_HOME डायरेक्ट्री से, इन फ़ाइलों को डायरेक्ट्री /opt/apigee/customer/application/<component>/ में कॉपी करें:
      cp ${JAVA_HOME}/lib/management/jmxremote.password.template $APIGEE_ROOT/customer/application/management-server/jmxremote.password
    2. फ़ाइल में बदलाव करें और नीचे दिए गए सिंटैक्स का इस्तेमाल करके, अपना JMX उपयोगकर्ता नाम और पासवर्ड जोड़ें:
      USERNAME <HASH-PASSWORD>
    3. पक्का करें कि फ़ाइल का मालिकाना हक apigee के पास हो और फ़ाइल का मोड 400 हो:
      chown apigee:apigee $APIGEE_ROOT/customer/application/management-server/jmxremote.password
      chmod 400 $APIGEE_ROOT/customer/application/management-server/jmxremote.password
  4. JMX उपयोगकर्ता की अनुमतियों के साथ jmxremote.access फ़ाइल बनाएं:
    1. अपनी $JAVA_HOME डायरेक्ट्री से, इन फ़ाइलों को डायरेक्ट्री /opt/apigee/customer/application/<component>/
      
      cp ${JAVA_HOME}/lib/management/jmxremote.access$APIGEE_ROOT/customer/application/management-server/jmxremote.password/jmxremote.access
      में कॉपी करें
    2. फ़ाइल में बदलाव करें और अपना JMX उपयोगकर्ता नाम जोड़ें. इसके बाद, अनुमति (READONLY/READWRITE) जोड़ें
      USERNAME READONLY
    3. पक्का करें कि फ़ाइल का मालिकाना हक apigee के पास हो और फ़ाइल का मोड 400 हो:
      chown apigee:apigee $APIGEE_ROOT/customer/application/management-server/jmxremote.password
      
      chmod 400 $APIGEE_ROOT/customer/application/management-server/jmxremote.access
  5. सही Edge कॉम्पोनेंट को रीस्टार्ट करें:
    apigee-service edge-management-server restart

JMX पुष्टि करने की सुविधा बंद करने के लिए, प्रॉपर्टी conf_system_jmxremote_authenticate को हटाएं या उसकी वैल्यू को false पर सेट करें. इसके बाद, सही Edge कॉम्पोनेंट को रीस्टार्ट करें.

JMX में एसएसएल

किसी edge-* कॉम्पोनेंट में एसएसएल पर आधारित JMX को चालू करने के लिए:

  1. सही कॉन्फ़िगरेशन फ़ाइल में बदलाव करें ( कॉन्फ़िगरेशन फ़ाइल का रेफ़रंस देखें). अगर कॉन्फ़िगरेशन फ़ाइल मौजूद नहीं है, तो उसे बनाएं:
    conf_system_jmxremote_enable=true
    conf_system_jmxremote_ssl=true
    conf_system_javax_net_ssl_keystore=/opt/apigee/customer/application/management-server/jmxremote.keystore
    conf_system_javax_net_ssl_keystorepassword=<keystore-password>
    कॉन्फ़िगरेशन फ़ाइल सेव करें और पक्का करें कि उसका मालिकाना हक apigee:apigee के पास हो.
  2. सर्वर पासकोड वाली एक पासकोड की दुकान तैयार करें और उसे ऊपर दिए गए कॉन्फ़िगरेशन conf_system_javax_net_ssl_keystore में दिए गए पाथ पर डालें. पक्का करें कि apigee:apigee, पासकोड वाली फ़ाइल को पढ़ सके.
  3. सही Edge कॉम्पोनेंट को रीस्टार्ट करें:
    apigee-service edge-management-server restart

एसएसएल पर आधारित JMX को बंद करने के लिए, प्रॉपर्टी conf_system_jmxremote_ssl को हटाएं या वैल्यू को false पर सेट करें. सही Edge कॉम्पोनेंट को रीस्टार्ट करें.

Jconsole की मदद से निगरानी करना

jconsole की मदद से मॉनिटर करने के निर्देश वही रहेंगे जो https://docs.apigee.com/private-cloud/v4.52.01/how-monitor#jconsole में बताए गए हैं.

एक लाइन जोड़ी जा सकती है कि “अगर JMX के लिए SSL चालू है, तो jconsole को ट्रस्टस्टोर और ट्रस्टस्टोर पासवर्ड के साथ शुरू करना होगा.” रेफ़रंस: https://docs.oracle.com/javase/8/docs/technotes/guides/management/jconsole.html

JConsole की मदद से मॉनिटर करना

प्रोसेस के आंकड़ों को मैनेज और मॉनिटर करने के लिए, JConsole (JMX के साथ काम करने वाला टूल) का इस्तेमाल करें. JConsole की मदद से, अपने सर्वर से एक्सपोज़ किए गए JMX आंकड़ों का इस्तेमाल किया जा सकता है और उन्हें ग्राफ़िकल इंटरफ़ेस में दिखाया जा सकता है. ज़्यादा जानकारी के लिए, JConsole का इस्तेमाल करना लेख पढ़ें.

अगर JMX के लिए एसएसएल चालू है, तो आपको ट्रस्टस्टोर और ट्रस्टस्टोर पासवर्ड के साथ JConsole शुरू करना होगा. JConsole का इस्तेमाल करना देखें.

JConsole, JMX के ज़रिए ऑफ़र किए गए JMX एट्रिब्यूट (एमबीीन) को मॉनिटर करने के लिए, यहां दिए गए सेवा यूआरएल का इस्तेमाल करता है:

service:jmx:rmi:///jndi/rmi://IP_address:port_number/jmxrmi

कहां:

  • IP_address, उस सर्वर का आईपी पता है जिसे आपको मॉनिटर करना है.
  • port_number, उस सर्वर का JMX पोर्ट नंबर है जिसे आपको मॉनिटर करना है.

उदाहरण के लिए, मैनेजमेंट सर्वर को मॉनिटर करने के लिए, नीचे दिया गया कमांड दें. यह मानते हुए कि सर्वर का आईपी पता 216.3.128.12 है:

service:jmx:rmi:///jndi/rmi://216.3.128.12:1099/jmxrmi

ध्यान दें कि इस उदाहरण में पोर्ट 1099 का इस्तेमाल किया गया है, जो मैनेजमेंट सर्वर का JMX पोर्ट है. अन्य पोर्ट के लिए, JMX और Management API मॉनिटरिंग पोर्ट देखें.

नीचे दी गई टेबल में, सामान्य JMX आंकड़े दिखाए गए हैं:

JMX एमबीईन JMX एट्रिब्यूट

मेमोरी

HeapMemoryUsage

NonHeapMemoryUsage

इस्तेमाल

कॉन्फ़िगरेशन फ़ाइल का रेफ़रंस

नीचे दिए गए सेक्शन में, JMX से जुड़े कॉन्फ़िगरेशन के लिए, Edge कॉम्पोनेंट कॉन्फ़िगरेशन फ़ाइलों में किए जाने वाले बदलावों के बारे में बताया गया है. ज़्यादा जानकारी के लिए, पोर्ट और कॉन्फ़िगरेशन फ़ाइलों को मॉनिटर करना देखें.

सही कॉम्पोनेंट की कॉन्फ़िगरेशन फ़ाइल में जोड़ा जाने वाला JMX कॉन्फ़िगरेशन

  • एज-कॉम्पोनेंट पर JMX एजेंट चालू करें. डिफ़ॉल्ट रूप से गलत.
    conf_system_jmxremote_enable=true

पासवर्ड के आधार पर पुष्टि करने के लिए कॉन्फ़िगरेशन

  • पासवर्ड के आधार पर पुष्टि करने की सुविधा चालू करें. डिफ़ॉल्ट रूप से गलत.
    conf_system_jmxremote_authenticate=true
  • फ़ाइल को ऐक्सेस करने का पाथ. इसका मालिकाना हक सिर्फ़ Apigee उपयोगकर्ता के पास होना चाहिए और उसे सिर्फ़ वह पढ़ सकता है.
    conf_system_jmxremote_access_file=/opt/apigee/customer/application/management-server/jmxremote.access
  • पासवर्ड फ़ाइल का पाथ. इसका मालिकाना हक सिर्फ़ Apigee उपयोगकर्ता के पास होना चाहिए और उसे सिर्फ़ वह पढ़ सकता है.
    conf_system_jmxremote_password_file=/opt/apigee/customer/application/management-server/jmxremote.password
  • पासवर्ड को एन्क्रिप्ट (सुरक्षित) करके सेव करने की सुविधा चालू करें. डिफ़ॉल्ट रूप से गलत.
    conf_system_jmxremote_encrypted_auth=true

एसएसएल पर आधारित JMX के लिए कॉन्फ़िगरेशन

  • JMX कम्यूनिकेशन के लिए एसएसएल चालू करें. डिफ़ॉल्ट रूप से गलत.
    conf_system_jmxremote_ssl=true
  • कीस्टोर का पाथ. इसका मालिकाना हक सिर्फ़ Apigee उपयोगकर्ता के पास होना चाहिए और उसे सिर्फ़ वह पढ़ सकता है.
    conf_system_javax_net_ssl_keystore=/opt/apigee/customer/application/management-server/jmxremote.keystore
  • कीस्टोर का पासवर्ड:
    conf_system_javax_net_ssl_keystorepassword=changeme

वैकल्पिक JMX कॉन्फ़िगरेशन

सूची में दी गई वैल्यू डिफ़ॉल्ट वैल्यू हैं और इन्हें बदला जा सकता है.

  • JMX पोर्ट. डिफ़ॉल्ट वैल्यू, नीचे दी गई टेबल में दी गई हैं.
    conf_system_jmxremote_port=
  • JMX RMI पोर्ट. डिफ़ॉल्ट रूप से, Java प्रोसेस कोई भी पोर्ट चुन लेगी.
    conf_system_jmxremote_rmi_port=
  • रिमोट स्टब के लिए होस्ट का नाम. localhost का डिफ़ॉल्ट आईपी पता.
    conf_system_java_rmi_server_hostname=
  • एसएसएल की मदद से JMX रजिस्ट्री को सुरक्षित करें. डिफ़ॉल्ट रूप से गलत. यह सिर्फ़ तब लागू होता है, जब एसएसएल चालू हो.
    conf_system_jmxremote_registry_ssl=false

मैनेजमेंट एपीआई की मदद से मॉनिटर करना

Edge में कई एपीआई शामिल हैं. इनका इस्तेमाल करके, अपने सर्वर पर सेवा की जांच की जा सकती है. साथ ही, अपने उपयोगकर्ताओं, संगठनों, और डिप्लॉयमेंट की जांच भी की जा सकती है. इस सेक्शन में इन एपीआई के बारे में बताया गया है.

सेवा की जांच करना

Management API, आपकी सेवाओं से जुड़ी समस्याओं की निगरानी करने और उनका पता लगाने के लिए कई एंडपॉइंट उपलब्ध कराता है. इन एंडपॉइंट में ये शामिल हैं:

एंडपॉइंट ब्यौरा
/servers/self/up

यह जांचता है कि कोई सेवा चल रही है या नहीं. इस एपीआई कॉल के लिए, आपको पुष्टि करने की ज़रूरत नहीं है.

अगर सेवा चल रही है, तो यह एंडपॉइंट यह रिस्पॉन्स दिखाता है:

<ServerField>
  <Up>true</Up>
</ServerField>

अगर सेवा चालू नहीं है, तो आपको इस तरह का जवाब मिलेगा (यह इस बात पर निर्भर करता है कि यह कौनसी सेवा है और आपने इसकी जांच कैसे की है):

curl: Failed connect to localhost:port_number; Connection refused
/servers/self

सेवा के बारे में जानकारी दिखाता है. इसमें ये चीज़ें शामिल हैं:

  • कॉन्फ़िगरेशन प्रॉपर्टी
  • शुरू होने का समय और अप टाइम
  • बिल्ड, आरपीएम, और यूयूआईडी की जानकारी
  • इंटरनल और एक्सटर्नल होस्टनेम और आईपी पता
  • क्षेत्र और पॉड
  • <isUp> प्रॉपर्टी, इससे पता चलता है कि सेवा चल रही है या नहीं

इस एपीआई कॉल के लिए, आपको अपने Apigee एडमिन क्रेडेंशियल की मदद से पुष्टि करनी होगी.

इन एंडपॉइंट का इस्तेमाल करने के लिए, curl जैसी किसी सुविधा को इन निर्देशों का इस्तेमाल करके चालू करें:

curl http://host:port_number/v1/servers/self/up -H "Accept: [application/json|application/xml]"
curl http://host:port_number/v1/servers/self -u username:password -H "Accept: [application/json|application/xml]"

कहां:

  • host उस सर्वर का आईपी पता है जिसकी आपको जांच करनी है. अगर आपने सर्वर में लॉग इन किया है, तो "localhost" का इस्तेमाल किया जा सकता है. अगर ऐसा नहीं है, तो सर्वर का आईपी पता, उपयोगकर्ता नाम, और पासवर्ड डालें.
  • port_number, उस सर्वर का मैनेजमेंट एपीआई पोर्ट है जिसकी आपको जांच करनी है. यह हर तरह के कॉम्पोनेंट के लिए अलग-अलग पोर्ट होता है. उदाहरण के लिए, मैनेजमेंट सर्वर का मैनेजमेंट एपीआई पोर्ट 8080 है. इस्तेमाल किए जाने वाले Management API पोर्ट नंबर की सूची के लिए, देखें JMX और Management API मॉनिटरिंग पोर्ट

रिस्पॉन्स का फ़ॉर्मैट बदलने के लिए, Accept हेडर को "application/json" या "application/xml" के तौर पर सेट किया जा सकता है.

इस उदाहरण में, localhost (पोर्ट 8081) पर राऊटर का स्टेटस मिलता है:

curl http://localhost:8081/v1/servers/self/up -H "Accept: application/xml"

इस उदाहरण में, 216.3.128.12 (पोर्ट 8082) पर मौजूद मैसेज प्रोसेसर के बारे में जानकारी मिलती है:

curl http://216.3.128.12:8082/v1/servers/self -u sysAdminEmail:password
  -H "Accept: application/xml"

उपयोगकर्ता, संगठन, और डिप्लॉयमेंट की स्थिति पर नज़र रखना

मैनेजमेंट सर्वर और मैसेज प्रोसेसर पर, उपयोगकर्ता, संगठन, और डिप्लॉयमेंट की स्थिति पर नज़र रखने के लिए, मैनेजमेंट एपीआई का इस्तेमाल किया जा सकता है. इसके लिए, ये निर्देश दें:

curl http://host:port_number/v1/users -u sysAdminEmail:password
curl http://host:port_number/v1/organizations -u sysAdminEmail:password
curl http://host:port_number/v1/organizations/orgname/deployments -u sysAdminEmail:password

यहां port_number, मैनेजमेंट सर्वर के लिए 8080 या मैसेज प्रोसेसर के लिए 8082 है.

इस कॉल के लिए, आपको अपने सिस्टम एडमिन के उपयोगकर्ता नाम और पासवर्ड से पुष्टि करनी होगी.

सर्वर को सभी कॉल के लिए "डिप्लॉय किया गया" स्टेटस दिखाना चाहिए. अगर ऐसा नहीं होता है, तो यह तरीका अपनाएं:

  1. किसी भी तरह की गड़बड़ी के लिए सर्वर लॉग देखें. लॉग यहां मौजूद हैं:
    • मैनेजमेंट सर्वर: opt/apigee/var/log/edge-management-server
    • मैसेज प्रोसेसर: opt/apigee/var/log/edge-message-processor
  2. सर्वर ठीक से काम कर रहा है या नहीं, यह देखने के लिए उस पर कॉल करें.
  3. सर्वर को ELB से हटाएं और फिर से चालू करें:
    /opt/apigee/apigee-service/bin/apigee-service service_name restart

    जहां service_name:

    • edge-management-server
    • edge-message-processor

apigee-service कमांड की मदद से स्टेटस देखना

सेवा को चलाने वाले सर्वर में लॉग इन करने के बाद, apigee-service कमांड का इस्तेमाल करके, Edge की सेवाओं से जुड़ी समस्याओं को हल किया जा सकता है.

apigee-service की मदद से किसी सेवा की स्थिति देखने के लिए:

  1. सर्वर में लॉग इन करें और यह कमांड चलाएं:
    /opt/apigee/apigee-service/bin/apigee-service service_name status

    जहां service_name इनमें से कोई एक है:

    • मैनेजमेंट सर्वर: edge-management-server
    • मैसेज प्रोसेसर: edge-message-processor
    • Postgres: edge-postgres-server
    • Qpid: edge-qpid-server
    • राउटर: edge-router

    उदाहरण के लिए:

    /opt/apigee/apigee-service/bin/apigee-service edge-message-processor status
  2. अगर सेवा चालू नहीं है, तो उसे चालू करें:
    /opt/apigee/apigee-service/bin/apigee-service service_name start
  3. सेवा को फिर से शुरू करने के बाद, यह देखें कि वह काम कर रही है या नहीं. इसके लिए, पहले इस्तेमाल किए गए apigee-service status कमांड का इस्तेमाल करें या Management API की मदद से निगरानी करें में बताए गए Management API का इस्तेमाल करें.

    उदाहरण के लिए:

    curl -v http://localhost:port_number/v1/servers/self/up

    यहां port_number, सेवा के लिए मैनेजमेंट एपीआई पोर्ट है.

    इस उदाहरण में यह माना गया है कि आपने सर्वर में लॉग इन किया है और होस्टनेम के तौर पर "localhost" का इस्तेमाल किया जा सकता है. Management API की मदद से, कहीं से भी स्टेटस देखने के लिए, आपको सर्वर का आईपी पता बताना होगा. साथ ही, अपने एपीआई कॉल में सिस्टम एडमिन का उपयोगकर्ता नाम और पासवर्ड शामिल करना होगा.

Postgres मॉनिटरिंग

Postgres में कई सुविधाएं होती हैं, जिनका इस्तेमाल करके इसके स्टेटस की जांच की जा सकती है. इन सुविधाओं के बारे में, यहां दिए गए सेक्शन में बताया गया है.

Postgres पर संगठन और एनवायरमेंट देखना

Postgres Server पर शामिल किए गए संगठन और एनवायरमेंट के नाम देखे जा सकते हैं. इसके लिए, यह curl कमांड दें:

curl -v http://postgres_IP:8084/v1/servers/self/organizations

सिस्टम में, संगठन और एनवायरमेंट का नाम दिखना चाहिए.

आंकड़ों की स्थिति की पुष्टि करना

Postgres और Qpid Analytics सर्वर की स्थिति की पुष्टि करने के लिए, यह curl कमांड दें:

curl -u userEmail:password http://host:port_number/v1/organizations/orgname/environments/envname/provisioning/axstatus

सिस्टम को सभी Analytics सर्वर के लिए, 'सफलता' का स्टेटस दिखाना चाहिए, जैसा कि नीचे दिए गए उदाहरण में दिखाया गया है:

{
  "environments" : [ {
    "components" : [ {
      "message" : "success at Thu Feb 28 10:27:38 CET 2013",
      "name" : "pg",
      "status" : "SUCCESS",
      "uuid" : "[c678d16c-7990-4a5a-ae19-a99f925fcb93]"
     }, {
      "message" : "success at Thu Feb 28 10:29:03 CET 2013",
      "name" : "qs",
      "status" : "SUCCESS",
      "uuid" : "[ee9f0db7-a9d3-4d21-96c5-1a15b0bf0adf]"
     } ],
    "message" : "",
    "name" : "prod"
   } ],
  "organization" : "acme",
  "status" : "SUCCESS"
}

PostgreSQL डेटाबेस

इस सेक्शन में ऐसी तकनीकों के बारे में बताया गया है जिनका इस्तेमाल खास तौर पर Postgres डेटाबेस को मॉनिटर करने के लिए किया जा सकता है.

check_postgres.pl स्क्रिप्ट का इस्तेमाल करना

PostgreSQL डेटाबेस को मॉनिटर करने के लिए, check_postgres.pl जैसी स्टैंडर्ड मॉनिटरिंग स्क्रिप्ट का इस्तेमाल किया जा सकता है. ज़्यादा जानकारी के लिए, http://bucardo.org/wiki/Check_postgres पर जाएं.

स्क्रिप्ट चलाने से पहले:

  1. आपको हर Postgres नोड पर check_postgres.pl स्क्रिप्ट इंस्टॉल करनी होगी.
  2. पक्का करें कि आपने perl-Time-HiRes.x86_64 इंस्टॉल किया हो. यह एक Perl मॉड्यूल है, जो हाई रिज़ॉल्यूशन अलार्म, स्लीप, gettimeofday, और इंटरवल टाइमर लागू करता है. उदाहरण के लिए, इसे इस निर्देश का इस्तेमाल करके इंस्टॉल किया जा सकता है:
    yum install perl-Time-HiRes.x86_64
  3. CentOS 7: CentOS v7 पर check_postgres.pl का इस्तेमाल करने से पहले, perl-Data-Dumper.x86_64 RPM इंस्टॉल करें.

check_postgres.pl का आउटपुट

check_postgres.pl का इस्तेमाल करके किए गए एपीआई कॉल का डिफ़ॉल्ट आउटपुट, Nagios के साथ काम करता है. स्क्रिप्ट इंस्टॉल करने के बाद, ये जांच करें:

  1. डेटाबेस का साइज़ देखें:
    check_postgres.pl -H 10.176.218.202 -db apigee -u apigee -dbpass postgres -include=apigee -action database_size --warning='800 GB' --critical='900 GB'
  2. डेटाबेस में आने वाले कनेक्शन की संख्या देखें और अनुमति वाले ज़्यादा से ज़्यादा कनेक्शन की तुलना करें:
    check_postgres.pl -H 10.176.218.202 -db apigee -u apigee -dbpass postgres -action backends
  3. देखें कि डेटाबेस चालू है या नहीं और वह उपलब्ध है या नहीं:
    check_postgres.pl -H 10.176.218.202 -db apigee -u apigee -dbpass postgres -action connection
  4. डिस्क में बचा स्टोरेज देखें:
    check_postgres.pl -H 10.176.218.202 -db apigee -u apigee -dbpass postgres -action disk_space --warning='80%' --critical='90%'
  5. Postgres नोड में ऑनबोर्ड किए गए संगठन और एनवायरमेंट की संख्या देखें:
    check_postgres.pl -H 10.176.218.202 -db apigee -u apigee -dbpass postgres -action=custom_query --query="select count(*) as result from pg_tables where schemaname='analytics' and tablename like '%fact'" --warning='80' --critical='90' --valtype=integer

डेटाबेस की जांच करना

आपके पास यह पुष्टि करने का विकल्प है कि PostgreSQL डेटाबेस में सही टेबल बनाई गई हैं या नहीं. इस कमांड का इस्तेमाल करके, PostgreSQL डेटाबेस में लॉग इन करें:

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

इसके बाद, यह चलाएं:

\d analytics."org.env.fact"

postgres प्रोसेस की स्थिति देखना

Postgres मशीन पर एपीआई की जांच करने के लिए, यह curl कमांड इस्तेमाल करें:

curl -v http://postgres_IP:8084/v1/servers/self/health

postgres प्रोसेस चालू होने पर, यह कमांड ACTIVE स्टेटस दिखाता है. अगर Postgres प्रोसेस चालू नहीं है, तो यह INACTIVE स्टेटस दिखाती है.

Postgres के संसाधन

Postgres सेवा को मॉनिटर करने के बारे में ज़्यादा जानकारी के लिए, ये लेख पढ़ें:

Apache Cassandra

Cassandra के लिए, JMX डिफ़ॉल्ट रूप से चालू होता है. साथ ही, Cassandra के रिमोट JMX ऐक्सेस के लिए पासवर्ड की ज़रूरत नहीं होती.

Cassandra के लिए JMX ऑथेंटिकेशन की सुविधा चालू करना

Cassandra के लिए, JMX पुष्टि करने की सुविधा चालू की जा सकती है. ऐसा करने के बाद, आपको nodetool टूल के सभी कॉल के लिए, उपयोगकर्ता नाम और पासवर्ड डालना होगा.

Cassandra के लिए JMX ऑथेंटिकेशन की सुविधा चालू करने के लिए:

  1. cassandra.properties फ़ाइल बनाना और उसमें बदलाव करना:
    1. /opt/apigee/customer/application/cassandra.properties फ़ाइल में बदलाव करें. अगर फ़ाइल मौजूद नहीं है, तो उसे बनाएं.
    2. फ़ाइल में यह जानकारी जोड़ें:
      conf_cassandra_env_com.sun.management.jmxremote.authenticate=true
      conf_cassandra_env_com.sun.management.jmxremote.password.file=${APIGEE_ROOT}/customer/application/apigee-cassandra/jmxremote.password
      conf_cassandra_env_com.sun.management.jmxremote.access.file=${APIGEE_ROOT}/customer/application/apigee-cassandra/jmxremote.access
    3. cassandra.properties फ़ाइल सेव करें.
    4. फ़ाइल के मालिक को apigee:apigee पर सेट करें, जैसा कि इस उदाहरण में दिखाया गया है:
      chown apigee:apigee /opt/apigee/customer/application/cassandra.properties

    टोकन सेट करने के लिए प्रॉपर्टी फ़ाइलों का इस्तेमाल करने के बारे में ज़्यादा जानने के लिए, Edge को कॉन्फ़िगर करने का तरीका देखें.

  2. jmx_auth.sh बनाना और उसमें बदलाव करना:
    1. अगर यह फ़ाइल मौजूद नहीं है, तो यहां फ़ाइल बनाएं:
      /opt/apigee/customer/application/jmx_auth.sh
    2. फ़ाइल में ये प्रॉपर्टी जोड़ें:
      export CASS_JMX_USERNAME=JMX_USERNAME
      export CASS_JMX_PASSWORD=JMX_PASSWORD
    3. jmx_auth.sh फ़ाइल सेव करें.
    4. फ़ाइल का सोर्स:
      source /opt/apigee/customer/application/jmx_auth.sh
  3. jmxremote.password फ़ाइल को कॉपी करें और उसमें बदलाव करें:
    1. अपनी $JAVA_HOME डायरेक्ट्री से, यह फ़ाइल /opt/apigee/customer/application/apigee-cassandra/ में कॉपी करें:
      cp ${JAVA_HOME}/lib/management/jmxremote.password.template $APIGEE_ROOT/customer/application/apigee-cassandra/jmxremote.password
    2. jmxremote.password फ़ाइल में बदलाव करें और नीचे दिए गए सिंटैक्स का इस्तेमाल करके, अपना JMX उपयोगकर्ता नाम और पासवर्ड जोड़ें:
      JMX_USERNAME JMX_PASSWORD

      यहां JMX_USERNAME और JMX_PASSWORD, JMX के लिए सेट किया गया आपका उपयोगकर्ता नाम और पासवर्ड है.

    3. पक्का करें कि फ़ाइल का मालिकाना हक "apigee" के पास हो और फ़ाइल का मोड 400 हो:
      chown apigee:apigee /opt/apigee/customer/application/apigee-cassandra/jmxremote.password
      chmod 400 /opt/apigee/customer/application/apigee-cassandra/jmxremote.password
  4. jmxremote.access फ़ाइल को कॉपी करें और उसमें बदलाव करें:
    1. अपनी $JAVA_HOME डायरेक्ट्री से, यह फ़ाइल /opt/apigee/customer/application/apigee-cassandra/ में कॉपी करें:
      cp ${JAVA_HOME}/lib/management/jmxremote.access
      $APIGEE_ROOT/customer/application/apigee-cassandra/jmxremote.access
    2. jmxremote.access फ़ाइल में बदलाव करें और यह भूमिका जोड़ें:
      JMX_USERNAME readwrite
    3. पक्का करें कि फ़ाइल का मालिकाना हक "apigee" के पास हो और फ़ाइल का मोड 400 हो:
      chown apigee:apigee /opt/apigee/customer/application/apigee-cassandra/jmxremote.access
      chmod 400 /opt/apigee/customer/application/apigee-cassandra/jmxremote.access
  5. Cassandra पर configure चलाएं:
    /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra configure
  6. Cassandra को रीस्टार्ट करें:
    /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra restart
  7. यह प्रोसेस, Cassandra के अन्य सभी नोड पर दोहराएं.

JMX पासवर्ड एन्क्रिप्शन की सुविधा चालू करना

JMX पासवर्ड एन्क्रिप्शन की सुविधा चालू करने के लिए, यह तरीका अपनाएं:

  1. फ़ाइल source/conf/casssandra-env.sh खोलें.
  2. cassandra.properties फ़ाइल बनाना और उसमें बदलाव करना:
    1. /opt/apigee/customer/application/cassandra.properties फ़ाइल में बदलाव करें. अगर फ़ाइल मौजूद नहीं है, तो उसे बनाएं.
    2. फ़ाइल में यह जानकारी जोड़ें:
      conf_cassandra_env_com.sun.management.jmxremote.encrypted.authenticate=true
    3. cassandra.properties फ़ाइल सेव करें.
    4. फ़ाइल के मालिक को apigee:apigee में बदलें, जैसा कि इस उदाहरण में दिखाया गया है:
      chown apigee:apigee /opt/apigee/customer/application/cassandra.properties
  3. कमांड लाइन पर, अपने पसंदीदा पासवर्ड का SHA1 हैश जनरेट करने के लिए, echo -n 'Secret' | openssl dgst -sha1
  4. $APIGEE_ROOT/customer/application/apigee-cassandra/jmxremote.password (पिछले सेक्शन में बनाया गया) में उपयोगकर्ता नाम के लिए पासवर्ड सेट करें.
  5. Cassandra पर कॉन्फ़िगर करें:
    /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra configure
  6. Cassandra को रीस्टार्ट करें:
    /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra restart
  7. यह प्रोसेस, Cassandra के अन्य सभी नोड पर दोहराएं.

Cassandra के लिए, एसएसएल के साथ JMX चालू करना

एसएसएल के साथ JMX को चालू करने पर, Cassandra के साथ JMX-आधारित कम्यूनिकेशन के लिए ज़्यादा सुरक्षा और एन्क्रिप्शन मिलता है. एसएसएल के साथ JMX को चालू करने के लिए, आपको Cassandra को एक कुंजी और सर्टिफ़िकेट देना होगा, ताकि वह एसएसएल पर आधारित JMX कनेक्शन स्वीकार कर सके. आपको एसएसएल के लिए, nodetool और JMX के ज़रिए Cassandra से कम्यूनिकेट करने वाले अन्य टूल भी कॉन्फ़िगर करने होंगे.

एसएसएल की सुविधा वाले JMX, साफ़ तौर पर लिखे गए और एन्क्रिप्ट (सुरक्षित) किए गए JMX पासवर्ड, दोनों के साथ काम करते हैं.

Cassandra के लिए, SSL के साथ JMX को चालू करने के लिए, यह तरीका अपनाएं:

  1. JMX चालू करें. ज़रूरत पड़ने पर, पासवर्ड एन्क्रिप्ट करने की सुविधा चालू करें.
  2. Cassandra के लिए JMX ऑथेंटिकेशन चालू करें. जैसा कि ऊपर बताया गया है. पक्का करें कि nodetool, कॉन्फ़िगर किए गए उपयोगकर्ता नाम और पासवर्ड के साथ काम कर रहा हो.
    /opt/apigee/apigee-cassandra/bin/nodetool -u <JMX_USER> -pw <JMX_PASS> ring
  3. कीस्टोर और ट्रस्टस्टोर तैयार करें.

    • कीस्टोर में एक कुंजी और सर्टिफ़िकेट होना चाहिए. साथ ही, इसका इस्तेमाल Cassandra सर्वर को कॉन्फ़िगर करने के लिए किया जाता है. अगर पासकोड में एक से ज़्यादा पासकोड पेयर हैं, तो एसएसएल को चालू करने के लिए Cassandra, पहले पासकोड पेयर का इस्तेमाल करता है.

      ध्यान दें कि कीस्टोर और पासकोड के लिए पासवर्ड एक ही होने चाहिए (keytool का इस्तेमाल करके पासकोड जनरेट करने पर, डिफ़ॉल्ट रूप से ऐसा होता है).

    • ट्रस्टस्टोर में सिर्फ़ सर्टिफ़िकेट होना चाहिए. इसका इस्तेमाल, क्लाइंट (apigee-service पर आधारित निर्देश या nodetool) JMX से कनेक्ट करने के लिए करते हैं.

    ऊपर दी गई ज़रूरी शर्तों की पुष्टि करने के बाद:

    1. पासकोड फ़ाइल को /opt/apigee/customer/application/apigee-cassandra/ में डालें.
    2. यह पक्का करें कि पासकोड वाली फ़ाइल को सिर्फ़ Apigee उपयोगकर्ता पढ़ सके. इसके लिए,
      chown apigee:apigee /opt/apigee/customer/application/apigee-cassandra/keystore.node1
      chmod 400 /opt/apigee/customer/application/apigee-cassandra/keystore.node1
      डालें
  4. एसएसएल के साथ JMX के लिए Cassandra को कॉन्फ़िगर करने के लिए, यह तरीका अपनाएं:
    1. apigee-service apigee-cassandra stop
      डालकर, Cassandra नोड को बंद करें
    2. Cassandra में एसएसएल चालू करने के लिए, /opt/apigee/customer/application/cassandra.properties फ़ाइल खोलें और ये लाइनें जोड़ें:
      conf_cassandra_env_com.sun.management.jmxremote.ssl=true
      conf_cassandra_env_javax.net.ssl.keyStore=/opt/apigee/customer/application/apigee-cassandra/keystore.node1
      conf_cassandra_env_javax.net.ssl.keyStorePassword=keystore-password
    3. फ़ाइल के मालिक को apigee:apigee में बदलें, जैसा कि इस उदाहरण में दिखाया गया है:
      chown apigee:apigee /opt/apigee/customer/application/cassandra.properties
    4. Cassandra पर कॉन्फ़िगर करें:
      /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra configure
    5. Cassandra को रीस्टार्ट करें:
      /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra restart
    6. यह प्रोसेस, Cassandra के अन्य सभी नोड पर दोहराएं.
    7. Cassandra नोड को शुरू करने के लिए,
      apigee-service apigee-cassandra start
      डालें
  5. apigee-service Cassandra कमांड कॉन्फ़िगर करें. आपको apigee-service कमांड चलाते समय, कुछ एनवायरमेंट वैरिएबल सेट करने होंगे. इनमें ये भी शामिल हैं:
    apigee-service apigee-cassandra stop
    apigee-service apigee-cassandra wait_for_ready
    apigee-service apigee-cassandra ring
    apigee-service apigee-cassandra backup

    JMX पुष्टि और एसएसएल के लिए, apigee-service को कॉन्फ़िगर करने के कई विकल्प हैं. इस्तेमाल करने के तरीके और सुरक्षा के तरीकों के आधार पर कोई विकल्प चुनें.

    पहला विकल्प (फ़ाइल में सेव किए गए एसएसएल आर्ग्युमेंट)

    ये एनवायरमेंट वैरिएबल सेट करें:

    export CASS_JMX_USERNAME=ADMIN
    # Provide encrypted password here if you have setup JMX password encryption
    export CASS_JMX_PASSWORD=PASSWORD
    export CASS_JMX_SSL=Y

    Apigee उपयोगकर्ता की होम डायरेक्ट्री (/opt/apigee) में कोई फ़ाइल बनाएं.

    $HOME/.cassandra/nodetool-ssl.properties

    फ़ाइल में बदलाव करके, ये लाइनें जोड़ें:

    -Djavax.net.ssl.trustStore=<path-to-truststore.node1>
    -Djavax.net.ssl.trustStorePassword=<truststore-password>
    -Dcom.sun.management.jmxremote.registry.ssl=true

    पक्का करें कि ट्रस्टोर फ़ाइल को Apigee उपयोगकर्ता पढ़ सके.

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

    apigee-service apigee-cassandra ring

    दूसरा विकल्प (एनवायरमेंट वैरिएबल में सेव किए गए एसएसएल आर्ग्युमेंट)

    ये एनवायरमेंट वैरिएबल सेट करें:

    export CASS_JMX_USERNAME=ADMIN
    # Provide encrypted password here if you have setup JMX password encryption
    export CASS_JMX_PASSWORD=PASSWORD
    export CASS_JMX_SSL=Y
    # Ensure the truststore file is accessible by Apigee user.
    export CASS_JMX_TRUSTSTORE=<path-to-trustore.node1>
    export CASS_JMX_TRUSTSTORE_PASSWORD=<truststore-password>

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

    apigee-service apigee-cassandra ring

    तीसरा विकल्प (एसएसएल आर्ग्युमेंट सीधे apigee-service को पास किए जाते हैं)

    यहां दिए गए apigee-service कमांड की तरह कोई भी कमांड चलाएं. आपको किसी भी एनवायरमेंट वैरिएबल को कॉन्फ़िगर करने की ज़रूरत नहीं है.

    CASS_JMX_USERNAME=ADMIN CASS_JMX_PASSWORD=PASSWORD CASS_JMX_SSL=Y CASS_JMX_TRUSTSTORE=<path-to-trustore.node1> CASS_JMX_TRUSTSTORE_PASSWORD=<trustore-password> /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra ring
  6. nodetool सेट अप करें. Nodetool को JMX पैरामीटर पास करने की ज़रूरत होती है. एसएसएल की सुविधा वाले JMX के साथ काम करने के लिए, nodetool को कॉन्फ़िगर करने के दो तरीके हैं. इनके बारे में नीचे दिए गए कॉन्फ़िगरेशन विकल्पों में बताया गया है:

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

    nodetool पैरामीटर के बारे में ज़्यादा जानने के लिए, DataStax दस्तावेज़ देखें.

    कॉन्फ़िगरेशन का पहला विकल्प

    nodetool चलाने वाले उपयोगकर्ता की होम डायरेक्ट्री में फ़ाइल बनाएं.

    $HOME/.cassandra/nodetool-ssl.properties

    फ़ाइल में ये लाइनें जोड़ें:

    -Djavax.net.ssl.trustStore=<path-to-truststore.node1>
    -Djavax.net.ssl.trustStorePassword=<truststore-password>
    -Dcom.sun.management.jmxremote.registry.ssl=true

    ऊपर बताए गए ट्रस्टस्टोर पाथ को, nodetool चलाने वाला कोई भी उपयोगकर्ता ऐक्सेस कर सकता है.

    --ssl विकल्प के साथ nodetool चलाएं.

    /opt/apigee/apigee-cassandra/bin/nodetool --ssl -u <jmx-user-name> -pw <jmx-user-password> -h localhost ring

    कॉन्फ़िगरेशन का दूसरा विकल्प

    nodetool को एक कमांड के तौर पर चलाएं. इसके लिए, नीचे दिए गए अतिरिक्त पैरामीटर इस्तेमाल करें.

    /opt/apigee/apigee-cassandra/bin/nodetool -Djavax.net.ssl.trustStore=<path-to-truststore.node1> -Djavax.net.ssl.trustStorePassword=<truststore-password> -Dcom.sun.management.jmxremote.registry.ssl=true -Dssl.enable=true -u <jmx-user-name> -pw <jmx-user-password> -h localhost ring

एसएसएल कॉन्फ़िगरेशन को पहले जैसा करना

अगर आपको ऊपर बताए गए तरीके से एसएसएल कॉन्फ़िगरेशन को वापस लाना है, तो यह तरीका अपनाएं:

  1. apigee-cassandra को बंद करने के लिए,
    apigee-service apigee-cassandra stop
    डालें
  2. फ़ाइल /opt/apigee/customer/application/cassandra.properties से लाइन conf_cassandra-env_com.sun.management.jmxremote.ssl=true हटाएं.
  3. /opt/apigee/apigee-cassandra/source/conf/cassandra-env.sh में इन लाइनों को हटाएं
    # JVM_OPTS="$JVM_OPTS -Djavax.net.ssl.keyStore=/opt/apigee/data/apigee-cassandra/keystore.node0"
    # JVM_OPTS="$JVM_OPTS -Djavax.net.ssl.keyStorePassword=keypass"
    # JVM_OPTS="$JVM_OPTS -Dcom.sun.management.jmxremote.registry.ssl=true”
  4. apigee-cassandra को चालू करने के लिए,
  5. apigee-service apigee-cassandra start
  6. अगर एनवायरमेंट वैरिएबल CASS_JMX_SSL सेट किया गया था, तो उसे हटाएं.

    unset CASS_JMX_SSL
  7. देखें कि apigee-service पर आधारित निर्देश, जैसे कि ring, stop, backup वगैरह काम कर रहे हैं या नहीं.
  8. nodetool के साथ --ssl स्विच का इस्तेमाल बंद करना

Cassandra के लिए JMX ऑथेंटिकेशन बंद करना

Cassandra के लिए JMX पुष्टि करने की सुविधा बंद करने के लिए:

  1. /opt/apigee/customer/application/cassandra.properties में बदलाव करें.
  2. फ़ाइल में यह लाइन हटाएं:
    conf_cassandra-env_com.sun.management.jmxremote.authenticate=true
  3. Cassandra पर कॉन्फ़िगर करें:
    /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra configure
  4. Cassandra को रीस्टार्ट करें:
    /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra restart
  5. यह प्रोसेस, Cassandra के अन्य सभी नोड पर दोहराएं.

JConsole का इस्तेमाल करना: टास्क के आंकड़े मॉनिटर करना

JMX के ज़रिए ऑफ़र किए गए JMX एट्रिब्यूट (एमबीीन) को मॉनिटर करने के लिए, JConsole और यहां दिए गए सेवा यूआरएल का इस्तेमाल करें:

service:jmx:rmi:///jndi/rmi://IP_address:7199/jmxrmi

यहां IP_address, Cassandra सर्वर का आईपी है.

Cassandra JMX के आंकड़े

JMX MBeans JMX एट्रिब्यूट

ColumnFamilies/apprepo/environments

ColumnFamilies/apprepo/organizations

ColumnFamilies/apprepo/apiproxy_revisions

ColumnFamilies/apprepo/apiproxies

ColumnFamilies/audit/audits

ColumnFamilies/audit/audits_ref

PendingTasks

MemtableColumnsCount

MemtableDataSize

ReadCount

RecentReadLatencyMicros

TotalReadLatencyMicros

WriteCount

RecentWriteLatencyMicros

TotalWriteLatencyMicros

TotalDiskSpaceUsed

LiveDiskSpaceUsed

LiveSSTableCount

BloomFilterFalsePositives

RecentBloomFilterFalseRatio

BloomFilterFalseRatio

क्लस्टर नोड मैनेज करने के लिए nodetool का इस्तेमाल करना

nodetool, Cassandra के लिए कमांड लाइन इंटरफ़ेस है. यह क्लस्टर नोड को मैनेज करता है. यह सुविधा /opt/apigee/apigee-cassandra/bin पर उपलब्ध है.

Cassandra क्लस्टर के सभी नोड पर ये कॉल किए जा सकते हैं:

  1. रिंग की सामान्य जानकारी (यह एक Cassandra नोड के लिए भी हो सकता है): सभी नोड के लिए, "चालू है" और "सामान्य" देखें.
    nodetool [-u username -pw password] -h localhost ring

    आपको अपना उपयोगकर्ता नाम और पासवर्ड सिर्फ़ तब डालना होगा, जब आपने Cassandra के लिए JMX पुष्टि करने की सुविधा चालू की हो.

    ऊपर दिए गए कमांड का आउटपुट नीचे दिखाया गया है:

    Datacenter: dc-1
    ==========
    Address            Rack     Status State   Load    Owns    Token
    192.168.124.201    ra1      Up     Normal  1.67 MB 33,33%  0
    192.168.124.202    ra1      Up     Normal  1.68 MB 33,33%  5671...5242
    192.168.124.203    ra1      Up     Normal  1.67 MB 33,33%  1134...0484

  2. नोड के बारे में सामान्य जानकारी (हर नोड के लिए कॉल)
    nodetool [-u username -pw password]  -h localhost info

    ऊपर दिए गए कमांड का आउटपुट ऐसा दिखता है:

    ID                     : e2e42793-4242-4e82-bcf0-oicu812
    Gossip active          : true
    Thrift active          : true
    Native Transport active: true
    Load                   : 273.71 KB
    Generation No          : 1234567890
    Uptime (seconds)       : 687194
    Heap Memory (MB)       : 314.62 / 3680.00
    Off Heap Memory (MB)   : 0.14
    Data Center            : dc-1
    Rack                   : ra-1
    Exceptions             : 0
    Key Cache              : entries 150, size 13.52 KB, capacity 100 MB, 1520781 hits, 1520923 requests, 1.000 recent hit rate, 14400 save period in seconds
    Row Cache              : entries 0, size 0 bytes, capacity 0 bytes, 0 hits, 0 requests, NaN recent hit rate, 0 save period in seconds
    Counter Cache          : entries 0, size 0 bytes, capacity 50 MB, 0 hits, 0 requests, NaN recent hit rate, 7200 save period in seconds
    Token                  : 0
  3. थ्रिफ़्ट सर्वर की स्थिति (क्लाइंट एपीआई को सेवा देना)
    nodetool [-u username -pw password] -h localhost statusthrift

    ऊपर दिए गए कमांड का आउटपुट इस तरह दिखता है:

    running

  4. डेटा स्ट्रीमिंग ऑपरेशन की स्थिति: Cassandra नोड के लिए ट्रैफ़िक देखें:
    nodetool [-u username -pw password] -h localhost netstats

    ऊपर दिए गए कमांड का आउटपुट इस तरह दिखता है:

    Mode: NORMAL
    Not sending any streams.
    Read Repair Statistics:
    Attempted: 151612
    Mismatch (Blocking): 0
    Mismatch (Background): 0
    Pool Name                    Active   Pending      Completed   Dropped
    Commands                        n/a         0              0         0
    Responses                       n/a         0              0       n/a

nodetool के बारे में ज़्यादा जानकारी के लिए, nodetool टूल के बारे में जानकारी देखें.

Cassandra रिसॉर्स

इस यूआरएल पर जाएं: http://www.datastax.com/docs/1.0/operations/monitoring.

Apache Qpid Broker-J की निगरानी करना

Qpid मैनेजमेंट कंसोल से, Qpid Broker-J को मॉनिटर किया जा सकता है. इस सेक्शन में, कंसोल को ऐक्सेस करने और निगरानी से जुड़े बुनियादी फ़ंक्शन करने के लिए, इसका इस्तेमाल करने का तरीका बताया गया है. मैनेजमेंट कंसोल का इस्तेमाल करने के बारे में ज़्यादा जानकारी के लिए, Apache Qpid के दस्तावेज़ में वेब मैनेजमेंट कंसोल देखें.

मैनेजमेंट कंसोल को ऐक्सेस करना

मैनेजमेंट कंसोल का डिफ़ॉल्ट पोर्ट 8090 होता है. इस डिफ़ॉल्ट पोर्ट पर कंसोल को ऐक्सेस करने के लिए, अपने वेब ब्राउज़र को इस पते पर ले जाएं:

http://QPID_NODE_IP:8090

कंसोल में लॉग इन करने के लिए, Apigee से सेट किए गए डिफ़ॉल्ट क्रेडेंशियल या Edge कॉन्फ़िगरेशन फ़ाइल में सेट किए गए क्रेडेंशियल का इस्तेमाल करें. ज़्यादा जानकारी के लिए, Edge कॉन्फ़िगरेशन फ़ाइल का रेफ़रंस देखें.

सूचियों और मैसेज पर नज़र रखना

बाईं ओर मौजूद नेविगेशन पैनल में, Java-Broker > virtualhosts > queues पर जाएं. यूज़र इंटरफ़ेस (यूआई) के मुख्य हिस्से में, किसी कतार की जानकारी देखने के लिए उसे चुनें. ज़्यादा जानकारी वाले व्यू में, आपको सूची के एट्रिब्यूट और आंकड़े दिख सकते हैं. इनमें, डिलीवर किए गए मैसेज, सूची में जोड़े गए मैसेज, मैसेज की दरें वगैरह की जानकारी शामिल है.

लॉग फ़ाइलें देखना और डाउनलोड करना

बाएं नेविगेशन पैनल में, Java-Broker > brokerloggers > logfile पर जाएं. मुख्य यूज़र इंटरफ़ेस (यूआई) की जानकारी वाले व्यू में, लॉग फ़ाइल की जानकारी देखी जा सकती है और लॉग फ़ाइलें डाउनलोड की जा सकती हैं.

Qpid मैनेजमेंट एपीआई का इस्तेमाल करना

Apache Qpid Broker-J REST API का इस्तेमाल करके, मैनेजमेंट टास्क को ऑटोमेट किया जा सकता है और ब्रोकर को मॉनिटर किया जा सकता है. ज़्यादा जानकारी के लिए, Apache Qpid Broker REST API दस्तावेज़ देखें.

ब्रोकर को मॉनिटर करने के लिए, कमांड लाइन टूल का भी इस्तेमाल किया जा सकता है. उदाहरण के लिए:

curl "QPID_NODE_IP":"8090"/api/latest/broker -u "USERNAME":"PASSWORD"

Apache ZooKeeper

ZooKeeper का स्टेटस देखना

  1. पक्का करें कि ZooKeeper प्रोसेस चल रही हो. ZooKeeper, opt/apigee/var/run/apigee-zookeeper/apigee-zookeeper.pid में एक पीआईडी फ़ाइल लिखता है.
  2. ZooKeeper पोर्ट की जांच करके पक्का करें कि आपके पास हर ZooKeeper सर्वर पर, 2181 और 3888 पोर्ट के लिए टीसीपी कनेक्शन बनाने का विकल्प है.
  3. पक्का करें कि आपके पास ZooKeeper डेटाबेस से वैल्यू पढ़ने का ऐक्सेस हो. ZooKeeper क्लाइंट लाइब्रेरी (या /opt/apigee/apigee-zookeeper/bin/zkCli.sh) का इस्तेमाल करके कनेक्ट करें और डेटाबेस से कोई वैल्यू पढ़ें.
  4. स्टेटस देखें:
    /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper status

ZooKeeper में चार अक्षरों वाले शब्दों का इस्तेमाल करना

ZooKeeper को कमांड (चार अक्षरों वाले शब्द) के छोटे से सेट की मदद से मॉनिटर किया जा सकता है. ये कमांड, netcat (nc) या telnet का इस्तेमाल करके पोर्ट 2181 पर भेजे जाते हैं.

ZooKeeper के निर्देशों के बारे में ज़्यादा जानकारी के लिए, Apache ZooKeeper के निर्देशों का रेफ़रंस देखें.

उदाहरण के लिए:

  • srvr: सर्वर की पूरी जानकारी दिखाता है.
  • stat: सर्वर और कनेक्ट किए गए क्लाइंट की खास जानकारी दिखाता है.

ZooKeeper पोर्ट पर ये निर्देश दिए जा सकते हैं:

  1. चार अक्षरों वाला ruok कमांड चलाकर, यह जांच करें कि सर्वर बिना किसी गड़बड़ी के चल रहा है या नहीं. सही जवाब मिलने पर, "imok" दिखता है.
    echo ruok | nc host 2181

    वापसी:

    imok
  2. सर्वर की परफ़ॉर्मेंस और कनेक्ट किए गए क्लाइंट के आंकड़े देखने के लिए, चार अक्षरों वाला कमांड stat चलाएं:
    echo stat | nc host 2181

    वापसी:

    Zookeeper version: 3.4.5-1392090, built on 09/30/2012 17:52 GMT
    Clients:
    /0:0:0:0:0:0:0:1:33467[0](queued=0,recved=1,sent=0)
    /192.168.124.201:42388[1](queued=0,recved=8433,sent=8433)
    /192.168.124.202:42185[1](queued=0,recved=1339,sent=1347)
    /192.168.124.204:39296[1](queued=0,recved=7688,sent=7692)
    Latency min/avg/max: 0/0/128
    Received: 26144
    Sent: 26160
    Connections: 4
    Outstanding: 0
    Zxid: 0x2000002c2
    Mode: follower
    Node count: 283
  3. अगर netcat (nc) उपलब्ध नहीं है, तो इसके विकल्प के तौर पर python का इस्तेमाल किया जा सकता है. zookeeper.py नाम की ऐसी फ़ाइल बनाएं जिसमें ये शामिल हों:
    import time, socket,
    sys c = socket.socket(socket.AF_INET, socket.SOCK_STREAM)
    c.connect((sys.argv[1], 2181))
    c.send(sys.argv[2])
    time.sleep(0.1)
    print c.recv(512)

    अब Python की ये लाइनें चलाएं:

    python zookeeper.py 192.168.124.201 ruok
    python zookeeper.py 192.168.124.201 stat

एलडीएपी लेवल टेस्ट

OpenLDAP को मॉनिटर करके यह देखा जा सकता है कि खास अनुरोध सही तरीके से दिखाए जा रहे हैं या नहीं. दूसरे शब्दों में, ऐसी खोज करें जो सही नतीजा दिखाती हो.

  1. सिस्टम एडमिन की एंट्री के बारे में जानकारी पाने के लिए, ldapsearch (yum install openldap-clients) का इस्तेमाल करें. इस एंट्री का इस्तेमाल, सभी एपीआई कॉल की पुष्टि करने के लिए किया जाता है.
    ldapsearch -b "uid=admin,ou=users,ou=global,dc=apigee,dc=com" -x -W -D "cn=manager,dc=apigee,dc=com" -H ldap://localhost:10389 -LLL

    इसके बाद, आपसे LDAP एडमिन पासवर्ड मांगा जाएगा:

    Enter LDAP Password:

    पासवर्ड डालने के बाद, आपको फ़ॉर्म में यह जवाब दिखेगा:

    dn:
    uid=admin,ou=users,ou=global,dc=apigee,dc=com
    objectClass: organizationalPerson
    objectClass: person
    objectClass: inetOrgPerson
    objectClass: top
    uid: admin
    cn: admin
    sn: admin
    userPassword:: e1NTSEF9bS9xbS9RbVNXSFFtUWVsU1F0c3BGL3BQMkhObFp2eDFKUytmZVE9PQ=
     =
    mail: opdk@google.com
  2. इस कमांड की मदद से देखें कि मैनेजमेंट सर्वर अब भी LDAP से कनेक्ट है या नहीं:
    curl -u userEMail:password http://localhost:8080/v1/users/ADMIN

    वापसी:

    {
      "emailId" : ADMIN,
      "firstName" : "admin",
      "lastName" : "admin"
    }

OpenLDAP कैश मेमोरी पर भी नज़र रखी जा सकती है. इससे डिस्क ऐक्सेस की संख्या कम करने में मदद मिलती है और सिस्टम की परफ़ॉर्मेंस बेहतर होती है. OpenLDAP सर्वर में कैश साइज़ को मॉनिटर करने और फिर उसे ट्यून करने से, डायरेक्ट्री सर्वर की परफ़ॉर्मेंस पर काफ़ी असर पड़ सकता है. कैश मेमोरी के बारे में जानकारी पाने के लिए, लॉग फ़ाइलें (opt/apigee/var/log) देखी जा सकती हैं.