Sosreport टूल

आपको Apigee Edge दस्तावेज़ दिख रहा है.
अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया है इस पेज पर जाएं Apigee X दस्तावेज़. जानकारी

Sosreport, सिस्टम-लेवल पर डाइग्नोस्टिक और डेटा इकट्ठा करने वाला एक टूल है. यह ओपन सोर्स सॉफ़्टवेयर SoS. Sosreport टूल का इस्तेमाल करके, जानकारी इकट्ठा की जा सकती है. इससे समस्याओं को डीबग करने में मदद मिलती है उन नोड में जहां Apigee घटक चल रहा है. यह टूल, नोड के फ़ाइल सिस्टम में स्थानीय तौर पर जानकारी इकट्ठा करके उसे सेव करता है.

Sosreport टूल, कॉन्फ़िगरेशन की जानकारी, सिस्टम की जानकारी, और गड़बड़ी की जानकारी आपके सिस्टम से कॉपी करता है और डेटा को एक संग्रह में सेव करता है. Apigee कॉम्पोनेंट के लिए, Sosreport यह जानकारी इकट्ठा करती है:

  • रनिंग kernel वर्शन
  • लोड किए गए मॉड्यूल
  • सिस्टम और सेवा की कॉन्फ़िगरेशन फ़ाइलें

Sosreport, आगे इकट्ठा करने के लिए बाहरी प्रोग्राम भी चलाता है जानकारी. इसमें ये शामिल हैं:

  • सभी कॉम्पोनेंट से Apigee लॉग.
  • रनटाइम में गड़बड़ी की जानकारी
  • nodetool निर्देशों का इस्तेमाल करके इकट्ठा किए गए कैसंड्रा डाइग्नोस्टिक्स को.

Sosreport टूल में दो मुख्य कमांड होते हैं:

  • sosreport: डेटा इकट्ठा करने और रिपोर्ट बनाने के लिए मुख्य निर्देश.
  • apigee-sosreport: इंस्टॉल करने के लिए इस्तेमाल किया जाने वाला सहायक टूल Apigee कॉम्पोनेंट के लिए, खास तौर पर sosreport प्लगिन मैनेज करें और sosreport को मैनेज करें.

इंस्टॉल करना

इस सेक्शन में, sosreport को इंस्टॉल करने का तरीका बताया गया है.

अगर sosreport का SoS वर्शन पहले से इंस्टॉल किया गया है

अगर मूल sosreport का SoS वर्शन आपके सिस्टम पर पहले से इंस्टॉल है, Apigee के वर्शन को सेट अप न करें, क्योंकि इंस्टॉलेशन पाथ में टकराव हो सकता है. इसके बजाय, डायरेक्ट्री से Apigee के लिए बने प्लगिन कॉपी करें सही Python से /opt/apigee/apigee-sosreport/source/plugin site-packages डायरेक्ट्री, जो नीचे दिखाए गए निर्देश जैसे निर्देश का इस्तेमाल करती है. उदाहरण के लिए, agigee-mgmt.py को कॉपी करने के लिए:

  • अगर Python 2 का इस्तेमाल किया जा रहा है, तो यह डालें: 
    sudo cp apigee-mgmt.py /usr/lib/python2.7/site-packages/sos/plugins/
    अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया है
  • अगर Python 3 का इस्तेमाल किया जा रहा है, तो यह डालें: 
    sudo cp apigee-mgmt.py /usr/local/lib/python3.6/site-packages/sos/plugins/
    अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया है

प्लगिन इंस्टॉल हो जाने की पुष्टि करने के लिए,

sudo sosreport --list-plugins

अगर आपको कुछ पूछना है, तो Apigee की सहायता टीम से संपर्क करें.

sosreport का Apigee का वर्शन इंस्टॉल हो रहा है

अगर sosreport का एसओएस वर्शन आपके सिस्टम पर पहले से इंस्टॉल है, तो आप दर्ज करके Apigee का वर्शन इंस्टॉल कर सकते हैं जिन नोड पर प्राइवेट क्लाउड के लिए Edge इंस्टॉल है, उन सभी पर ये निर्देश दिए गए हैं: 

/opt/apigee/apigee-service/bin/apigee-service apigee-sosreport install
/opt/apigee/apigee-service/bin/apigee-service apigee-sosreport setup

यह जांचने के लिए कि sosreport इंस्टॉल किया गया है या नहीं, पुष्टि करें कि Apigee, इस डायरेक्ट्री में मौजूद है:

/usr/lib/pythonx.x/site-packages/sos/plugins

जहां pythonx.x आपके Python का इंस्टॉल किया गया वर्शन है.

इसके अलावा, इनमें से कोई भी निर्देश दिया जा सकता है:

  • सिर्फ़ Apigee के लिए बने प्लगिन की पुष्टि करने के लिए: 
    apigee-service apigee-sosreport diagnose -l
    अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया है

    इससे, Apigee के लिए बने प्लगिन की यह सूची दिखती है.

    sosreport (version 3.9)

The following plugins are currently enabled:

apigee-mgmt          This is the apigee plugin for edge-management-server
apigee-mp            This is the apigee plugin for edge-message-processor
apigee-rrt           This is the apigee plugin for edge-router
apigee-sample        Main diagnostics gatehring class
  • सभी प्लगिन की पुष्टि करने के लिए: 
    apigee-service apigee-sosreport diagnose -s -l
    अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया है

    इससे Sosreport के साथ उपलब्ध प्लगिन की यह सूची मिलती है:

    sosreport (version 3.9)

The following plugins are currently enabled:

 acpid                ACPI daemon information
 alternatives         System alternatives
 anacron              Anacron job scheduling service
 apigee-cassandra     This is the base class for sosreport plugins. Plugins should subclass
    this and set the class variables where applicable. ←truncated→
 apigee-mgmt          This is the base class for sosreport plugins. Plugins should subclass
    this and set the class variables where applicable. ←truncated→
 apigee-mp            Main diagnostics gathering class
 apigee-rrt           This is the base class for sosreport plugins. Plugins should subclass
    this and set the class variables where applicable. ←truncated→

………………………………………………….
………………………………………………….
………………………………………………….
←truncated→

रिपोर्ट बनाना

Sosreport टूल का इस्तेमाल करके रिपोर्ट बनाने के लिए, sosreport कमांड चलाएं ज़रूरी प्लगिन विकल्प के साथ (Apigee प्लगिन देखें). कॉन्टेंट बनाने डिफ़ॉल्ट डायरेक्ट्री, जहां रिपोर्ट सेव की जाती है वह tmp या /var/tmp है. किसी दूसरी डायरेक्ट्री को पास करके, उस डायरेक्ट्री को बदला जा सकता है जहां रिपोर्ट सेव होती है tmp-dir विकल्प को चुनें. उदाहरण के लिए, को मैनेज कर सकता है और इसे my_report-dir नाम की डायरेक्ट्री सेव कर सकता है, इनमें से कोई एक डालें:

  • sosreport के Apigee के वर्शन का इस्तेमाल करना: 
    sudo sosreport --config-file /opt/apigee/apigee-sosreport/conf/sos.conf -o apigee-mgmt  --batch --tmp-dir=my_report-dir
  • Sosreport के एसओएस वर्शन का इस्तेमाल करना: 
    sudo sosreport -o apigee-mgmt  --batch --tmp-dir=my_report-dir
    अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया है

यह रिपोर्ट, डायरेक्ट्री में .tar.xz फ़ाइल में सेव होती है. ऐसा करने के लिए, tmp-dir विकल्प. .tar.xz फ़ाइल की जगह, STDOUT पर और चेकसम पर दिखाई जाती है. उदाहरण के लिए:

Your sosreport has been generated and saved in:
 /var/sosreport-prc-test-0-9613-2021-07-12-orwxufx.tar.xz
The checksum is: 5a8b97c6020346a688254c8b04ef86ec
For more available options for sosreport, read the man file:
sudo man sosreport

यह रिपोर्ट, डायरेक्ट्री में .tar.xz फ़ाइल में सेव होती है. ऐसा करने के लिए, tmp-dir विकल्प. .tar.xz file की जगह को STDOUT पर दिखाया गया है. साथ ही, चेकसम. उदाहरण के लिए:

sosreport के लिए उपलब्ध और विकल्पों के लिए, man फ़ाइल पढ़ें:

sudo man sosreport

Apigee प्लगिन

यहां दिए गए सेक्शन में, Apigee प्लगिन के बारे में बताया गया है. ये कॉम्पोनेंट:

मैनेजमेंट सर्वर

apigee-mgmt प्लगिन, मैनेजमेंट सर्वर:

  • सर्वर होस्टनेम (डिफ़ॉल्ट)
  • cpuinfo (डिफ़ॉल्ट)
  • meminfo (डिफ़ॉल्ट)
  • Java वर्चुअल मशीन (JVM) सेटिंग, जैसे कि मेमोरी, Djdk.tls.allowUnsafeServerCertChange और इसी तरह के अन्य विकल्प (डिफ़ॉल्ट)
  • मौजूदा मैनेजमेंट लॉग (डिफ़ॉल्ट)
  • 10 क्रम में सबसे ऊपर और jstacks आउटपुट (डिफ़ॉल्ट)
  • पूरा मैनेजमेंट लॉग फ़ोल्डर (ज़रूरी नहीं)
  • कॉन्फ़िगरेशन फ़ाइलें (ज़रूरी नहीं)

उदाहरण:

सभी डिफ़ॉल्ट आइटम इकट्ठा करने के लिए, इनमें से कोई एक वैल्यू डालें:

  • sosreport के Apigee के वर्शन का इस्तेमाल करना: 
    sudo sosreport --config-file /opt/apigee/apigee-sosreport/conf/sos.conf  -o apigee-mgmt --batch my_report-dir
  • sosreport का SoS वर्शन इस्तेमाल करना: 
    sudo sosreport -o apigee-mgmt --batch my_report-dir

सभी डिफ़ॉल्ट आइटम और निर्देश में दिए गए वैकल्पिक आइटम को इकट्ठा करने के लिए, उदाहरण के लिए, कॉन्फ़िगरेशन फ़ाइलों और सभी लॉग के लिए, इनमें से कोई एक वैल्यू डालें:

  • sosreport के Apigee के वर्शन का इस्तेमाल करना: 
    sudo sosreport --config-file /opt/apigee/apigee-sosreport/conf/sos.conf  -o apigee-mgmt --batch -k apigee-mgmt.config-files -k apigee-mgmt.all-logs
  • sosreport का SoS वर्शन इस्तेमाल करना: 
    sudo sosreport -o apigee-mgmt --batch -k apigee-mgmt.config-files -k apigee-mgmt.all-logs

सभी जानकारी इकट्ठा करने के लिए, इनमें से कोई एक जानकारी डालें:

  • sosreport के Apigee के वर्शन का इस्तेमाल करना: 
    sudo sosreport --config-file /opt/apigee/apigee-sosreport/conf/sos.conf  -o apigee-mgmt --batch -k apigee-mgmt.config-files -k apigee-mgmt.all-logs

    इसके अलावा, यह जानकारी भी डाली जा सकती है:

    sudo sosreport --config-file /opt/apigee/apigee-sosreport/conf/sos.conf  -o apigee-mgmt --batch -a
  • sosreport का SoS वर्शन इस्तेमाल करना: 
    sudo sosreport -o apigee-mgmt --batch -k apigee-mgmt.config-files -k apigee-mgmt.all-logs

    इसके अलावा, यह जानकारी भी डाली जा सकती है:

    sudo sosreport -o apigee-mgmt --batch -a

मैसेज प्रोसेसर

apigee-mp प्लगिन, मैनेजमेंट प्रोसेसर (एमपी):

  • सर्वर का होस्टनेम (डिफ़ॉल्ट)
  • cpuinfo (डिफ़ॉल्ट)
  • meminfo (डिफ़ॉल्ट)
  • बिल्ड जानकारी/रिलीज़ की जानकारी (डिफ़ॉल्ट)
  • सभी स्थिति (डिफ़ॉल्ट)
  • सर्वर की जानकारी (डिफ़ॉल्ट)
  • जेवीएम लेवल की सेटिंग, जैसे कि मेमोरी, Djdk.tls.allowUnsafeServerCertChange, वगैरह (डिफ़ॉल्ट)
  • मौजूदा एमपी लॉग (डिफ़ॉल्ट)
  • 10 क्रम में सबसे ऊपर, jstacks, और NIO मेट्रिक का आउटपुट (डिफ़ॉल्ट)
  • पूरा एमपी लॉग फ़ोल्डर (ज़रूरी नहीं)
  • क्लासिफ़िकेशन ट्री (ज़रूरी नहीं)
  • हीप डंप (ज़रूरी नहीं)
  • कॉन्फ़िगरेशन फ़ाइलें (ज़रूरी नहीं)
  • रनटाइम ट्रेस (ज़रूरी नहीं और सिर्फ़ org:env:api:rev detail होने पर) उपलब्ध है). ध्यान दें: रनटाइम के अनुरोधों को इकट्ठा करने के लिए, प्लग इन 25 सेकंड तक इंतज़ार करता है.

उदाहरण:

सभी डिफ़ॉल्ट आइटम इकट्ठा करने के लिए, इनमें से कोई एक वैल्यू डालें:

  • sosreport के Apigee के वर्शन का इस्तेमाल करना: 
    sudo sosreport --config-file /opt/apigee/apigee-sosreport/conf/sos.conf  -o apigee-mp --batch
  • sosreport का SoS वर्शन इस्तेमाल करना: 
    sudo sosreport -o apigee-mp --batch

सभी डिफ़ॉल्ट आइटम के अलावा, इकट्ठा करने के लिए दूसरे आइटम भी तय किए जा सकते हैं. हालांकि, ऐसा करना ज़रूरी नहीं है. उदाहरण के लिए, फ़्लैग का इस्तेमाल करके हीप डंप की जानकारी देने के लिए -k apigee-mp.heap, इनमें से कोई एक डालें:

  • sosreport के Apigee के वर्शन का इस्तेमाल करना: 
    sudo sosreport --config-file /opt/apigee/apigee-sosreport/conf/sos.conf  -o apigee-mp --batch -k apigee-mp.heap
  • sosreport का SoS वर्शन इस्तेमाल करना: 
    sudo sosreport -o apigee-mp --batch -k apigee-mp.heap

इसी तरह, नीचे दिए गए वैकल्पिक आइटम के बारे में भी बताया जा सकता है:

-k apigee-mp.deployments
-k apigee-mp.heap
-k apigee-mp.all-logs
-k apigee-mp.config-files
-k apigee-mp.trace=gsc-cps:test:httpbin:3

आप एक निर्देश में कई विकल्प दे सकते हैं. उदाहरण के लिए:

  • sosreport के Apigee के वर्शन का इस्तेमाल करना: 
    sudo sosreport --config-file /opt/apigee/apigee-sosreport/conf/sos.conf  -o apigee-mp --batch -k apigee-mp.deployments -k apigee-mp.all-logs
  • sosreport का SoS वर्शन इस्तेमाल करना: 
    sudo sosreport -o apigee-mp --batch -k apigee-mp.deployments -k apigee-mp.all-logs

ट्रेस को छोड़कर बाकी सारी जानकारी इकट्ठा करने के लिए, इनमें से कोई एक जानकारी डालें:

  • sosreport के Apigee के वर्शन का इस्तेमाल करना: 
    sudo sosreport --config-file /opt/apigee/apigee-sosreport/conf/sos.conf  -o apigee-mp --batch -a
  • sosreport का SoS वर्शन इस्तेमाल करना: 
    sudo sosreport -o apigee-mp --batch -a

राऊटर

apigee-rrt प्लगिन, राऊटर:

  • सर्वर का होस्टनेम (डिफ़ॉल्ट)
  • cpuinfo (डिफ़ॉल्ट)
  • meminfo (डिफ़ॉल्ट)
  • बिल्ड जानकारी/रिलीज़ की जानकारी (डिफ़ॉल्ट)
  • सभी स्थिति (डिफ़ॉल्ट)
  • सर्वर की जानकारी (डिफ़ॉल्ट)
  • पीएस आउटपुट. इससे जेवीएम लेवल की सेटिंग मिलेगी. उदाहरण के लिए, मेमोरी, Djdk.tls.allowUnsafeServerCertChange वगैरह (डिफ़ॉल्ट).
  • मौजूदा राऊटर लॉग (डिफ़ॉल्ट)
  • vhost फ़ाइल के नाम की सूची जिसमें खराब फ़ाइल नाम भी शामिल हैं (डिफ़ॉल्ट)
  • पूरा राऊटर लॉग फ़ोल्डर (ज़रूरी नहीं)
  • कॉन्फ़िगरेशन फ़ाइलें (ज़रूरी नहीं)

उदाहरण:

सभी डिफ़ॉल्ट आइटम इकट्ठा करने के लिए, इनमें से कोई एक वैल्यू डालें:

  • sosreport के Apigee के वर्शन का इस्तेमाल करना: 
    sudo sosreport --config-file /opt/apigee/apigee-sosreport/conf/sos.conf  -o apigee-rrt --batch
  • sosreport का SoS वर्शन इस्तेमाल करना: 
    sudo sosreport -o apigee-rrt --batch

सभी डिफ़ॉल्ट आइटम के अलावा, इकट्ठा करने के लिए दूसरे आइटम भी तय किए जा सकते हैं. हालांकि, ऐसा करना ज़रूरी नहीं है. उदाहरण के लिए, 'फ़्लैग' का इस्तेमाल करके, पूरे लॉग फ़ोल्डर को -k apigee-rrt.all-logs, इनमें से कोई एक डालें:

  • sosreport के Apigee के वर्शन का इस्तेमाल करना: 
    sudo sosreport --config-file /opt/apigee/apigee-sosreport/conf/sos.conf  -o apigee-rrt --batch -k apigee-rrt.all-logs
  • sosreport का SoS वर्शन इस्तेमाल करना: 
    sudo sosreport -o apigee-rrt --batch -k apigee-rrt.all-logs

इसी तरह, नीचे दिए गए वैकल्पिक आइटम के बारे में भी बताया जा सकता है:

-k apigee-rrt.all-logs
-k apigee-rrt.config-files

सारा डेटा इकट्ठा करने के लिए:

  • sosreport के Apigee के वर्शन का इस्तेमाल करना: 
    sudo sosreport --config-file /opt/apigee/apigee-sosreport/conf/sos.conf  -o apigee-rrt --batch -a
  • sosreport का SoS वर्शन इस्तेमाल करना: 
    sudo sosreport -o apigee-rrt --batch -a

कास्सांद्रा

apigee-cassandra प्लगिन, इनसे यह जानकारी इकट्ठा करता है कैसंड्रा नोड:

  • मशीन के आंकड़े: 
    "hostname -i"
"cat /proc/cpuinfo"
"cat /proc/meminfo"
"ulimit -a"
"ps auxw"
"df -kh"
"du -sh"
"netstat -ntlpu"
"free -h"
"ifconfig -h"
"ps -ef"
    अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया है
  • Apigee कॉम्पोनेंट का स्टेटस और वर्शन apigee-सभी वर्शन && एपीआईजी-ऑल स्टेटस
  • apigee-कैसांद्रा लॉग: /opt/apigee/var/log/apigee-cassandra/ से कम आकार की सभी फ़ाइलें
  • कमिट लॉग की संख्या
  • निर्देश Top का आउटपुट
  • थ्रेड डंप
  • कॉन्फ़िगरेशन फ़ाइलें: cassandra-topology.properties, cassandra.yaml, cassandra-env.sh
  • इन पैरामीटर के लिए Nodetool आउटपुट: वर्शन, स्टेटस, रिंग, जानकारी, gossipinfo, कॉम्पेक्शनस्टेट -H, tpstats, नेटस्टेट, सीएफ़स्टेट, प्रॉक्सीहिस्टोग्राम

उदाहरण:

सभी डिफ़ॉल्ट आइटम इकट्ठा करने के लिए, इनमें से कोई एक वैल्यू डालें:

  • sosreport के Apigee के वर्शन का इस्तेमाल करना: 
    sudo sosreport --config-file /opt/apigee/apigee-sosreport/conf/sos.conf  -o apigee-cassandra
  • sosreport का SoS वर्शन इस्तेमाल करना: 
    sudo sosreport -o apigee-cassandra