Sosreport টুল

আপনি Apigee Edge ডকুমেন্টেশন দেখছেন।
Apigee X ডকুমেন্টেশনে যান । তথ্য

Sosreport ওপেন সোর্স সফ্টওয়্যার SoS এর উপর ভিত্তি করে একটি সিস্টেম-স্তরের ডায়াগনস্টিক এবং ডেটা সংগ্রহের টুল। আপনি Sosreport টুল ব্যবহার করে তথ্য সংগ্রহ করতে পারেন যাতে আপনি নোডের সমস্যা ডিবাগ করতে পারেন যেখানে Apigee কম্পোনেন্ট চলছে। টুলটি নোডের ফাইল সিস্টেমে স্থানীয়ভাবে তথ্য সংগ্রহ ও সংরক্ষণ করে।

Sosreport টুল আপনার সিস্টেম থেকে কনফিগারেশনের বিশদ বিবরণ, সিস্টেমের তথ্য এবং ডায়াগনস্টিক তথ্য সংগ্রহ করে এবং একটি সংরক্ষণাগারে ডেটা সংরক্ষণ করে। Apigee উপাদানগুলির জন্য, Sosreport নিম্নলিখিতগুলি সংগ্রহ করে:

  • চলমান কার্নেল সংস্করণ
  • লোড মডিউল
  • সিস্টেম এবং পরিষেবা কনফিগারেশন ফাইল

Sosreport এছাড়াও আরও তথ্য সংগ্রহ করার জন্য বহিরাগত প্রোগ্রাম চালায়, যার মধ্যে রয়েছে:

  • Apigee সমস্ত উপাদান থেকে লগ.
  • রানটাইম ডায়াগনস্টিকস
  • নোডটুল কমান্ড ব্যবহার করে ক্যাসান্দ্রা ডায়াগনস্টিকস সংগ্রহ করা হয়েছে।

Sosreport টুলটিতে দুটি প্রধান কমান্ড রয়েছে:

  • sosreport : তথ্য সংগ্রহ এবং প্রতিবেদন তৈরির প্রাথমিক কমান্ড।
  • apigee-sosreport : একটি সহায়ক টুল যা sosreport ইনস্টল করতে এবং Apigee উপাদানগুলির জন্য নির্দিষ্ট sosreport প্লাগইনগুলি পরিচালনা করতে ব্যবহৃত হয়।

ইনস্টলেশন

এই বিভাগটি ব্যাখ্যা করে কিভাবে sosreport ইনস্টল করতে হয়।

যদি sosreport এর SoS সংস্করণটি ইতিমধ্যে ইনস্টল করা থাকে

যদি আপনার সিস্টেমে sosreport এর আসল SoS সংস্করণ ইতিমধ্যেই ইনস্টল করা থাকে, তাহলে Apigee-এর সংস্করণ সেট আপ করবেন না , কারণ ইনস্টলেশন পাথগুলি বিরোধপূর্ণ হতে পারে। পরিবর্তে, /opt/apigee/apigee-sosreport/source/plugin ডিরেক্টরি থেকে Apigee-নির্দিষ্ট প্লাগইনগুলিকে নীচের দেখানো কমান্ড ব্যবহার করে উপযুক্ত পাইথন site-packages ডিরেক্টরিতে অনুলিপি করুন। উদাহরণস্বরূপ, agigee-mgmt.py অনুলিপি করতে:

  • আপনি যদি পাইথন 2 ব্যবহার করেন তবে লিখুন: 
    sudo cp apigee-mgmt.py /usr/lib/python2.7/site-packages/sos/plugins/
  • আপনি যদি পাইথন 3 ব্যবহার করেন তবে লিখুন: 
    sudo cp apigee-mgmt.py /usr/local/lib/python3.6/site-packages/sos/plugins/

প্লাগইনগুলি ইনস্টল করা হয়েছে তা যাচাই করতে, প্রবেশ করুন

sudo sosreport --list-plugins

আপনার যদি প্রশ্ন থাকে, Apigee সহায়তার সাথে যোগাযোগ করুন।

sosreport এর Apigee এর সংস্করণ ইনস্টল করা হচ্ছে

যদি আপনার সিস্টেমে sosreport এর SoS সংস্করণ ইতিমধ্যেই ইনস্টল করা না থাকে, তাহলে আপনি যে সমস্ত নোডে এজ ফর প্রাইভেট ক্লাউড ইনস্টল করা আছে সেখানে নিম্নলিখিত কমান্ডগুলি প্রবেশ করে Apigee-এর সংস্করণ ইনস্টল করতে পারেন:

/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 হল আপনার পাইথনের ইনস্টল করা সংস্করণ।

বিকল্পভাবে, আপনি নিম্নলিখিত কমান্ডগুলির মধ্যে একটি চালাতে পারেন:

  • শুধুমাত্র 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 plugins দেখুন)। ডিফল্ট ডিরেক্টরি যেখানে প্রতিবেদনটি সংরক্ষণ করা হয় তা হয় 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 এর SoS সংস্করণ ব্যবহার করে: 
    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 প্লাগইন

নিম্নলিখিত বিভাগগুলি নিম্নলিখিত উপাদানগুলির জন্য Sosreport টুলে Apigee প্লাগইনগুলি বর্ণনা করে:

ম্যানেজমেন্ট সার্ভার

apigee-mgmt প্লাগইন ম্যানেজমেন্ট সার্ভার থেকে নিম্নলিখিত তথ্য সংগ্রহ করে:

  • সার্ভার হোস্টনাম (ডিফল্ট)
  • cpuinfo (ডিফল্ট)
  • meminfo (ডিফল্ট)
  • জাভা ভার্চুয়াল মেশিন (JVM) সেটিংস, যেমন মেমরি, Djdk.tls.allowUnsafeServerCertChange , এবং আরও অনেক কিছু (ডিফল্ট)
  • বর্তমান ব্যবস্থাপনা লগ (ডিফল্ট)
  • দশটি অনুক্রমিক শীর্ষ এবং 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 প্লাগইন ম্যানেজমেন্ট প্রসেসর (MP) থেকে নিম্নলিখিত তথ্য সংগ্রহ করে:

  • সার্ভার হোস্টনাম (ডিফল্ট)
  • cpuinfo (ডিফল্ট)
  • meminfo (ডিফল্ট)
  • বিল্ডইনফো/রিলিজ তথ্য (ডিফল্ট)
  • apigee-সমস্ত স্থিতি (ডিফল্ট)
  • সার্ভারের বিবরণ (ডিফল্ট)
  • JVM স্তরের সেটিংস, উদাহরণস্বরূপ, মেমরি, Djdk.tls.allowUnsafeServerCertChange , ইত্যাদি (ডিফল্ট)
  • বর্তমান এমপি লগ (ডিফল্ট)
  • দশটি অনুক্রমিক শীর্ষ, 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 (ডিফল্ট)
  • বিল্ডইনফো/রিলিজ তথ্য (ডিফল্ট)
  • apigee-সমস্ত স্থিতি (ডিফল্ট)
  • সার্ভারের বিবরণ (ডিফল্ট)
  • ps আউটপুট। এটি JVM স্তরের সেটিংস দেবে, উদাহরণস্বরূপ, মেমরি, 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-সমস্ত স্থিতি
  • apigee-ক্যাসান্দ্রা লগ: /opt/apigee/var/log/apigee-cassandra/ এর অধীনে সমস্ত ফাইল
  • কমিট লগ গণনা
  • শীর্ষ কমান্ডের আউটপুট
  • থ্রেড ডাম্প
  • কনফিগারেশন ফাইল: cassandra-topology.properties , cassandra.yaml , cassandra-env.sh
  • নিম্নলিখিত পরামিতিগুলির জন্য নোডটুল আউটপুট: সংস্করণ, স্থিতি, রিং, তথ্য, গসিপিনফো, কমপ্যাকশন স্ট্যাটস -এইচ, টিপিস্ট্যাট, নেটস্ট্যাট, সিএফস্ট্যাট, প্রক্সিহিস্টোগ্রাম

উদাহরণ:

সমস্ত ডিফল্ট আইটেম সংগ্রহ করতে, নিম্নলিখিতগুলির মধ্যে একটি লিখুন:

  • sosreport এর Apigee এর সংস্করণ ব্যবহার করে: 
    sudo sosreport --config-file /opt/apigee/apigee-sosreport/conf/sos.conf  -o apigee-cassandra
  • sosreport এর SoS সংস্করণ ব্যবহার করে: 
    sudo sosreport -o apigee-cassandra