Apigee Edge दस्तावेज़ देखा जा रहा है.
Apigee X दस्तावेज़ पर जाएं. जानकारी
Apigee पर, राऊटर को डिफ़ॉल्ट रूप से, गड़बड़ी के लॉग फ़ाइलों में सिर्फ़ गड़बड़ी के मैसेज को लॉग करने के लिए कॉन्फ़िगर किया जाता है. हालांकि, कई ऐसी स्थितियां हो सकती हैं जिनमें आपको यह पता लगाने के लिए ज़्यादा जानकारी इकट्ठा करनी पड़े कि कोई खास गड़बड़ी क्यों हुई है. ऐसा करने का एक तरीका यह है कि आप राऊटर को डीबग मोड में काम करने के लिए कॉन्फ़िगर करें, ताकि आपको डीबग लॉग मिल सकें. इससे आपको गड़बड़ी के बारे में ज़्यादा जानकारी पाने और उसे तेज़ी से ठीक करने में मदद मिल सकती है.
इस दस्तावेज़ में किसी खास वर्चुअल होस्ट के अनुरोधों के लिए, Apigee Edge के राऊटर पर डीबग लॉग चालू करने का तरीका बताया गया है. गलत अनुरोध, 400 गलत अनुरोध - एसएसएल सर्टिफ़िकेट में गड़बड़ी जैसी समस्या होने पर, ज़्यादा जानकारी कैप्चर करने के लिए डीबग लॉगिंग को चालू किया जा सकता है. उत्तर की सीमा (क्लाइंट ऐप्लिकेशन और राऊटर के बीच) पर.
शुरू करने से पहले
- अगर आपको NGINX की गड़बड़ी के लॉग और लॉगिंग के लेवल के बारे में नहीं पता है, तो कृपया NGINX की गड़बड़ी के लॉग का दस्तावेज़ देखें.
- उन एपीआई अनुरोधों के संगठन, एनवायरमेंट, और वर्चुअल होस्ट के नाम इकट्ठा करें जिनके लिए आपको डीबग की जानकारी इकट्ठा करनी होती है.
राऊटर पर NGINX डीबग लॉग चालू करना
यह सेक्शन, Edge राऊटर पर डीबग लॉग को चालू करने का तरीका बताता है.
प्रासंगिक वर्चुअल होस्ट कॉन्फ़िगरेशन फ़ाइल की पहचान करना
नीचे दिए गए चरण, राऊटर पर सही वर्चुअल होस्ट कॉन्फ़िगरेशन फ़ाइल का पता लगाने का तरीका बताते हैं:
- अगर आपको उस खास एपीआई अनुरोध के लिए संगठन का नाम, एनवायरमेंट का नाम, और वर्चुअल होस्ट की जानकारी है जिसे डीबग करना है, तो वर्चुअल होस्ट की कॉन्फ़िगरेशन फ़ाइल को इस तरह तय करें:
/opt/nginx/conf.d/डायरेक्ट्री पर जाएं.- यहां दिए गए निर्देश का इस्तेमाल करके,
conf.dडायरेक्ट्री में ORG_NAME_ENV_NAME_VIRTUALHOST.confफ़ाइल खोजें:ls -ltrh | grep "ORG_NAME_ENV_NAME_VIRTUALHOST_NAME"
-
अगर आपको संगठन का नाम नहीं पता है, तो एपीआई अनुरोध में इस्तेमाल किए गए होस्ट के उपनाम का इस्तेमाल करके, वर्चुअल होस्ट कॉन्फ़िगरेशन फ़ाइल की पहचान की जा सकती है:
/opt/nginx/conf.d/डायरेक्ट्री पर जाएं औरhostaliasको खोजें, जिसका इस्तेमाल करके अनुरोध किया गया था. इसके लिए, नीचे दिए गए निर्देश का इस्तेमाल करें:ls -ltrh | grep -r 'HOST_ALIAS_NAME'
सैंपल आउटपुट:
मान लें कि होस्ट का उपनाम
opdk.cert-test.comहै.ls -ltrhकमांड चलाने पर, आपको आउटपुट इस तरह दिखेगा:
राऊटर पर किसी खास वर्चुअल होस्ट के लिए डीबग लॉग करने की सुविधा चालू करना
किसी खास वर्चुअल होस्ट के लिए, Apigee राऊटर पर डीबग लॉग को चालू करने का तरीका यहां बताया गया है.
- राऊटर मशीन पर इस फ़ाइल को एडिटर में खोलें:
/opt/nginx/conf.d/ORG_NAME_ENV_NAME_VIRTUALHOST_NAME.conf. उदाहरण के लिए:vi /opt/nginx/conf.d/ORG_NAME_ENV_NAME_VIRTUALHOST_NAME.conf
- नीचे दी गई लाइन बदलें:
error_log /opt/apigee/var/log/edge-router/nginx/ORG_NAME~ENV_NAME.PORT_error_log error;
से
error_log /opt/apigee/var/log/edge-router/nginx/ORG_NAME~ENV_NAME.PORT_error_log info;
- बदलावों को सेव करें.
- NGINX फिर से लोड करने का निर्देश चलाएं. उदाहरण के लिए:
sudo /opt/nginx/scripts/apigee-nginx reload
- यह फ़ाइल अब डीबग लॉग को कैप्चर करेगी:
/opt/apigee/var/log/edge-router/nginx/ORG_NAME~ENV_NAME.PORT_error_log
- अगर आपको एक से ज़्यादा राऊटर पर डीबग लॉग कैप्चर करना है, तो हर राऊटर पर इन तरीकों को दोहराएं.
डीबग की जानकारी की पुष्टि करने के लिए, NGINX गड़बड़ी की लॉग फ़ाइल में लॉग इन किया गया है
-
जब क्लाइंट, वर्चुअल होस्ट कॉन्फ़िगरेशन से जुड़े होस्ट के उपनाम और पोर्ट पर एपीआई अनुरोध करेगा, तब डीबग लॉग इस फ़ाइल में कैप्चर किए जाएंगे:
/opt/apigee/var/log/edge-router/nginx/ORG_NAME~ENV_NAME.PORT_error_log -
पुष्टि करें कि आपको एपीआई अनुरोधों के लिए डीबग करने की जानकारी दिख रही है, जैसा कि इस उदाहरण में दिखाया गया है:
डीबग की जानकारी का नमूना:
2021/01/27 02:48:40 [warn] 27624#27624: *3777 a client request body is buffered to a temporary file /opt/apigee/var/log/edge-router/nginx/client_temp/0000000001, client: XX.XX.XX.XX, server: XX.XX.XX.XX, request: "POST /post-no-target HTTP/1.1", host: "XX.XX.XX.XX:443"
ऊपर दिखाई गई जानकारी तब कैप्चर की जाएगी, जब क्लाइंट बड़े पेलोड के साथ
POSTअनुरोध भेजेगा. डीबग लॉग करने की सुविधा चालू होने पर ही यह लॉग दिखेगा. - अगर आपको डीबग करने की अन्य जानकारी नहीं दिखती है, तो पुष्टि करें कि आपने राऊटर पर किसी खास वर्चुअल होस्ट के लिए डीबग लॉग करने की सुविधा चालू करने में बताए गए तरीके को सही तरीके से फ़ॉलो किया है. अगर आपसे कोई चरण छूट गया है, तो सभी चरणों को फिर से सही तरीके से दोहराएं.
- अगर आपको अब भी डीबग की जानकारी नहीं मिल रही है, तो कृपया Apigee Edge की सहायता टीम से संपर्क करें.
राऊटर पर किसी खास वर्चुअल होस्ट के लिए डीबग लॉग को बंद करना
यह सेक्शन बताता है कि किसी खास वर्चुअल होस्ट के लिए राऊटर पर डीबग लॉग को कैसे बंद किया जाए.
- नीचे दी गई फ़ाइल को राऊटर मशीन पर किसी एडिटर में खोलें:
/opt/nginx/conf.d/ORG_NAME_ENV_NAME_VIRTUALHOST_NAME.confउदाहरण के लिए:vi /opt/nginx/conf.d/ORG_NAME_ENV_NAME_VIRTUALHOST_NAME.conf
-
नीचे दी गई लाइन बदलें:
error_log /opt/apigee/var/log/edge-router/nginx/ORG_NAME~ENV_NAME.PORT_error_log info;
से
error_log /opt/apigee/var/log/edge-router/nginx/ORG_NAME~ENV_NAME.PORT_error_log error;
- बदलावों को सेव करें.
- NGINX फिर से लोड करने का निर्देश चलाएं. उदाहरण के लिए:
/opt/nginx/scripts/apigee-nginx reload
- यह फ़ाइल अब सिर्फ़ गड़बड़ी लॉग कैप्चर करेगी:
/opt/apigee/var/log/edge-router/nginx/ORG_NAME~ENV_NAME.PORT_error_log
- अगर आपको एक से ज़्यादा राऊटर पर डीबग लॉग को रोकना है, तो हर राऊटर पर इन तरीकों को दोहराएं.
NGINX गड़बड़ी की लॉग फ़ाइल में सिर्फ़ गड़बड़ी की जानकारी की पुष्टि की जाती है
- किसी खास वर्चुअल होस्ट कॉन्फ़िगरेशन से जुड़े होस्ट के उपनाम और पोर्ट पर कुछ एपीआई अनुरोध करें. इसके अलावा, क्लाइंट के अनुरोध किए जाने तक इंतज़ार करें.
- यह फ़ाइल देखें:
/opt/apigee/var/log/edge-router/nginx/ORG_NAME~ENV_NAME.PORT_error_log - पुष्टि करें कि आपको सिर्फ़ गड़बड़ी की जानकारी दिख रही है और अनुरोधों के लिए डीबग करने की जानकारी अब लॉग नहीं की गई है.
- अगर आपको अब भी दिखता है कि डीबग की अन्य जानकारी लॉग की जा रही है, तो पुष्टि करें कि आपने र र पर किसी खास वर्चुअल होस्ट के लिए डीबग लॉग बंद करना में दिए गए निर्देशों का सही तरीके से पालन किया हो. अगर आपसे कोई चरण छूट गया है, तो सभी चरणों को फिर से सही तरीके से दोहराएं.
- अगर आपको अब भी डीबग की जानकारी नहीं मिल रही है, तो कृपया Apigee Edge की सहायता टीम से संपर्क करें.