इस दस्तावेज़ में, उन कॉम्पोनेंट की निगरानी करने के तरीकों के बारे में बताया गया है जिन्हें Apigee Edge for Private Cloud के ऑन-प्राइमिस डिप्लॉयमेंट की मदद से इस्तेमाल किया जा सकता है.
खास जानकारी
Edge में, सेवाओं के बारे में जानकारी पाने और उनकी स्थिति देखने के कई तरीके उपलब्ध हैं. यहां दी गई टेबल में, ज़रूरी शर्तें पूरी करने वाली हर सेवा के लिए, जांच के अलग-अलग टाइप की जानकारी दी गई है:
Mgmt API | |||||||
कॉम्पोनेंट | मेमोरी का इस्तेमाल [JMX*] | सेवा की जांच करना | उपयोगकर्ता/संगठन/ डिप्लॉयमेंट का स्टेटस | axstatus | डेटाबेस की जांच | apigee-service में डेटा सोर्स का स्टेटस |
apigee-monit ** |
मैनेजमेंट सर्वर | |||||||
मैसेज प्रोसेसर | |||||||
राऊटर | |||||||
Qpid | |||||||
पोस्टग्रेस | |||||||
ज़्यादा जानकारी | ज़्यादा जानकारी | ज़्यादा जानकारी | ज़्यादा जानकारी | ज़्यादा जानकारी | ज़्यादा जानकारी | ज़्यादा जानकारी | |
* 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 चालू करना
प्रमाणीकरण या SSL आधारित संचार के बिना 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
एसएसएल पर आधारित जेएमएक्स सुविधा बंद करने के लिए, conf_system_jmxremote_ssl
प्रॉपर्टी हटाएं या इसकी वैल्यू को बदलकर false
करें. सही Edge कॉम्पोनेंट को रीस्टार्ट करें.
Jconsole के ज़रिए निगरानी की जा रही है
jconsole की मदद से मॉनिटर करने के निर्देश वही रहेंगे जो https://docs.apigee.com/private-cloud/v4.52.01/how-monitor#jconsole में बताए गए हैं.
एक पंक्ति यह भी जोड़ी जा सकती है कि “JMX के लिए एसएसएल की सुविधा चालू होने पर, jconsole के लिए Truststore और Truststore पासवर्ड बनाना ज़रूरी है.” रेफ़रंस: https://docs.oracle.com/javase/8/docs/technotes/guides/management/jconsole.htmlJConsole की मदद से मॉनिटर करना
प्रोसेस के आंकड़ों को मैनेज और मॉनिटर करने के लिए, JConsole (JMX के साथ काम करने वाला टूल) का इस्तेमाल करें. JConsole की मदद से, सर्वर से दिखाए गए जेएमएक्स के आंकड़ों का इस्तेमाल किया जा सकता है और उन्हें ग्राफ़िकल इंटरफ़ेस में दिखाया जा सकता है. ज़्यादा जानकारी के लिए, 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 कम्यूनिकेशन के लिए एसएसएल चालू करें. डिफ़ॉल्ट रूप से गलत.
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=
- एसएसएल की मदद से जेएमएक्स रजिस्ट्री को सुरक्षित रखें. डिफ़ॉल्ट रूप से गलत है. यह सिर्फ़ तब लागू होता है, जब एसएसएल चालू हो.
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, उस सर्वर के लिए Management API पोर्ट है जिसकी आपको जांच करनी है. यह हर तरह के कॉम्पोनेंट के लिए अलग-अलग पोर्ट होता है. उदाहरण के लिए, मैनेजमेंट सर्वर का मैनेजमेंट एपीआई पोर्ट 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
- क्यूपीआईडी:
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 सर्वर पर शामिल किए गए संगठन और एनवायरमेंट के नाम देखने के लिए, यह 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"
पोस्टग्रेशन की प्रोसेस के स्वास्थ्य की स्थिति देखना
इस curl
कमांड का इस्तेमाल करके, Postgres मशीन पर एपीआई की जांच की जा सकती है:
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
अपाचे कासांड्रा
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 चालू करना
एसएसएल के साथ जेएमएक्स को चालू करने से, कैसंड्रा के साथ जेएमएक्स आधारित कम्यूनिकेशन के लिए ज़्यादा सुरक्षा और एन्क्रिप्शन उपलब्ध होता है. एसएसएल के साथ जेएमएक्स को चालू करने के लिए, आपको एसएसएल-आधारित जेएमएक्स कनेक्शन स्वीकार करने के लिए कैसंड्रा को एक कुंजी और सर्टिफ़िकेट देना होगा. आपको एसएसएल के लिए, nodetool (और जेएमएक्स पर कैसंड्रा के साथ इंटरैक्ट करने वाले अन्य टूल) को कॉन्फ़िगर करना होगा.
एसएसएल की सुविधा वाले JMX, साफ़ तौर पर लिखे गए और एन्क्रिप्ट (सुरक्षित) किए गए JMX पासवर्ड, दोनों के साथ काम करते हैं.
Cassandra के लिए, SSL के साथ JMX को चालू करने के लिए, यह तरीका अपनाएं:
- JMX चालू करें. ज़रूरत पड़ने पर, पासवर्ड एन्क्रिप्ट करने की सुविधा चालू करें.
- कैसंड्रा के लिए JMX की पुष्टि करने की सुविधा चालू करें.
जैसा कि ऊपर बताया गया है. पक्का करें कि nodetool, कॉन्फ़िगर किए गए
उपयोगकर्ता नाम और पासवर्ड के साथ काम कर रहा हो.
/opt/apigee/apigee-cassandra/bin/nodetool -u <JMX_USER> -pw <JMX_PASS> ring
कीस्टोर और ट्रस्टस्टोर तैयार करें.
कीस्टोर में एक कुंजी और सर्टिफ़िकेट होना चाहिए. साथ ही, इसका इस्तेमाल Cassandra सर्वर को कॉन्फ़िगर करने के लिए किया जाता है. अगर कीस्टोर में एक से ज़्यादा कुंजी के जोड़े हैं, तो एसएसएल को चालू करने के लिए, कैसंड्रा पहले कुंजी के जोड़े का इस्तेमाल करता है.
ध्यान दें कि कीस्टोर और 'की' के पासवर्ड एक ही होने चाहिए (यह डिफ़ॉल्ट रूप से तब होता है, जब कीटूल का इस्तेमाल करके कुंजी जनरेट की जाती है).
- ट्रस्टस्टोर में सिर्फ़ सर्टिफ़िकेट होना चाहिए. इसका इस्तेमाल, क्लाइंट (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 में एसएसएल चालू करने के लिए,
/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 ## On FIPS enabled systems, when you are using non standard keystore, set the following: ## These can be skipped otherwise ## Possible values are JKS, PKCS12, BCFKS conf_cassandra_env_javax.net.ssl.keyStoreType=PKCS12 conf_cassandra_env_javax.net.ssl.keyStoreAlias=cassjmx-tls-alias
- फ़ाइल के मालिक को apigee:apigee में बदलें, जैसा कि इस उदाहरण में दिखाया गया है:
chown apigee:apigee /opt/apigee/customer/application/cassandra.properties
- Cassandra पर कॉन्फ़िगर करें:
/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra configure
- कैसंड्रा को रीस्टार्ट करें:
/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=
-Djavax.net.ssl.trustStorePassword= -Dcom.sun.management.jmxremote.registry.ssl=true ## If you are using a non standard truststore, set below, otherwise skip ## Possible values are JKS, PKCS12, BCFKS -Djavax.net.ssl.trustStoreType=PKCS12 पक्का करें कि ट्रस्टोर फ़ाइल को 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=
export CASS_JMX_TRUSTSTORE_PASSWORD= # If you are using a non standard truststore type, export truststore type as well # Possible values are JKS, PKCS12, BCFKS export CASS_JMX_TRUSTSTORE_TYPE=PKCS12 यहां दिया गया
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=
CASS_JMX_TRUSTSTORE_PASSWORD= CASS_JMX_TRUSTSTORE_TYPE=PKCS12 /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra ring नोडटूल सेट अप करें. Nodetool के लिए जेएमएक्स पैरामीटर को पास करना ज़रूरी है. एसएसएल की सुविधा वाले JMX के साथ चलने के लिए, nodetool को कॉन्फ़िगर करने के दो तरीके हैं. इनके बारे में नीचे दिए गए कॉन्फ़िगरेशन विकल्पों में बताया गया है:
एसएसएल से जुड़े कॉन्फ़िगरेशन को nodetool में पास करने के तरीके के हिसाब से, विकल्प अलग-अलग होते हैं. दोनों ही मामलों में, nodetool चलाने वाले उपयोगकर्ता के पास ट्रस्टस्टोर फ़ाइल पर, पढ़ने की अनुमतियां होनी चाहिए. उपयोगिता और सुरक्षा के अपने तरीकों के मुताबिक सही विकल्प चुनें.
nodetool पैरामीटर के बारे में ज़्यादा जानने के लिए, DataStax दस्तावेज़ देखें.
कॉन्फ़िगरेशन का पहला विकल्प
nodetool चलाने वाले उपयोगकर्ता की होम डायरेक्ट्री में एक फ़ाइल बनाएं.
$HOME/.cassandra/nodetool-ssl.properties
फ़ाइल में ये लाइनें जोड़ें:
-Djavax.net.ssl.trustStore=
-Djavax.net.ssl.trustStorePassword= -Dcom.sun.management.jmxremote.registry.ssl=true ## If you are using a non standard truststore, set below, otherwise skip ## Possible values are JKS, PKCS12, BCFKS -Djavax.net.ssl.trustStoreType=PKCS12 ऊपर बताए गए ट्रस्टस्टोर पाथ को, 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=
-Djavax.net.ssl.trustStorePassword= -Dcom.sun.management.jmxremote.registry.ssl=true -Djavax.net.ssl.trustStoreType=PKCS12 -Dssl.enable=true -u -pw -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
- कैसेंड्रा पर कॉन्फ़िगर करें:
/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 कॉलमFamilies/apprepo/apiप्रॉक्सी_revisions ColumnFamilies/apprepo/apiproxies कॉलमपरिवार/ऑडिट/ऑडिट 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
आपको अपना उपयोगकर्ता नाम और पासवर्ड सिर्फ़ तब पास करना होगा, जब आपने कैसंड्रा के लिए 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
- डेटा स्ट्रीमिंग की कार्रवाइयों की स्थिति: कैसंड्रा नोड के ट्रैफ़िक पर नज़र रखें:
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 टूल के बारे में जानकारी देखें.
कैसंड्रा रिसॉर्स
यह यूआरएल देखें: 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 ब्रोकर REST API दस्तावेज़ देखें.
ब्रोकर को मॉनिटर करने के लिए, कमांड लाइन टूल का भी इस्तेमाल किया जा सकता है. उदाहरण के लिए:
curl "QPID_NODE_IP":"8090"/api/latest/broker -u "USERNAME":"PASSWORD"
Qpid के लिए एसएसएल की मदद से मॉनिटरिंग की सुविधा चालू करें
निगरानी और मैनेजमेंट के लिए ज़्यादा सुरक्षा देने के लिए, Qpid के मैनेजमेंट पोर्टल और Qpid के मैनेजमेंट एपीआई पर एसएसएल चालू करें. कुंजी और प्रमाणपत्र देने के लिए नीचे दिए गए दिशा-निर्देशों का पालन करें.
Qpid, फ़ाइल कीस्टोर का विकल्प देता है. इसे Apigee में चालू किया जा सकता है. यह टाइप, स्टैंडर्ड JKS कीस्टोर फ़ॉर्मैट को स्वीकार करता है. इसे Java और Java टूल, जैसे कि keytool समझते हैं.
कीस्टोर की तैयारी
keytool का इस्तेमाल करने के अलावा, आपको Qpidd के क्लाइंट के इस्तेमाल के लिए सीधे तौर पर प्रमाणपत्र फ़ाइल देनी होगी.
कीस्टोर जनरेट करने के लिए, Java Keytool दस्तावेज़ देखें.
ज़रूरी शर्तों की पुष्टि करने के बाद
- कीस्टोर और सर्टिफ़िकेट फ़ाइलों को
/opt/apigee/customer/application/apigee-qpidd
में डालें. - पक्का करें कि पासकोड वाली फ़ाइल को सिर्फ़ Apigee उपयोगकर्ता ही पढ़ सके:
chown apigee:apigee /opt/apigee/customer/application/apigee-qpidd/qpidd.keystore chmod 400 /opt/apigee/customer/application/apigee-qpidd/qpidd.keystore chown apigee:apigee /opt/apigee/customer/application/apigee-qpidd/qpidd-cert.pem chmod 400 /opt/apigee/customer/application/apigee-qpidd/qpidd-cert.pem
Qpid में एसएसएल चालू करना
एक बार में एक Qpid नोड पर नीचे दिया गया तरीका अपनाएं:
/opt/apigee/customer/application/qpidd.properties
फ़ाइल खोलें और ये लाइनें जोड़ें:
conf_qpidd_qpid_management.https.enabled=true conf_qpidd_qpid.keystore.storeUrl=/opt/apigee/customer/application/apigee-qpidd/qpidd.keystore conf_qpidd_qpid.keystore.password=keystore-password conf_qpidd_qpid.keystore.certificateAlias=certificate-alias conf_qpidd_qpid.keystore.certificate=/opt/apigee/customer/application/apigee-qpidd/qpidd-cert.pem
- फ़ाइल के मालिक को apigee:apigee:
chown apigee:apigee /opt/apigee/customer/application/qpidd.properties
में बदलें - Qpidd कॉन्फ़िगर करें:
apigee-service apigee-qpidd configure
- Qpidd को रीस्टार्ट करें:
apigee-service apigee-qpidd restart
- wait_for_ready की मदद से स्टेटस देखें:
apigee-service apigee-qpidd wait_for_ready
एसएसएल कॉन्फ़िगरेशन को पहले जैसा करना
फ़ाइल /opt/apigee/customer/application/qpidd.properties
से प्रॉपर्टी हटाएं या उन पर टिप्पणी करें:
conf_qpidd_qpid_management.https.enabled=true conf_qpidd_qpid.keystore.storeUrl=/opt/apigee/customer/application/apigee-qpidd/keystore
- Qpidd को कॉन्फ़िगर करना:
apigee-service apigee-qpidd configure
- Qpidd को रीस्टार्ट करें:
apigee-service apigee-qpidd restart
- wait_for_ready की मदद से स्टेटस देखें:
apigee-service apigee-qpidd wait_for_ready
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
) देखी जा सकती हैं.