আপনি Apigee Edge-এর ডকুমেন্টেশন দেখছেন।
Apigee X ডকুমেন্টেশন .info- তে যান।
Sosreport হলো একটি সিস্টেম-স্তরের ডায়াগনস্টিক এবং ডেটা সংগ্রহের টুল, যা ওপেন সোর্স সফটওয়্যার SoS- এর উপর ভিত্তি করে তৈরি। যেসব নোডে একটি Apigee কম্পোনেন্ট চলছে, সেখানকার সমস্যা ডিবাগ করতে সাহায্যকারী তথ্য সংগ্রহের জন্য আপনি Sosreport টুলটি ব্যবহার করতে পারেন। টুলটি নোডের ফাইল সিস্টেমে স্থানীয়ভাবে তথ্য সংগ্রহ ও সংরক্ষণ করে।
Sosreport টুলটি আপনার সিস্টেম থেকে কনফিগারেশনের বিবরণ, সিস্টেমের তথ্য এবং ডায়াগনস্টিক তথ্য সংগ্রহ করে এবং ডেটাগুলো একটি আর্কাইভে সংরক্ষণ করে। Apigee কম্পোনেন্টগুলোর জন্য, Sosreport নিম্নলিখিত তথ্যগুলো সংগ্রহ করে:
- চলমান কার্নেল সংস্করণ
- লোড করা মডিউল
- সিস্টেম এবং পরিষেবা কনফিগারেশন ফাইল
সোসরিপোর্ট অতিরিক্ত তথ্য সংগ্রহের জন্য বাহ্যিক প্রোগ্রামও চালায়, যার মধ্যে রয়েছে:
- Apigee সমস্ত কম্পোনেন্ট থেকে লগ গ্রহণ করে।
- রানটাইম ডায়াগনস্টিকস
- nodetool কমান্ড ব্যবহার করে ক্যাসান্ড্রা ডায়াগনস্টিকস সংগ্রহ করা হয়েছে।
Sosreport টুলে দুটি প্রধান কমান্ড রয়েছে:
-
sosreport: ডেটা সংগ্রহ এবং রিপোর্ট তৈরির প্রধান কমান্ড। -
apigee-sosreport: Apigee কম্পোনেন্টগুলোর জন্য নির্দিষ্টsosreportইনস্টল ওsosreportপ্লাগইনগুলো পরিচালনা করতে ব্যবহৃত একটি সহায়ক টুল।
ইনস্টলেশন
নিম্নলিখিত সারণিতে এজ ফর প্রাইভেট ক্লাউড সমর্থিত সংস্করণগুলিতে Sosreport টুলের প্রাপ্যতা এবং ইনস্টলেশন পদ্ধতি বিস্তারিতভাবে বর্ণনা করা হয়েছে।
| OPDK সংস্করণ | নতুন ইনস্টল | ইন-প্লেস আপগ্রেড |
|---|---|---|
| ৪.৫০.০০.১১ - ৪.৫২.০১.০০ | ম্যানুয়াল ইনস্টলেশন প্রয়োজন | ম্যানুয়াল ইনস্টলেশন প্রয়োজন |
| ৪.৫২.০১.০১+ | ডিফল্টভাবে ইনস্টল করা | ডিফল্টভাবে ইনস্টল করা |
| অ্যামাজন লিনাক্স ২০২৩+ | সমর্থিত নয় | সমর্থিত নয় |
Edge for Private Cloud-এর 4.52.01.01 এবং পরবর্তী সংস্করণগুলিতে সেট আপ বা আপডেট করার সময়, Sosreport টুলটি সমস্ত নোডে ডিফল্টরূপে ইনস্টল করা থাকে।
Sosreport টুল এবং এর প্লাগইনগুলির ইনস্টলেশন ও সংস্করণ যাচাই করতে আপনি নিম্নলিখিত কমান্ডটি চালাতে পারেন:
apigee-service apigee-sosreport version
Sosreport টুল সমর্থনকারী সমস্ত প্লাগইনের তালিকা পেতে, নিম্নলিখিত কমান্ডটি ব্যবহার করুন:
sudo sosreport --list-plugins
শুধুমাত্র Apigee-এর নিজস্ব প্লাগইনগুলো তালিকাভুক্ত করতে, নিম্নলিখিত কমান্ডটি চালান:
sudo sosreport --list-plugins | grep apigee
Edge for Private Cloud-এর 4.50.00.11 থেকে 4.52.01.00 সংস্করণ পর্যন্ত Sosreport টুলটি উপলব্ধ, তবে আপনার পরিবেশের উপর নির্ভর করে এটির ম্যানুয়াল সেটআপের প্রয়োজন হতে পারে।
যদি sosreport এর SoS সংস্করণটি ইতিমধ্যেই ইনস্টল করা থাকে
যদি আপনার সিস্টেমে sosreport এর আসল SoS সংস্করণটি আগে থেকেই ইনস্টল করা থাকে, তাহলে Apigee-এর সংস্করণটি সেট আপ করবেন না , কারণ ইনস্টলেশন পাথগুলোর মধ্যে সংঘাত হতে পারে। এর পরিবর্তে, নিচে দেখানো কমান্ডগুলোর মতো একটি কমান্ড ব্যবহার করে /opt/apigee/apigee-sosreport/source/plugin ডিরেক্টরি থেকে Apigee-এর জন্য নির্দিষ্ট প্লাগইনগুলো উপযুক্ত Python site-packages ডিরেক্টরিতে কপি করুন। উদাহরণস্বরূপ, apigee-mgmt.py কপি করতে:
- আপনি যদি পাইথন ২ ব্যবহার করেন, তাহলে লিখুন:
sudo cp apigee-mgmt.py /usr/lib/python2.7/site-packages/sos/plugins/
- আপনি যদি পাইথন ৩ ব্যবহার করেন, তাহলে লিখুন:
sudo cp apigee-mgmt.py /usr/local/lib/python3.6/site-packages/sos/plugins/
প্লাগইনগুলি ইনস্টল হয়েছে কিনা তা যাচাই করতে, প্রবেশ করুন
sudo sosreport --list-plugins
আপনার কোনো প্রশ্ন থাকলে Apigee সাপোর্টে যোগাযোগ করুন।
নিম্নলিখিত অংশে `sosreport`-এর 4.50.00.11 থেকে 4.52.01.00 সংস্করণ পর্যন্ত ইনস্টল করার পদ্ধতি ব্যাখ্যা করা হয়েছে।
Apigee-এর sosreport সংস্করণ ইনস্টল করা
যদি আপনার সিস্টেমে sosreport এর SoS সংস্করণটি আগে থেকে ইনস্টল করা না থাকে, তাহলে Edge for Private Cloud ইনস্টল করা সমস্ত নোডে নিম্নলিখিত কমান্ডগুলি প্রবেশ করিয়ে আপনি 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 gathering 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→
একটি প্রতিবেদন তৈরি করা
Edge for Private Cloud সংস্করণ 4.52.01.01 এবং পরবর্তী সংস্করণ
Sosreport টুলটি আপনার নোডে বিদ্যমান উপাদানগুলো শনাক্ত করতে পারে এবং সাপোর্ট টিমের বিশ্লেষণের জন্য প্রয়োজনীয় সমস্ত লগের একটি রিপোর্ট তৈরি করতে পারে।
রিপোর্ট তৈরি করতে, নিম্নলিখিত কমান্ডটি ব্যবহার করুন:
apigee-service apigee-sosreport diagnose
প্রয়োজনে আপনি নিম্নলিখিত ফ্ল্যাগগুলো যোগ করতে পারেন:
- -f | --file | --config : সেটআপ করার সময় ব্যবহৃত কনফিগারেশন ফাইলের পাথ।
Example: apigee-service apigee-sosreport diagnose -f /path/to/configuration.file
- -o | --output : তৈরি করা sosreport-কে একটি নির্দিষ্ট ডিরেক্টরি বা পাথে রিডাইরেক্ট করতে
Example: apigee-service apigee-sosreport diagnose -o /path/to/output_directory/
Edge for Private Cloud-এর সংস্করণ 4.50.00.11 থেকে 4.52.01.00 পর্যন্ত
Sosreport টুল ব্যবহার করে একটি রিপোর্ট তৈরি করতে, প্রয়োজনীয় প্লাগইন অপশন সহ sosreport কমান্ডটি চালান ( Apigee প্লাগইন দেখুন)। রিপোর্টটি ডিফল্টভাবে tmp অথবা /var/tmp ডিরেক্টরিতে সংরক্ষিত হয়। আপনি tmp-dir অপশনে একটি ভিন্ন ডিরেক্টরি পাস করে রিপোর্টটি সংরক্ষণের ডিরেক্টরি পরিবর্তন করতে পারেন। উদাহরণস্বরূপ, ম্যানেজমেন্ট সার্ভারে একটি রিপোর্ট তৈরি করতে এবং my_report-dir নামের একটি ডিরেক্টরিতে এটি সংরক্ষণ করতে, নিম্নলিখিতগুলির মধ্যে একটি লিখুন:
- Apigee-এর
sosreportসংস্করণটি ব্যবহার করে: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
রিপোর্টটি tmp-dir অপশন ব্যবহার করে আপনার নির্দিষ্ট করা ডিরেক্টরিতে একটি .tar.xz ফাইলে সংরক্ষিত হয়। .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
রিপোর্টটি tmp-dir অপশন ব্যবহার করে আপনার নির্দিষ্ট করা ডিরেক্টরিতে একটি .tar.xz ফাইলে সংরক্ষিত হয়। .tar.xz file অবস্থান এবং চেকসাম STDOUT এ দেখানো হয়। উদাহরণস্বরূপ:
sosreport এর আরও উপলব্ধ বিকল্পগুলির জন্য, man ফাইলটি পড়ুন:
sudo man sosreport
Apigee প্লাগইন
নিম্নলিখিত বিভাগগুলিতে Sosreport টুলের নিম্নলিখিত উপাদানগুলির জন্য Apigee প্লাগইনগুলি বর্ণনা করা হয়েছে:
ম্যানেজমেন্ট সার্ভার
apigee-mgmt প্লাগইনটি ম্যানেজমেন্ট সার্ভার থেকে নিম্নলিখিত তথ্য সংগ্রহ করে:
- সার্ভার হোস্টনাম (ডিফল্ট)
- সিপিইউ তথ্য (ডিফল্ট)
- মেমইনফো (ডিফল্ট)
- জাভা ভার্চুয়াল মেশিন (JVM) সেটিংস, যেমন মেমরি,
Djdk.tls.allowUnsafeServerCertChange, ইত্যাদি (ডিফল্ট) - বর্তমান ম্যানেজমেন্ট লগ (ডিফল্ট)
- পরপর দশটি টপ এবং জেস্ট্যাকস আউটপুট (ডিফল্ট)
- সম্পূর্ণ ম্যানেজমেন্ট লগ ফোল্ডার (ঐচ্ছিক)
- কনফিগারেশন ফাইল (ঐচ্ছিক)
উদাহরণ:
সমস্ত ডিফল্ট আইটেম সংগ্রহ করতে, নিম্নলিখিতগুলির মধ্যে একটি লিখুন:
- Apigee-এর
sosreportসংস্করণটি ব্যবহার করে: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
সমস্ত ডিফল্ট আইটেম এবং কমান্ডে উল্লেখিত ঐচ্ছিক আইটেম(গুলি), যেমন কনফিগারেশন ফাইল এবং সমস্ত লগ সংগ্রহ করতে, নিম্নলিখিতগুলির মধ্যে একটি লিখুন:
- Apigee-এর
sosreportসংস্করণটি ব্যবহার করে: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
সবকিছু সংগ্রহ করতে, নিম্নলিখিতগুলির মধ্যে একটি লিখুন:
- Apigee-এর
sosreportসংস্করণটি ব্যবহার করে: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) থেকে নিম্নলিখিত তথ্য সংগ্রহ করে:
- সার্ভার হোস্টনাম (ডিফল্ট)
- সিপিইউ তথ্য (ডিফল্ট)
- মেমইনফো (ডিফল্ট)
- বিল্ড তথ্য/রিলিজ তথ্য (ডিফল্ট)
- apigee-all অবস্থা (ডিফল্ট)
- সার্ভারের বিবরণ (ডিফল্ট)
- JVM স্তরের সেটিংস, যেমন, মেমরি,
Djdk.tls.allowUnsafeServerCertChange, ইত্যাদি। (ডিফল্ট) - বর্তমান এমপি লগ (ডিফল্ট)
- পরপর দশটি টপ, জেস্ট্যাকস এবং এনআইও মেট্রিক্স আউটপুট (ডিফল্ট)
- সম্পূর্ণ এমপি লগ ফোল্ডার (ঐচ্ছিক)
- শ্রেণিবিন্যাস বৃক্ষ (ঐচ্ছিক)
- হিপ ডাম্প (ঐচ্ছিক)
- কনফিগারেশন ফাইল (ঐচ্ছিক)
- রানটাইম ট্রেস (ঐচ্ছিক এবং শুধুমাত্র যখন
org:env:api:rev detailপ্রদান করা হয়)। দ্রষ্টব্য: রানটাইম অনুরোধগুলি সংগ্রহ করার জন্য প্লাগইনটি ২৫ সেকেন্ড অপেক্ষা করে।
উদাহরণ:
সমস্ত ডিফল্ট আইটেম সংগ্রহ করতে, নিম্নলিখিতগুলির মধ্যে একটি লিখুন:
- Apigee-এর
sosreportসংস্করণটি ব্যবহার করে: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 ফ্ল্যাগটি ব্যবহার করে হিপ ডাম্প নির্দিষ্ট করতে, নিম্নলিখিতগুলির মধ্যে একটি লিখুন:
- Apigee-এর
sosreportসংস্করণটি ব্যবহার করে: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
আপনি একটি কমান্ডে একাধিক অপশন নির্দিষ্ট করতে পারেন। উদাহরণস্বরূপ:
- Apigee-এর
sosreportসংস্করণটি ব্যবহার করে: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
চিহ্ন ছাড়া বাকি সবকিছু সংগ্রহ করতে, নিম্নলিখিতগুলির মধ্যে একটি লিখুন:
- Apigee-এর
sosreportসংস্করণটি ব্যবহার করে: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 প্লাগইনটি রাউটার থেকে নিম্নলিখিত তথ্য সংগ্রহ করে:
- সার্ভার হোস্টনাম (ডিফল্ট)
- সিপিইউ তথ্য (ডিফল্ট)
- মেমইনফো (ডিফল্ট)
- বিল্ড তথ্য/রিলিজ তথ্য (ডিফল্ট)
- apigee-all অবস্থা (ডিফল্ট)
- সার্ভারের বিবরণ (ডিফল্ট)
- ps আউটপুট। এটি JVM লেভেলের সেটিংস দেবে, যেমন—মেমরি, Djdk.tls.allowUnsafeServerCertChange, ইত্যাদি (ডিফল্ট)।
- বর্তমান রাউটার লগ (ডিফল্ট)
- ত্রুটিপূর্ণ ফাইলের নাম সহ (ডিফল্ট) vhost ফাইলের নামের তালিকা
- সম্পূর্ণ রাউটার লগ ফোল্ডার (ঐচ্ছিক)
- কনফিগারেশন ফাইল (ঐচ্ছিক)
উদাহরণ:
সমস্ত ডিফল্ট আইটেম সংগ্রহ করতে, নিম্নলিখিতগুলির মধ্যে একটি লিখুন:
- Apigee-এর
sosreportসংস্করণটি ব্যবহার করে: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 ফ্ল্যাগটি ব্যবহার করে সম্পূর্ণ লগ ফোল্ডারটি নির্দিষ্ট করতে, নিম্নলিখিতগুলির মধ্যে একটি লিখুন:
- Apigee-এর
sosreportসংস্করণটি ব্যবহার করে: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
সবকিছু সংগ্রহ করতে:
- Apigee-এর
sosreportসংস্করণটি ব্যবহার করে: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-all version && apigee-all status
- apigee-cassandra লগ:
/opt/apigee/var/log/apigee-cassandra/এর অধীনে থাকা সমস্ত ফাইল - কমিট লগ গণনা
- Top কমান্ডের আউটপুট
- থ্রেড ডাম্প
- কনফিগারেশন ফাইলসমূহ:
cassandra-topology.properties,cassandra.yaml,cassandra-env.sh - নিম্নলিখিত প্যারামিটারগুলির জন্য Nodetool আউটপুট: version, status, ring, info, gossipinfo, compactionstats -H, tpstats, netstats, cfstats, proxyhistograms
উদাহরণ:
সমস্ত ডিফল্ট আইটেম সংগ্রহ করতে, নিম্নলিখিতগুলির মধ্যে একটি লিখুন:
- Apigee-এর
sosreportসংস্করণটি ব্যবহার করে:sudo sosreport --config-file /opt/apigee/apigee-sosreport/conf/sos.conf -o apigee-cassandra
-
sosreportএর SoS সংস্করণ ব্যবহার করা:sudo sosreport -o apigee-cassandra