আপনি Apigee Edge ডকুমেন্টেশন দেখছেন।
Apigee X ডকুমেন্টেশন দেখুন। তথ্য
Sosreport হল সিস্টেম-লেভেল ডায়াগনস্টিক এবং ডেটা সংগ্রহ করার টুল, এটি ওপেন সোর্স সফ্টওয়্যার SoS-এর উপর ভিত্তি করে তৈরি। আপনি Sosreport টুল ব্যবহার করে তথ্য সংগ্রহ করতে পারেন যা আপনাকে নোডে সমস্যা ডিবাগ করতে সাহায্য করবে যেখানে একটি Apigee কম্পোনেন্ট চলছে। টুলটি নোডের ফাইল সিস্টেমে লোকালভাবে তথ্য সংগ্রহ ও স্টোর করে।
Sosreport টুল আপনার সিস্টেম থেকে কনফিগারেশনের বিবরণ, সিস্টেমের তথ্য এবং ডায়াগনস্টিক তথ্য সংগ্রহ করে এবং ডেটা একটি আর্কাইভে স্টোর করে। Apigee কম্পোনেন্টের জন্য, Sosreport নিম্নলিখিত তথ্য সংগ্রহ করে:
- চলমান কার্নেল ভার্সন
- লোড করা মডিউল
- সিস্টেম ও পরিষেবা কনফিগারেশন ফাইল
Sosreport আরও তথ্য সংগ্রহ করার জন্য এক্সটার্নাল প্রোগ্রামও চালায়, যার মধ্যে এগুলি অন্তর্ভুক্ত:
- সব কম্পোনেন্ট থেকে Apigee লগ।
- রানটাইম ডায়াগনস্টিকস
- nodetool কমান্ড ব্যবহার করে Cassandra ডায়াগনস্টিকস সংগ্রহ করা হয়।
Sosreport টুলে দুটি প্রধান কমান্ড আছে:
sosreport: ডেটা সংগ্রহ করা এবং রিপোর্ট তৈরি করার জন্য প্রাথমিক কমান্ড।apigee-sosreport: Apigee কম্পোনেন্টের জন্য নির্দিষ্ট প্লাগ-ইন ইনস্টলsosreportও ম্যানেজsosreportকরতে ব্যবহৃত একটি সহায়ক টুল।
ইনস্টল করা
নিচের সারণীতে Private Cloud-এর জন্য Edge-এর সমর্থিত সংস্করণে Sosreport টুলের উপলভ্যতা এবং ইনস্টলেশন পদ্ধতির বিবরণ দেওয়া হয়েছে।
| OPDK ভার্সন | নতুন করে ইনস্টল করা | ইন-প্লেস আপগ্রেড |
|---|---|---|
| 4.50.00.11 - 4.52.01.00 | ম্যানুয়ালি ইনস্টল করতে হবে | ম্যানুয়ালি ইনস্টল করতে হবে |
| 4.52.01.01+ | ডিফল্ট হিসেবে ইনস্টল করা | ম্যানুয়ালি আপগ্রেড করতে হবে |
| Amazon Linux 2023+ | কাজ করে না | কাজ করে না |
Edge for Private Cloud 4.52.01.01 এবং তার পরবর্তী ভার্সন নতুন করে ইনস্টল করার সময় Sosreport টুল ডিফল্ট হিসেবে সব নোডে ইনস্টল হয়ে যায়।
আপনি যদি Private Cloud 4.52.01.01 বা তার পরবর্তী ভার্সনের জন্য Edge-এ ইন-প্লেস আপগ্রেড করেন, তাহলে Sosreport টুল আপডেট করতে প্রতিটি নোডে নিম্নলিখিত কমান্ডটি চালান:
/opt/apigee/apigee-service/bin/apigee-service apigee-sosreport update
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 থেকে উপযুক্ত Python
site-packages ডিরেক্টরিতে Apigee-নির্দিষ্ট প্লাগ-ইন কপি করুন।
যেমন, apigee-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 সহায়তা টিমের সাথে যোগাযোগ করুন।
4.50.00.11 থেকে 4.52.01.00 পর্যন্ত ভার্সনের জন্য কীভাবে `sosreport` ইনস্টল করতে হয় তা নিম্নলিখিত বিভাগে ব্যাখ্যা করা হয়েছে।
sosreport-এর Apigee ভার্সন ইনস্টল করা হচ্ছে
আপনার সিস্টেমে আগে থেকে sosreport-এর SoS ভার্সন
ইনস্টল করা না থাকলে, আপনি Apigee-এর ভার্সন ইনস্টল করতে পারবেন। এর জন্য, যেসব নোডে Edge for Private Cloud ইনস্টল করা আছে,
সেগুলিতে নিম্নলিখিত কমান্ডগুলি লিখুন:
/opt/apigee/apigee-service/bin/apigee-service apigee-sosreport install
/opt/apigee/apigee-service/bin/apigee-service apigee-sosreport setupsosreport ইনস্টল করা আছে কিনা তা পরীক্ষা করতে, 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 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→
রিপোর্ট তৈরি করা
প্রাইভেট ক্লাউড ভার্সন 4.52.01.01 এবং তার পরবর্তী ভার্সনের জন্য Edge
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
আপনি যে ডিরেক্টরি নির্দিষ্ট করেছেন, সেই ডিরেক্টরিতে রিপোর্টটি .tar.xz ফাইল হিসেবে সেভ করা হয়।
tmp-dir বিকল্প ব্যবহার করে এটি করা হয়।
STDOUT-এ .tar.xz ফাইলের লোকেশন ও চেকসাম দেখানো হয়েছে। যেমন:
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 বিকল্প ব্যবহার করতে হয়।
STDOUT-এ .tar.xz file-এর লোকেশন দেখানো হয়, সেই সাথে
চেকসামও দেখানো হয়। যেমন:
sosreport-এর জন্য আরও উপলভ্য বিকল্প জানতে, man ফাইলটি পড়ুন:
sudo man sosreport
Apigee প্লাগ-ইন
নিচের বিভাগে, নিম্নলিখিত কম্পোনেন্টগুলির জন্য Sosreport টুলে Apigee প্লাগ-ইন সম্পর্কে বর্ণনা করা হয়েছে:
ম্যানেজমেন্ট সার্ভার
apigee-mgmt প্লাগ-ইন ম্যানেজমেন্ট সার্ভার থেকে নিম্নলিখিত তথ্য সংগ্রহ করে:
- সার্ভার হোস্টনেম (ডিফল্ট)
- cpuinfo (ডিফল্ট)
- meminfo (ডিফল্ট)
- Java ভার্চুয়াল মেশিন (JVM) সেটিংস, যেমন মেমরি,
Djdk.tls.allowUnsafeServerCertChange, ইত্যাদি (ডিফল্ট) - বর্তমান ম্যানেজমেন্ট লগ (ডিফল্ট)
- দশটি সিকোয়েন্সিয়াল top ও jstacks আউটপুট (ডিফল্ট)
- সম্পূর্ণ ম্যানেজমেন্ট লগ ফোল্ডার (ঐচ্ছিক)
- কনফিগ-ফাইল (ঐচ্ছিক)
উদাহরণ:
সব ডিফল্ট আইটেম সংগ্রহ করতে, নিম্নলিখিতগুলির মধ্যে একটি লিখুন:
- 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) থেকে নিম্নলিখিত তথ্য সংগ্রহ করে:
- সার্ভার হোস্টনেম (ডিফল্ট)
- cpuinfo (ডিফল্ট)
- meminfo (ডিফল্ট)
- buildinfo/রিলিজ সংক্রান্ত তথ্য (ডিফল্ট)
- apigee-all স্ট্যাটাস (ডিফল্ট)
- সার্ভারের বিবরণ (ডিফল্ট)
- JVM লেভেল সেটিংস, যেমন, মেমরি,
Djdk.tls.allowUnsafeServerCertChange, ইত্যাদি (ডিফল্ট) - বর্তমান MP লগ (ডিফল্ট)
- ধারাবাহিক ১০টি সেরা, jstacks ও NIO মেট্রিক্স আউটপুট (ডিফল্ট)
- সম্পূর্ণ MP লগ ফোল্ডার (ঐচ্ছিক)
- শ্রেণিবিভাগ ট্রি (ঐচ্ছিক)
- হিপ ডাম্প (ঐচ্ছিক)
- কনফিগ-ফাইল (ঐচ্ছিক)
- রানটাইম ট্রেস (ঐচ্ছিক এবং শুধুমাত্র
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 প্লাগ-ইন রাউটার থেকে নিম্নলিখিত তথ্য সংগ্রহ করে:
- সার্ভার হোস্টনেম (ডিফল্ট)
- cpuinfo (ডিফল্ট)
- meminfo (ডিফল্ট)
- buildinfo/রিলিজ সংক্রান্ত তথ্য (ডিফল্ট)
- 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
Cassandra
apigee-cassandra প্লাগ-ইন 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