इस दस्तावेज़ में, उन कॉम्पोनेंट की निगरानी करने के तरीकों के बारे में बताया गया है जिन्हें Apigee Edge for Private Cloud के ऑन-प्राइमिस डिप्लॉयमेंट की मदद से इस्तेमाल किया जा सकता है.
खास जानकारी
Edge में, सेवाओं के बारे में जानकारी पाने और उनकी स्थिति देखने के कई तरीके उपलब्ध हैं. यहां दी गई टेबल में, ज़रूरी शर्तें पूरी करने वाली हर सेवा के लिए, जांच के अलग-अलग टाइप की जानकारी दी गई है:
Mgmt API | |||||||
कॉम्पोनेंट | मेमोरी का इस्तेमाल [JMX*] | सेवा की जांच करना | उपयोगकर्ता/संगठन/ डिप्लॉयमेंट का स्टेटस | axstatus | डेटाबेस की जांच | apigee-service में डेटा सोर्स का स्टेटस |
apigee-monit ** |
मैनेजमेंट सर्वर | |||||||
मैसेज प्रोसेसर | |||||||
राऊटर | |||||||
Qpid | |||||||
Postgres | |||||||
ज़्यादा जानकारी | ज़्यादा जानकारी | ज़्यादा जानकारी | ज़्यादा जानकारी | ज़्यादा जानकारी | ज़्यादा जानकारी | ज़्यादा जानकारी | |
* JMX का इस्तेमाल करने से पहले, आपको इसे चालू करना होगा. इसके बारे में JMX चालू करना में बताया गया है. ** |
पोर्ट और कॉन्फ़िगरेशन फ़ाइलों की निगरानी करना
हर कॉम्पोनेंट, अलग-अलग पोर्ट पर 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 को चालू करने के लिए, यह तरीका अपनाएं. ध्यान दें: प्रोडक्शन सिस्टम में, सुरक्षा के लिए एन्क्रिप्ट (सुरक्षित) की गई पुष्टि और एसएसएल, दोनों को चालू किया जाना चाहिए.
- सही कॉन्फ़िगरेशन फ़ाइल में बदलाव करें (
कॉन्फ़िगरेशन फ़ाइल का रेफ़रंस देखें). अगर कॉन्फ़िगरेशन फ़ाइल मौजूद नहीं है, तो उसे बनाएं.
conf_system_jmxremote_enable=true
- कॉन्फ़िगरेशन फ़ाइल सेव करें और पक्का करें कि उसका मालिकाना हक
apigee:apigee
के पास हो. - सही Edge कॉम्पोनेंट को रीस्टार्ट करें
apigee-service edge-management-server restart
JMX को बंद करने के लिए, प्रॉपर्टी conf_system_jmxremote_enable
को हटाएं या
इसकी वैल्यू को false
पर सेट करें. इसके बाद, सही Edge कॉम्पोनेंट को रीस्टार्ट करें.
JMX में पुष्टि करना
Edge for Private Cloud, फ़ाइलों में सेव की गई जानकारी का इस्तेमाल करके, पासवर्ड के आधार पर पुष्टि करने की सुविधा देता है. ज़्यादा सुरक्षा के लिए, पासवर्ड को हैश के तौर पर सेव किया जा सकता है.
- किसी 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
के पास हो. - पासवर्ड का SHA256 हैश बनाएं:
echo -n '
' | openssl dgst -sha256 - JMX उपयोगकर्ता क्रेडेंशियल के साथ
jmxremote.password
फ़ाइल बनाएं:- अपनी
$JAVA_HOME
डायरेक्ट्री से, इन फ़ाइलों को डायरेक्ट्री/opt/apigee/customer/application/<component>/
में कॉपी करें:cp ${JAVA_HOME}/lib/management/jmxremote.password.template $APIGEE_ROOT/customer/application/management-server/jmxremote.password
- फ़ाइल में बदलाव करें और नीचे दिए गए सिंटैक्स का इस्तेमाल करके, अपना JMX उपयोगकर्ता नाम और पासवर्ड जोड़ें:
USERNAME <HASH-PASSWORD>
- पक्का करें कि फ़ाइल का मालिकाना हक
apigee
के पास हो और फ़ाइल का मोड 400 हो:chown apigee:apigee $APIGEE_ROOT/customer/application/management-server/jmxremote.password chmod 400 $APIGEE_ROOT/customer/application/management-server/jmxremote.password
- अपनी
- JMX उपयोगकर्ता की अनुमतियों के साथ
jmxremote.access
फ़ाइल बनाएं:- अपनी $JAVA_HOME डायरेक्ट्री से, इन फ़ाइलों को डायरेक्ट्री
/opt/apigee/customer/application/<component>/
cp ${JAVA_HOME}/lib/management/jmxremote.access$APIGEE_ROOT/customer/application/management-server/jmxremote.password/jmxremote.access
में कॉपी करें - फ़ाइल में बदलाव करें और अपना JMX उपयोगकर्ता नाम जोड़ें. इसके बाद, अनुमति (READONLY/READWRITE) जोड़ें
USERNAME READONLY
- पक्का करें कि फ़ाइल का मालिकाना हक
apigee
के पास हो और फ़ाइल का मोड 400 हो:chown apigee:apigee $APIGEE_ROOT/customer/application/management-server/jmxremote.password chmod 400 $APIGEE_ROOT/customer/application/management-server/jmxremote.access
- अपनी $JAVA_HOME डायरेक्ट्री से, इन फ़ाइलों को डायरेक्ट्री
- सही Edge कॉम्पोनेंट को रीस्टार्ट करें:
apigee-service edge-management-server restart
JMX पुष्टि करने की सुविधा बंद करने के लिए, प्रॉपर्टी conf_system_jmxremote_authenticate
को हटाएं या उसकी वैल्यू को false
पर सेट करें. इसके बाद, सही Edge कॉम्पोनेंट को रीस्टार्ट करें.
JMX में एसएसएल
किसी edge-* कॉम्पोनेंट में एसएसएल पर आधारित JMX को चालू करने के लिए:
- सही कॉन्फ़िगरेशन फ़ाइल में बदलाव करें
(
कॉन्फ़िगरेशन फ़ाइल का रेफ़रंस देखें). अगर कॉन्फ़िगरेशन फ़ाइल मौजूद नहीं है, तो उसे बनाएं:
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
के पास हो. - सर्वर पासकोड वाली एक पासकोड की दुकान तैयार करें और उसे ऊपर दिए गए कॉन्फ़िगरेशन
conf_system_javax_net_ssl_keystore
में दिए गए पाथ पर डालें. पक्का करें किapigee:apigee
, पासकोड वाली फ़ाइल को पढ़ सके. - सही 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.htmlJConsole की मदद से मॉनिटर करना
प्रोसेस के आंकड़ों को मैनेज और मॉनिटर करने के लिए, 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 |
सेवा के बारे में जानकारी दिखाता है. इसमें ये चीज़ें शामिल हैं:
इस एपीआई कॉल के लिए, आपको अपने 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:passwordcurl 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 है.
इस कॉल के लिए, आपको अपने सिस्टम एडमिन के उपयोगकर्ता नाम और पासवर्ड से पुष्टि करनी होगी.
सर्वर को सभी कॉल के लिए "डिप्लॉय किया गया" स्टेटस दिखाना चाहिए. अगर ऐसा नहीं होता है, तो यह तरीका अपनाएं:
- किसी भी तरह की गड़बड़ी के लिए सर्वर लॉग देखें. लॉग यहां मौजूद हैं:
- मैनेजमेंट सर्वर:
opt/apigee/var/log/edge-management-server
- मैसेज प्रोसेसर:
opt/apigee/var/log/edge-message-processor
- मैनेजमेंट सर्वर:
- सर्वर ठीक से काम कर रहा है या नहीं, यह देखने के लिए उस पर कॉल करें.
- सर्वर को 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
की मदद से किसी सेवा की स्थिति देखने के लिए:
- सर्वर में लॉग इन करें और यह कमांड चलाएं:
/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
- मैनेजमेंट सर्वर:
- अगर सेवा चालू नहीं है, तो उसे चालू करें:
/opt/apigee/apigee-service/bin/apigee-service service_name start
- सेवा को फिर से शुरू करने के बाद, यह देखें कि वह काम कर रही है या नहीं. इसके लिए, पहले इस्तेमाल किए गए
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 पर जाएं.
स्क्रिप्ट चलाने से पहले:
- आपको हर Postgres नोड पर check_postgres.pl स्क्रिप्ट इंस्टॉल करनी होगी.
- पक्का करें कि आपने
perl-Time-HiRes.x86_64
इंस्टॉल किया हो. यह एक Perl मॉड्यूल है, जो हाई रिज़ॉल्यूशन अलार्म, स्लीप, gettimeofday, और इंटरवल टाइमर लागू करता है. उदाहरण के लिए, इसे इस निर्देश का इस्तेमाल करके इंस्टॉल किया जा सकता है:
yum install perl-Time-HiRes.x86_64
- CentOS 7: CentOS v7 पर check_postgres.pl का इस्तेमाल करने से पहले,
perl-Data-Dumper.x86_64
RPM इंस्टॉल करें.
check_postgres.pl का आउटपुट
check_postgres.pl
का इस्तेमाल करके किए गए एपीआई कॉल का डिफ़ॉल्ट आउटपुट, Nagios के साथ काम करता है. स्क्रिप्ट इंस्टॉल करने के बाद, ये जांच करें:
- डेटाबेस का साइज़ देखें:
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'
- डेटाबेस में आने वाले कनेक्शन की संख्या देखें और अनुमति वाले ज़्यादा से ज़्यादा कनेक्शन की तुलना करें:
check_postgres.pl -H 10.176.218.202 -db apigee -u apigee -dbpass postgres -action backends
- देखें कि डेटाबेस चालू है या नहीं और वह उपलब्ध है या नहीं:
check_postgres.pl -H 10.176.218.202 -db apigee -u apigee -dbpass postgres -action connection
- डिस्क में बचा स्टोरेज देखें:
check_postgres.pl -H 10.176.218.202 -db apigee -u apigee -dbpass postgres -action disk_space --warning='80%' --critical='90%'
- 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 सेवा को मॉनिटर करने के बारे में ज़्यादा जानकारी के लिए, ये लेख पढ़ें:
- http://www.postgresql.org/docs/9.0/static/monitoring.html
- http://www.postgresql.org/docs/9.0/static/diskusage.html
- http://bucardo.org/check_postgres/check_postgres.pl.html
Apache Cassandra
Cassandra के लिए, JMX डिफ़ॉल्ट रूप से चालू होता है. साथ ही, Cassandra के रिमोट JMX ऐक्सेस के लिए पासवर्ड की ज़रूरत नहीं होती.
Cassandra के लिए JMX ऑथेंटिकेशन की सुविधा चालू करना
Cassandra के लिए, JMX पुष्टि करने की सुविधा चालू की जा सकती है. ऐसा करने के बाद, आपको nodetool टूल के सभी कॉल के लिए, उपयोगकर्ता नाम और पासवर्ड डालना होगा.
Cassandra के लिए JMX ऑथेंटिकेशन की सुविधा चालू करने के लिए:
cassandra.properties
फ़ाइल बनाना और उसमें बदलाव करना:/opt/apigee/customer/application/cassandra.properties
फ़ाइल में बदलाव करें. अगर फ़ाइल मौजूद नहीं है, तो उसे बनाएं.- फ़ाइल में यह जानकारी जोड़ें:
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
cassandra.properties
फ़ाइल सेव करें.- फ़ाइल के मालिक को
apigee:apigee
पर सेट करें, जैसा कि इस उदाहरण में दिखाया गया है:chown apigee:apigee /opt/apigee/customer/application/cassandra.properties
टोकन सेट करने के लिए प्रॉपर्टी फ़ाइलों का इस्तेमाल करने के बारे में ज़्यादा जानने के लिए, Edge को कॉन्फ़िगर करने का तरीका देखें.
jmx_auth.sh
बनाना और उसमें बदलाव करना:- अगर यह फ़ाइल मौजूद नहीं है, तो यहां फ़ाइल बनाएं:
/opt/apigee/customer/application/jmx_auth.sh
- फ़ाइल में ये प्रॉपर्टी जोड़ें:
export CASS_JMX_USERNAME=JMX_USERNAME export CASS_JMX_PASSWORD=JMX_PASSWORD
jmx_auth.sh
फ़ाइल सेव करें.- फ़ाइल का सोर्स:
source /opt/apigee/customer/application/jmx_auth.sh
- अगर यह फ़ाइल मौजूद नहीं है, तो यहां फ़ाइल बनाएं:
jmxremote.password
फ़ाइल को कॉपी करें और उसमें बदलाव करें:- अपनी
$JAVA_HOME
डायरेक्ट्री से, यह फ़ाइल/opt/apigee/customer/application/apigee-cassandra/
में कॉपी करें:cp ${JAVA_HOME}/lib/management/jmxremote.password.template $APIGEE_ROOT/customer/application/apigee-cassandra/jmxremote.password
jmxremote.password
फ़ाइल में बदलाव करें और नीचे दिए गए सिंटैक्स का इस्तेमाल करके, अपना JMX उपयोगकर्ता नाम और पासवर्ड जोड़ें:JMX_USERNAME JMX_PASSWORD
यहां JMX_USERNAME और JMX_PASSWORD, JMX के लिए सेट किया गया आपका उपयोगकर्ता नाम और पासवर्ड है.
- पक्का करें कि फ़ाइल का मालिकाना हक "apigee" के पास हो और फ़ाइल का मोड 400 हो:
chown apigee:apigee /opt/apigee/customer/application/apigee-cassandra/jmxremote.password
chmod 400 /opt/apigee/customer/application/apigee-cassandra/jmxremote.password
- अपनी
jmxremote.access
फ़ाइल को कॉपी करें और उसमें बदलाव करें:- अपनी
$JAVA_HOME
डायरेक्ट्री से, यह फ़ाइल/opt/apigee/customer/application/apigee-cassandra/
में कॉपी करें:cp ${JAVA_HOME}/lib/management/jmxremote.access
$APIGEE_ROOT/customer/application/apigee-cassandra/jmxremote.access
jmxremote.access
फ़ाइल में बदलाव करें और यह भूमिका जोड़ें:JMX_USERNAME readwrite
- पक्का करें कि फ़ाइल का मालिकाना हक "apigee" के पास हो और फ़ाइल का मोड 400 हो:
chown apigee:apigee /opt/apigee/customer/application/apigee-cassandra/jmxremote.access
chmod 400 /opt/apigee/customer/application/apigee-cassandra/jmxremote.access
- अपनी
- Cassandra पर
configure
चलाएं:/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra configure
- Cassandra को रीस्टार्ट करें:
/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra restart
- यह प्रोसेस, Cassandra के अन्य सभी नोड पर दोहराएं.
JMX पासवर्ड एन्क्रिप्शन की सुविधा चालू करना
JMX पासवर्ड एन्क्रिप्शन की सुविधा चालू करने के लिए, यह तरीका अपनाएं:
- फ़ाइल
source/conf/casssandra-env.sh
खोलें. cassandra.properties
फ़ाइल बनाना और उसमें बदलाव करना:/opt/apigee/customer/application/cassandra.properties
फ़ाइल में बदलाव करें. अगर फ़ाइल मौजूद नहीं है, तो उसे बनाएं.- फ़ाइल में यह जानकारी जोड़ें:
conf_cassandra_env_com.sun.management.jmxremote.encrypted.authenticate=true
- cassandra.properties फ़ाइल सेव करें.
- फ़ाइल के मालिक को apigee:apigee में बदलें, जैसा कि इस उदाहरण में दिखाया गया है:
chown apigee:apigee /opt/apigee/customer/application/cassandra.properties
- कमांड लाइन पर, अपने पसंदीदा पासवर्ड का SHA1 हैश जनरेट करने के लिए,
echo -n 'Secret' | openssl dgst -sha1
$APIGEE_ROOT/customer/application/apigee-cassandra/jmxremote.password
(पिछले सेक्शन में बनाया गया) में उपयोगकर्ता नाम के लिए पासवर्ड सेट करें.- Cassandra पर कॉन्फ़िगर करें:
/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra configure
- Cassandra को रीस्टार्ट करें:
/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra restart
- यह प्रोसेस, Cassandra के अन्य सभी नोड पर दोहराएं.
Cassandra के लिए, एसएसएल के साथ JMX चालू करना
एसएसएल के साथ JMX को चालू करने पर, Cassandra के साथ JMX-आधारित कम्यूनिकेशन के लिए ज़्यादा सुरक्षा और एन्क्रिप्शन मिलता है. एसएसएल के साथ JMX को चालू करने के लिए, आपको Cassandra को एक कुंजी और सर्टिफ़िकेट देना होगा, ताकि वह एसएसएल पर आधारित JMX कनेक्शन स्वीकार कर सके. आपको एसएसएल के लिए, nodetool और JMX के ज़रिए Cassandra से कम्यूनिकेट करने वाले अन्य टूल भी कॉन्फ़िगर करने होंगे.
एसएसएल की सुविधा वाले JMX, साफ़ तौर पर लिखे गए और एन्क्रिप्ट (सुरक्षित) किए गए JMX पासवर्ड, दोनों के साथ काम करते हैं.
Cassandra के लिए, SSL के साथ JMX को चालू करने के लिए, यह तरीका अपनाएं:
- JMX चालू करें. ज़रूरत पड़ने पर, पासवर्ड एन्क्रिप्ट करने की सुविधा चालू करें.
- Cassandra के लिए JMX ऑथेंटिकेशन चालू करें.
जैसा कि ऊपर बताया गया है. पक्का करें कि nodetool, कॉन्फ़िगर किए गए उपयोगकर्ता नाम और पासवर्ड के साथ काम कर रहा हो.
/opt/apigee/apigee-cassandra/bin/nodetool -u <JMX_USER> -pw <JMX_PASS> ring
कीस्टोर और ट्रस्टस्टोर तैयार करें.
कीस्टोर में एक कुंजी और सर्टिफ़िकेट होना चाहिए. साथ ही, इसका इस्तेमाल Cassandra सर्वर को कॉन्फ़िगर करने के लिए किया जाता है. अगर पासकोड में एक से ज़्यादा पासकोड पेयर हैं, तो एसएसएल को चालू करने के लिए Cassandra, पहले पासकोड पेयर का इस्तेमाल करता है.
ध्यान दें कि कीस्टोर और पासकोड के लिए पासवर्ड एक ही होने चाहिए (keytool का इस्तेमाल करके पासकोड जनरेट करने पर, डिफ़ॉल्ट रूप से ऐसा होता है).
- ट्रस्टस्टोर में सिर्फ़ सर्टिफ़िकेट होना चाहिए. इसका इस्तेमाल, क्लाइंट (apigee-service पर आधारित निर्देश या nodetool) JMX से कनेक्ट करने के लिए करते हैं.
ऊपर दी गई ज़रूरी शर्तों की पुष्टि करने के बाद:
- पासकोड फ़ाइल को
/opt/apigee/customer/application/apigee-cassandra/
में डालें. - यह पक्का करें कि पासकोड वाली फ़ाइल को सिर्फ़ Apigee उपयोगकर्ता पढ़ सके. इसके लिए,
chown apigee:apigee /opt/apigee/customer/application/apigee-cassandra/keystore.node1
डालेंchmod 400 /opt/apigee/customer/application/apigee-cassandra/keystore.node1
- एसएसएल के साथ JMX के लिए Cassandra को कॉन्फ़िगर करने के लिए, यह तरीका अपनाएं:
-
apigee-service apigee-cassandra stop
डालकर, Cassandra नोड को बंद करें - 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
- फ़ाइल के मालिक को apigee:apigee में बदलें, जैसा कि इस उदाहरण में दिखाया गया है:
chown apigee:apigee /opt/apigee/customer/application/cassandra.properties
- Cassandra पर कॉन्फ़िगर करें:
/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra configure
- Cassandra को रीस्टार्ट करें:
/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra restart
- यह प्रोसेस, Cassandra के अन्य सभी नोड पर दोहराएं.
- Cassandra नोड को शुरू करने के लिए,
apigee-service apigee-cassandra start
डालें
-
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
को कॉन्फ़िगर करने के कई विकल्प हैं. इस्तेमाल करने के तरीके और सुरक्षा के तरीकों के आधार पर कोई विकल्प चुनें.- पहला विकल्प (फ़ाइल में सेव किए गए एसएसएल आर्ग्युमेंट)
- दूसरा विकल्प (एनवायरमेंट वैरिएबल में सेव किए गए एसएसएल आर्ग्युमेंट)
- तीसरा विकल्प (एसएसएल आर्ग्युमेंट सीधे
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
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
एसएसएल कॉन्फ़िगरेशन को पहले जैसा करना
अगर आपको ऊपर बताए गए तरीके से एसएसएल कॉन्फ़िगरेशन को वापस लाना है, तो यह तरीका अपनाएं:
apigee-cassandra
को बंद करने के लिए,apigee-service apigee-cassandra stop
डालें- फ़ाइल
/opt/apigee/customer/application/cassandra.properties
से लाइनconf_cassandra-env_com.sun.management.jmxremote.ssl=true
हटाएं. /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”
apigee-cassandra
को चालू करने के लिए,- अगर एनवायरमेंट वैरिएबल
CASS_JMX_SSL
सेट किया गया था, तो उसे हटाएं.unset CASS_JMX_SSL
- देखें कि
apigee-service
पर आधारित निर्देश, जैसे किring
,stop
,backup
वगैरह काम कर रहे हैं या नहीं. - nodetool के साथ
--ssl
स्विच का इस्तेमाल बंद करना
apigee-service apigee-cassandra start
Cassandra के लिए JMX ऑथेंटिकेशन बंद करना
Cassandra के लिए JMX पुष्टि करने की सुविधा बंद करने के लिए:
/opt/apigee/customer/application/cassandra.properties
में बदलाव करें.- फ़ाइल में यह लाइन हटाएं:
conf_cassandra-env_com.sun.management.jmxremote.authenticate=true
- Cassandra पर कॉन्फ़िगर करें:
/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra configure
- Cassandra को रीस्टार्ट करें:
/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra restart
- यह प्रोसेस, 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 क्लस्टर के सभी नोड पर ये कॉल किए जा सकते हैं:
- रिंग की सामान्य जानकारी (यह एक 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
- नोड के बारे में सामान्य जानकारी (हर नोड के लिए कॉल)
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
- थ्रिफ़्ट सर्वर की स्थिति (क्लाइंट एपीआई को सेवा देना)
nodetool [-u username -pw password] -h localhost statusthrift
ऊपर दिए गए कमांड का आउटपुट इस तरह दिखता है:
running
- डेटा स्ट्रीमिंग ऑपरेशन की स्थिति: 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 का स्टेटस देखना
- पक्का करें कि ZooKeeper प्रोसेस चल रही हो. ZooKeeper,
opt/apigee/var/run/apigee-zookeeper/apigee-zookeeper.pid
में एक पीआईडी फ़ाइल लिखता है. - ZooKeeper पोर्ट की जांच करके पक्का करें कि आपके पास हर ZooKeeper सर्वर पर, 2181 और 3888 पोर्ट के लिए टीसीपी कनेक्शन बनाने का विकल्प है.
- पक्का करें कि आपके पास ZooKeeper डेटाबेस से वैल्यू पढ़ने का ऐक्सेस हो. ZooKeeper क्लाइंट लाइब्रेरी (या
/opt/apigee/apigee-zookeeper/bin/zkCli.sh
) का इस्तेमाल करके कनेक्ट करें और डेटाबेस से कोई वैल्यू पढ़ें. - स्टेटस देखें:
/opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper status
ZooKeeper में चार अक्षरों वाले शब्दों का इस्तेमाल करना
ZooKeeper को कमांड (चार अक्षरों वाले शब्द) के छोटे से सेट की मदद से मॉनिटर किया जा सकता है. ये कमांड, netcat (nc) या telnet का इस्तेमाल करके पोर्ट 2181 पर भेजे जाते हैं.
ZooKeeper के निर्देशों के बारे में ज़्यादा जानकारी के लिए, Apache ZooKeeper के निर्देशों का रेफ़रंस देखें.
उदाहरण के लिए:
srvr
: सर्वर की पूरी जानकारी दिखाता है.stat
: सर्वर और कनेक्ट किए गए क्लाइंट की खास जानकारी दिखाता है.
ZooKeeper पोर्ट पर ये निर्देश दिए जा सकते हैं:
- चार अक्षरों वाला ruok कमांड चलाकर, यह जांच करें कि सर्वर बिना किसी गड़बड़ी के चल रहा है या नहीं. सही जवाब मिलने पर, "imok" दिखता है.
echo ruok | nc host 2181
वापसी:
imok
- सर्वर की परफ़ॉर्मेंस और कनेक्ट किए गए क्लाइंट के आंकड़े देखने के लिए, चार अक्षरों वाला कमांड
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
- अगर 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 को मॉनिटर करके यह देखा जा सकता है कि खास अनुरोध सही तरीके से दिखाए जा रहे हैं या नहीं. दूसरे शब्दों में, ऐसी खोज करें जो सही नतीजा दिखाती हो.
- सिस्टम एडमिन की एंट्री के बारे में जानकारी पाने के लिए,
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
- इस कमांड की मदद से देखें कि मैनेजमेंट सर्वर अब भी LDAP से कनेक्ट है या नहीं:
curl -u userEMail:password http://localhost:8080/v1/users/ADMIN
वापसी:
{ "emailId" : ADMIN, "firstName" : "admin", "lastName" : "admin" }
OpenLDAP कैश मेमोरी पर भी नज़र रखी जा सकती है. इससे डिस्क ऐक्सेस की संख्या कम करने में मदद मिलती है और सिस्टम की परफ़ॉर्मेंस बेहतर होती है. OpenLDAP सर्वर में कैश साइज़ को मॉनिटर करने और फिर उसे ट्यून करने से, डायरेक्ट्री सर्वर की परफ़ॉर्मेंस पर काफ़ी असर पड़ सकता है. कैश मेमोरी के बारे में जानकारी पाने के लिए, लॉग
फ़ाइलें (opt/apigee/var/log
) देखी जा सकती हैं.