گزارش‌ها و ابزارهای تشخیص خرابی

درحال مشاهده اسناد Apigee Edge هستید.
به اسناد Apigee X بروید.
اطلاعات

این موضوع درباره ابزارهای شبکه، ابزارهای ماشین مجازی جاوا (JVM)، و گزارش‌های تشخیص خرابی است که می‌توانید برای عیب‌یابی مشکلات مربوط به شبکه و JVM در Apigee Edge استفاده کنید.

برنامه کمکی بویشگر بسته TCP/IP (‏tcpdump)

ابزار tcpdump ابزار استراق سمع بسته خط فرمان است که به شما امکان می‌دهد بسته‌های TCP/IP را که ازطریق شبکه دریافت یا منتقل می‌شوند ضبط یا فیلتر کنید. این ابزار در سیستم‌عامل‌های مبتنی بر Linux/Unix دردسترس است. می‌توانید این ابزار را بااستفاده از yum به‌صورت زیر نصب کنید:

yum install tcpdump

ابزار tcpdump برای عیب‌یابی مشکلات مربوط به شبکه یا SSL مفید است. برای مثال:

  • خطاهای «۵۰۲ دروازه نادرست» (به‌دلیل استثنای EOF ایجاد شده است)
  • خطاهای ۵۰۳ سرویس دردسترس نیست
  • دست‌دهی SSL ناموفق

برای عیب‌یابی هریک از این مشکلات، ابتدا باید جفت مؤلفه‌هایی را که خطا بین آن‌ها رخ داده است مشخص کنید. در مورد Edge، می‌تواند یکی از جفت‌های زیر باشد:

  • برنامه کارخواه و «مسیریاب»
  • پردازشگر پیام و رهیاب
  • پردازشگر پیام و سرور زیرینه

پس‌از شناسایی جفت مؤلفه مشکل‌ساز، می‌توانید بسته‌های شبکه را بااستفاده از tcpdump در یک یا هر دو مؤلفه ضبط کنید.

ضبط بسته‌های ارسال‌شده به/دریافت‌شده از یک میزبان خاص بااستفاده از tcpdump

از دستور tcpdump زیر برای ضبط همه بسته‌های ارسالی به یا دریافتی از میزبان مشخص (نشانی IP) استفاده کنید و اطلاعات را در فایل مشخص‌شده ذخیره کنید:

tcpdump -i any -s 0 host <IP address> -w <File name>

مکان:

پارامتر شرح
-i (واسط) واسطی را مشخص می‌کند که بسته‌ها باید از آن ضبط شوند. استفاده از مقدار «any» اجازه می‌دهد بسته‌ها از همه میان‌ها ضبط شوند.
-s ‫(snarf/snaplen) مقدار هر بسته را برای ضبط مشخص می‌کند. استفاده از مقدار ۰ (صفر) به شما امکان می‌دهد کل بسته را ضبط کنید.
نشانی IP نشانی IP میزبان است که می‌خواهیم بسته‌ها را برای آن ضبط کنیم
نام فایل نام فایلی است که tcpdump باید در آن نوشته شود

مثال

فرض کنیم می‌خواهید بسته‌های بین «پردازنده پیام» و «سرور پشتیبان» را ضبط کنید: سرور:

  1. به سیستم ماشین «پردازشگر پیام» وارد شوید.
  2. نشانی IP «سرور پشتیبان» (فرض کنید 22.22.22.22 باشد) را که می‌خواهیم بسته‌ها را برای آن ضبط کنیم تعیین کنید.

از فرمان زیر برای ضبط بسته‌های شبکه برای میزبان با نشانی IP خاص استفاده کنید: address:

tcpdump -i any -s 0 host 22.22.22.22 -w rmp-123.pcap

اگر سرور زیرینه به چندین نشانی IP تبدیل می‌شود، از نام میزبان سرور زیرینه در فرمان tcpdump به‌صورت زیر استفاده کنید:

tcpdump -i any -s 0 host <Hostname> -w rmp-123.pcap

اگر چندین سرور زیرینه با نشانی‌های IP مختلف وجود دارد (22.22.22.22،‏ 33.33.33.33 و 44.44.44.44)، از دستور tcpdump زیر استفاده کنید:

tcpdump -i any -s 0 host 22.22.22.22 or host 33.33.33.33 or host 44.44.44.44 -w rmp-123.pcap

درحال تجزیه‌وتحلیل tcpdump

می‌توانید tcpdump را بااستفاده از فرمان tcpdump یا ابزار مبتنی بر GUI Wireshark مشاهده یا تجزیه‌وتحلیل کنید.

مرجع‌ها

رونوشت‌های پشته

رونوشت‌های پشته تصویری فوری از حافظه فرایند جاوا است. این فایل‌ها حاوی اطلاعاتی درباره کلاس‌ها و اشیای Java در پشته در لحظه جمع‌آوری پشته‌دُمپ هستند. معمولاً اندازه آن‌ها بسیار بزرگ است و از چند صد مگابایت تا چند گیگابایت متغیر است.

رونوشت پشته زمانی بسیار مفید است که پردازش Java مانند «پردازشگر پیام» موارد زیر را نشان دهد:

  • استفاده زیاد از حافظه
  • OutofMemoryError

درحال تولید کردن «رونوشت پشته» برای پردازش جاوا

جاوا ابزاری به نام jmap ارائه می‌دهد که به شما امکان می‌دهد آمار حافظه یا رونوشت‌های پشته فرایند درحال اجرای جاوا را تولید کنید.

از فرمان jmap زیر برای تولید کردن انباشت پشته فرایند جاوا استفاده کنید:

sudo -u apigee <JAVA_HOME>/bin/jmap -dump:live,format=b,file=<filename> <pid>

مکان:

پارامتر شرح
JAVA_HOME دایرکتوری نصب جاوا است
filename نام فایلی است که رونوشت پشته در آن نوشته خواهد شد
pid شناسه فرایند برنامه Java که باید سرریز آن ضبط شود

مثال

فرض کنیم «پردازنده پیام» mp-east استفاده بالایی از حافظه دارد یا «خطاهای حافظه ناکافی» ایجاد می‌کند. شناسه فرایند «پردازشگر پیام» را بااستفاده از فرمان ps در سیستم‌عامل یونیکس تعیین کنید. فرض کنیم ۲۴۵۶۹ است.

برای تولید کردن تخلیه پشته، ابزار jmap را به‌صورت زیر اجرا کنید:

sudo -u apigee <JAVA_HOME>/bin/jmap -dump:live,format=b,file=mp-east-heapdump.bin 24569

درحال تجزیه‌وتحلیل رونوشت‌های پشته

«داده‌گردان‌های پشته» را می‌توان بااستفاده از Eclipse MAT (ابزار تجزیه‌وتحلیل حافظه) تجزیه‌وتحلیل کرد تا نشت‌های احتمالی حافظه یا اشیای Java که منجر به استفاده زیاد از حافظه می‌شوند مشخص شوند.

مرجع‌ها

نحوه جمع‌آوری تخلیه پشته

ابزار jmap

صفحه راهنمای jmap

Memory Analyzer Tool (MAT)


خلاصه رشته‌ها

خلاصه رشته‌ها عکس آنی از وضعیت همه رشته‌های فرایند Java درحال اجرا است. وضعیت هر رشته با محتوای پشته آن ارائه می‌شود که به آن ردیابی پشته می‌گویند. برخی‌از رشته‌ها بخشی از برنامه Java درحال اجرا خواهند بود، درحالی‌که برخی دیگر رشته‌های داخلی JVM خواهند بود.

خلاصه رشته اطلاعاتی درباره فعالیت‌های هریک از رشته‌های برنامه نشان می‌دهد. این اطلاعات می‌تواند برای موارد زیر بسیار مفید باشد:

  • عیب‌یابی کردن مشکلات، مثل جهش‌های CPU، زمان‌های پاسخ کند، یا برنامه‌های Java که پاسخ نمی‌دهند
  • بهینه‌سازی عملکرد برنامه و ماشین مجازی جاوا (JVM)

درحال تولید کردن تخلیه رشته

خلاصه رشته برای فرایند Java را می‌توان بااستفاده از ابزار jstack همان‌طور که در زیر نشان داده شده است تولید کرد:

sudo -u apigee <JAVA_HOME>/bin/jstack -l <pid> > <filename>

مکان:

پارامتر شرح
JAVA_HOME دایرکتوری نصب Java است.
pid شناسه فرایند برنامه Java است که می‌خواهید انباشت رشته آن را ضبط کنید.
filename نام فایلی است که تخلیه رشته در آن نوشته خواهد شد.

مثال

برای تولید کردن تخلیه پشته برای شناسه فرایند ۳۷۳۲۰ در «پردازشگر پیام» mp-east، از دستور زیر استفاده کنید:

sudo -u apigee <JAVA_HOME>/bin/jstack -l 37320 > /opt/apigee/edge-message-processor/mp-east-threadDump.txt

طبق مثال بالا، تخلیه رشته‌ای فرایند در فایل /opt/apigee/edge-message-processor/mp-east-threadDump.txt ذخیره می‌شود.

درحال تجزیه‌وتحلیل کردن تخلیه‌های Thread

می‌توانید تخلیه پشته را در هر ویرایشگر نوشتاری مثل vi (لینوکس)، notepad (ویندوز) مشاهده کنید. برای جزئیات مربوط به بخش‌های مختلف «خلاصه رشته» و نحوه تفسیر اطلاعات، به خلاصه رشته مراجعه کنید.

مرجع‌ها