.\" Automatically generated by Pandoc 3.10.2 .\" .TH "JSTAT" "1" "2026" "JDK 25.0.4.1" "JDK Commands" .SH "نام (NAME)" jstat \- ابزار مانیتورینگ آمار عملکرد و جمع‌آوری زباله در ماشین مجازی جاوا (JVM) (نسخه ۲۵) .SH "خلاصه دستور (SYNOPSIS)" \f[B]توجه:\f[R] این دستور آزمایشی است و پشتیبانی رسمی ندارد. .PP \f[CR]jstat\f[R] \f[I]generalOptions\f[R] .PP \f[CR]jstat\f[R] \f[I]outputOptions\f[R] [\f[CR]\-t\f[R]] [\f[CR]\-h\f[R] \f[I]lines\f[R]] \f[I]vmid\f[R] [\f[I]interval\f[R] [\f[I]count\f[R]]] .TP \f[I]generalOptions\f[R] یک گزینه عمومی خط فرمان. بخش \f[B]گزینه‌های عمومی (GENERAL OPTIONS)\f[R] را ببینید. .TP \f[I]outputOptions\f[R] گزینه‌ای که توسط گزینه \f[CR]\-options\f[R] گزارش می‌شود. یک یا چند گزینه خروجی شامل یک \f[CR]statOption\f[R] منفرد، به همراه هر یک از گزینه‌های \f[CR]\-t\f[R]، \f[CR]\-h\f[R] و \f[CR]\-J\f[R]. بخش \f[B]گزینه‌های خروجی دستور JSTAT\f[R] را ببینید. .TP \f[CR]\-t\f[R] یک ستون برچسب زمانی (Timestamp) را به عنوان اولین ستون خروجی نمایش می‌دهد. برچسب زمانی، زمان سپری‌شده از زمان شروع JVM هدف است. .TP \f[CR]\-h\f[R] \f[I]n\f[R] عنوان ستون‌ها (سرستون) را پس از هر \f[I]n\f[R] نمونه (سطرهای خروجی) نمایش می‌دهد، که در آن \f[I]n\f[R] یک عدد صحیح مثبت است. مقدار پیش‌فرض \f[CR]0\f[R] است که عنوان ستون‌ها را فقط برای اولین سطر داده‌ها نمایش می‌دهد. .TP \f[I]vmid\f[R] شناسه ماشین مجازی؛ رشته‌ای که JVM هدف را مشخص می‌کند. بخش \f[B]شناسه ماشین مجازی (VIRTUAL MACHINE IDENTIFIER)\f[R] را ببینید. .TP \f[I]interval\f[R] بازه زمانی نمونه‌برداری بر حسب واحدهای مشخص‌شده، ثانیه (s) یا میلی‌ثانیه (ms). واحد پیش‌فرض میلی‌ثانیه است. این مقدار باید یک عدد صحیح مثبت باشد. در صورت تعیین، دستور \f[CR]jstat\f[R] خروجی خود را در هر بازه زمانی تولید می‌کند. .TP \f[I]count\f[R] تعداد نمونه‌های نمایشی. مقدار پیش‌فرض بی‌نهایت است که باعث می‌شود دستور \f[CR]jstat\f[R] آمار را تا زمانی که JVM هدف خاتمه یابد یا دستور \f[CR]jstat\f[R] متوقف شود، نمایش دهد. این مقدار باید یک عدد صحیح مثبت باشد. .SH "توضیحات (DESCRIPTION)" دستور \f[CR]jstat\f[R] آمار عملکرد را برای یک Java HotSpot VM ابزاربندی‌شده نمایش می‌دهد. JVM هدف توسط شناسه ماشین مجازی آن یا گزینه \f[CR]vmid\f[R] مشخص می‌شود. .PP دستور \f[CR]jstat\f[R] از دو نوع گزینه پشتیبانی می‌کند: گزینه‌های عمومی و گزینه‌های خروجی. گزینه‌های عمومی باعث می‌شوند دستور \f[CR]jstat\f[R] اطلاعات ساده راهنما و نسخه را نمایش دهد. گزینه‌های خروجی، محتوا و قالب خروجی آماری را تعیین می‌کنند. .PP تمامی گزینه‌ها و عملکردهای آن‌ها ممکن است در نسخه‌های آینده تغییر کنند یا حذف شوند. .SH "گزینه‌های عمومی (GENERAL OPTIONS)" اگر یکی از گزینه‌های عمومی را مشخص کنید، نمی‌توانید هیچ گزینه یا پارامتر دیگری را تعیین کنید. .TP \f[CR]\-help\f[R] پیام راهنما را نمایش می‌دهد. .TP \f[CR]\-options\f[R] فهرستی از گزینه‌های آماری را نمایش می‌دهد. بخش \f[B]گزینه‌های خروجی دستور JSTAT\f[R] را ببینید. .SH "گزینه‌های خروجی دستور JSTAT (OUTPUT OPTIONS FOR THE JSTAT COMMAND)" اگر گزینه عمومی مشخص نکنید، می‌توانید گزینه‌های خروجی را تعیین کنید. گزینه‌های خروجی محتوا و قالب خروجی دستور \f[CR]jstat\f[R] را تعیین می‌کنند و شامل یک \f[CR]statOption\f[R] منفرد، به همراه هر یک از گزینه‌های خروجی دیگر (\f[CR]\-h\f[R]، \f[CR]\-t\f[R] و \f[CR]\-J\f[R]) هستند. گزینه \f[CR]statOption\f[R] باید در ابتدا بیاید. .PP خروجی به صورت جدول قالب‌بندی می‌شود که ستون‌های آن با فاصله از هم جدا شده‌اند. یک سطر سرستون با عنوان‌ها، ستون‌ها را توصیف می‌کند. از گزینه \f[CR]\-h\f[R] برای تنظیم تناوب نمایش سرستون استفاده کنید. نام سرستون‌ها در بین گزینه‌های مختلف یکدست است. به طور کلی، اگر دو گزینه ستونی با یک نام ارائه دهند، منبع داده هر دو ستون یکسان است. .PP از گزینه \f[CR]\-t\f[R] برای نمایش ستون برچسب زمانی با عنوان Timestamp به عنوان اولین ستون خروجی استفاده کنید. ستون Timestamp شامل زمان سپری‌شده به ثانیه از زمان شروع JVM هدف است. دقت برچسب زمانی به عوامل مختلفی بستگی دارد و ممکن است به دلیل تاخیر در زمان‌بندی رشته‌ها (threads) در سیستم‌های زیر بار سنگین، متغیر باشد. .PP از پارامترهای interval و count برای تعیین به ترتیب تناوب و تعداد دفعات نمایش خروجی توسط دستور \f[CR]jstat\f[R] استفاده کنید. .PP \f[B]توجه:\f[R] .PP برای پردازش و استخراج خروجی دستور \f[CR]jstat\f[R] اسکریپت ننویسید زیرا ممکن است قالب آن در نسخه‌های بعدی تغییر کند. اگر اسکریپت‌هایی می‌نویسید که خروجی دستور \f[CR]jstat\f[R] را پردازش می‌کنند، انتظار داشته باشید که برای نسخه‌های آینده این ابزار نیاز به اصلاح آن‌ها داشته باشید. .TP \f[CR]\-statOption\f[R] اطلاعات آماری نمایشی توسط دستور \f[CR]jstat\f[R] را تعیین می‌کند. موارد زیر گزینه‌های موجود را فهرست می‌کنند. از گزینه عمومی \f[CR]\-options\f[R] برای نمایش فهرست گزینه‌ها در یک نصب خاص از پلتفرم استفاده کنید. بخش \f[B]گزینه‌های آماری و خروجی (STAT OPTIONS AND OUTPUT)\f[R] را ببینید. .RS \f[CR]class\f[R]: آمار مربوط به رفتار بارگذار کلاس (Class Loader) را نمایش می‌دهد. .PP \f[CR]compiler\f[R]: آمار مربوط به رفتار کامپایلر درجا (JIT) در Java HotSpot VM را نمایش می‌دهد. .PP \f[CR]gc\f[R]: آمار مربوط به رفتار حافظه هیپ جمع‌آوری زباله را نمایش می‌دهد. .PP \f[CR]gccapacity\f[R]: آمار مربوط به ظرفیت نسل‌ها و فضاهای مربوط به آن‌ها را نمایش می‌دهد. .PP \f[CR]gccause\f[R]: خلاصه‌ای از آمار جمع‌آوری زباله (مشابه \f[CR]\-gcutil\f[R]) را همراه با علت آخرین و فعلی (در صورت وجود) رخدادهای جمع‌آوری زباله نمایش می‌دهد. .PP \f[CR]gcnew\f[R]: آمار مربوط به رفتار نسل جدید (Young Generation) را نمایش می‌دهد. .PP \f[CR]gcnewcapacity\f[R]: آمار مربوط به اندازه نسل‌های جدید و فضاهای مربوط به آن‌ها را نمایش می‌دهد. .PP \f[CR]gcold\f[R]: آمار مربوط به رفتار نسل قدیم (Old Generation) و آمار متاسپیس (Metaspace) را نمایش می‌دهد. .PP \f[CR]gcoldcapacity\f[R]: آمار مربوط به اندازه نسل قدیم را نمایش می‌دهد. .PP \f[CR]gcmetacapacity\f[R]: آمار مربوط به اندازه متاسپیس را نمایش می‌دهد. .PP \f[CR]gcutil\f[R]: خلاصه‌ای از آمار جمع‌آوری زباله را نمایش می‌دهد. .PP \f[CR]printcompilation\f[R]: آمار متدهای کامپایل‌شده Java HotSpot VM را نمایش می‌دهد. .RE .TP \f[CR]\-J\f[R]\f[I]javaOption\f[R] گزینه \f[I]javaOption\f[R] را به راه‌انداز برنامه جاوا ارسال می‌کند. به عنوان مثال، \f[CR]\-J\-Xms48m\f[R] حافظه شروع را روی ۴۸ مگابایت تنظیم می‌کند. برای فهرست کامل گزینه‌ها، \f[B]java\f[R] را ببینید. .SH "گزینه‌های آماری و خروجی (STAT OPTIONS AND OUTPUT)" اطلاعات زیر ستون‌هایی را خلاصه می‌کند که دستور \f[CR]jstat\f[R] برای هر \f[I]statOption\f[R] در خروجی نمایش می‌دهد. .TP گزینه \f[CR]\-class\f[R] آمار بارگذار کلاس (Class Loader). .RS \f[CR]Loaded\f[R]: تعداد کلاس‌های بارگذاری‌شده. .PP \f[CR]Bytes\f[R]: تعداد کیلوبایت‌های بارگذاری‌شده. .PP \f[CR]Unloaded\f[R]: تعداد کلاس‌های تخلیه‌شده از حافظه. .PP \f[CR]Bytes\f[R]: تعداد کیلوبایت‌های تخلیه‌شده. .PP \f[CR]Time\f[R]: زمان صرف‌شده برای انجام عملیات بارگذاری و تخلیه کلاس‌ها. .RE .TP گزینه \f[CR]\-compiler\f[R] آمار کامپایلر درجا (JIT) در Java HotSpot VM. .RS \f[CR]Compiled\f[R]: تعداد وظایف کامپایل انجام‌شده. .PP \f[CR]Failed\f[R]: تعداد وظایف کامپایل شکست‌خورده. .PP \f[CR]Invalid\f[R]: تعداد وظایف کامپایل باطل‌شده. .PP \f[CR]Time\f[R]: زمان صرف‌شده برای انجام وظایف کامپایل. .PP \f[CR]FailedType\f[R]: نوع کامپایل آخرین کامپایل شکست‌خورده. .PP \f[CR]FailedMethod\f[R]: نام کلاس و متد آخرین کامپایل شکست‌خورده. .RE .TP گزینه \f[CR]\-gc\f[R] آمار حافظه هیپ جمع‌آوری زباله. .RS \f[CR]S0C\f[R]: ظرفیت فعلی فضای بازمانده ۰ (Survivor space 0) بر حسب کیلوبایت. .PP \f[CR]S1C\f[R]: ظرفیت فعلی فضای بازمانده ۱ (Survivor space 1) بر حسب کیلوبایت. .PP \f[CR]S0U\f[R]: میزان مصرف فضای بازمانده ۰ بر حسب کیلوبایت. .PP \f[CR]S1U\f[R]: میزان مصرف فضای بازمانده ۱ بر حسب کیلوبایت. .PP \f[CR]EC\f[R]: ظرفیت فعلی فضای ایدن (Eden space) بر حسب کیلوبایت. .PP \f[CR]EU\f[R]: میزان مصرف فضای ایدن بر حسب کیلوبایت. .PP \f[CR]OC\f[R]: ظرفیت فعلی فضای قدیم (Old space) بر حسب کیلوبایت. .PP \f[CR]OU\f[R]: میزان مصرف فضای قدیم بر حسب کیلوبایت. .PP \f[CR]MC\f[R]: اندازه تعهدشده متاسپیس (Metaspace Committed Size) بر حسب کیلوبایت. .PP \f[CR]MU\f[R]: میزان مصرف متاسپیس بر حسب کیلوبایت. .PP \f[CR]CCSC\f[R]: اندازه تعهدشده فضای کلاس فشرده (Compressed class committed size) بر حسب کیلوبایت. .PP \f[CR]CCSU\f[R]: فضای استفاده‌شده کلاس فشرده بر حسب کیلوبایت. .PP \f[CR]YGC\f[R]: تعداد رخدادهای جمع‌آوری زباله نسل جدید (Young Generation GC). .PP \f[CR]YGCT\f[R]: زمان صرف‌شده برای جمع‌آوری زباله نسل جدید. .PP \f[CR]FGC\f[R]: تعداد رخدادهای جمع‌آوری زباله کامل (Full GC). .PP \f[CR]FGCT\f[R]: زمان صرف‌شده برای جمع‌آوری زباله کامل. .PP \f[CR]GCT\f[R]: مجموع کل زمان جمع‌آوری زباله. .RE .TP گزینه \f[CR]\-gccapacity\f[R] ظرفیت‌های نسل‌ها و فضاهای استخر حافظه. .RS \f[CR]NGCMN\f[R]: حداقل ظرفیت نسل جدید (کیلوبایت). .PP \f[CR]NGCMX\f[R]: حداکثر ظرفیت نسل جدید (کیلوبایت). .PP \f[CR]NGC\f[R]: ظرفیت فعلی نسل جدید (کیلوبایت). .PP \f[CR]S0C\f[R]: ظرفیت فعلی فضای بازمانده ۰ (کیلوبایت). .PP \f[CR]S1C\f[R]: ظرفیت فعلی فضای بازمانده ۱ (کیلوبایت). .PP \f[CR]EC\f[R]: ظرفیت فعلی فضای ایدن (کیلوبایت). .PP \f[CR]OGCMN\f[R]: حداقل ظرفیت نسل قدیم (کیلوبایت). .PP \f[CR]OGCMX\f[R]: حداکثر ظرفیت نسل قدیم (کیلوبایت). .PP \f[CR]OGC\f[R]: ظرفیت فعلی نسل قدیم (کیلوبایت). .PP \f[CR]OC\f[R]: ظرفیت فعلی فضای قدیم (کیلوبایت). .PP \f[CR]MCMN\f[R]: حداقل ظرفیت متاسپیس (کیلوبایت). .PP \f[CR]MCMX\f[R]: حداکثر ظرفیت متاسپیس (کیلوبایت). .PP \f[CR]MC\f[R]: اندازه تعهدشده متاسپیس (کیلوبایت). .PP \f[CR]CCSMN\f[R]: حداقل ظرفیت فضای کلاس فشرده (کیلوبایت). .PP \f[CR]CCSMX\f[R]: حداکثر ظرفیت فضای کلاس فشرده (کیلوبایت). .PP \f[CR]CCSC\f[R]: اندازه تعهدشده فضای کلاس فشرده (کیلوبایت). .PP \f[CR]YGC\f[R]: تعداد رخدادهای GC نسل جدید. .PP \f[CR]FGC\f[R]: تعداد رخدادهای GC کامل. .RE .TP گزینه \f[CR]\-gccause\f[R] این گزینه همان خلاصه آمار جمع‌آوری زباله گزینه \f[CR]\-gcutil\f[R] را نمایش می‌دهد، اما شامل علل آخرین رخداد جمع‌آوری زباله و (در صورت وجود) رخداد جاری جمع‌آوری زباله نیز می‌شود. علاوه بر ستون‌های فهرست‌شده برای \f[CR]\-gcutil\f[R]، این گزینه ستون‌های زیر را اضافه می‌کند: .RS \f[CR]LGCC\f[R]: علت آخرین جمع‌آوری زباله .PP \f[CR]GCC\f[R]: علت جمع‌آوری زباله جاری .RE .TP گزینه \f[CR]\-gcnew\f[R] آمار نسل جدید. .RS \f[CR]S0C\f[R]: ظرفیت فعلی فضای بازمانده ۰ (کیلوبایت). .PP \f[CR]S1C\f[R]: ظرفیت فعلی فضای بازمانده ۱ (کیلوبایت). .PP \f[CR]S0U\f[R]: میزان مصرف فضای بازمانده ۰ (کیلوبایت). .PP \f[CR]S1U\f[R]: میزان مصرف فضای بازمانده ۱ (کیلوبایت). .PP \f[CR]TT\f[R]: آستانه ماندگاری (Tenuring threshold). .PP \f[CR]MTT\f[R]: حداکثر آستانه ماندگاری. .PP \f[CR]DSS\f[R]: اندازه مطلوب بازماندگان (کیلوبایت). .PP \f[CR]EC\f[R]: ظرفیت فعلی فضای ایدن (کیلوبایت). .PP \f[CR]EU\f[R]: میزان مصرف فضای ایدن (کیلوبایت). .PP \f[CR]YGC\f[R]: تعداد رخدادهای GC نسل جدید. .PP \f[CR]YGCT\f[R]: زمان جمع‌آوری زباله نسل جدید. .RE .TP گزینه \f[CR]\-gcnewcapacity\f[R] آمار اندازه فضای نسل جدید. .RS \f[CR]NGCMN\f[R]: حداقل ظرفیت نسل جدید (کیلوبایت). .PP \f[CR]NGCMX\f[R]: حداکثر ظرفیت نسل جدید (کیلوبایت). .PP \f[CR]NGC\f[R]: ظرفیت فعلی نسل جدید (کیلوبایت). .PP \f[CR]S0CMX\f[R]: حداکثر ظرفیت فضای بازمانده ۰ (کیلوبایت). .PP \f[CR]S0C\f[R]: ظرفیت فعلی فضای بازمانده ۰ (کیلوبایت). .PP \f[CR]S1CMX\f[R]: حداکثر ظرفیت فضای بازمانده ۱ (کیلوبایت). .PP \f[CR]S1C\f[R]: ظرفیت فعلی فضای بازمانده ۱ (کیلوبایت). .PP \f[CR]ECMX\f[R]: حداکثر ظرفیت فضای ایدن (کیلوبایت). .PP \f[CR]EC\f[R]: ظرفیت فعلی فضای ایدن (کیلوبایت). .PP \f[CR]YGC\f[R]: تعداد رخدادهای GC نسل جدید. .PP \f[CR]FGC\f[R]: تعداد رخدادهای GC کامل. .RE .TP گزینه \f[CR]\-gcold\f[R] آمار اندازه نسل قدیم. .RS \f[CR]MC\f[R]: اندازه تعهدشده متاسپیس (کیلوبایت). .PP \f[CR]MU\f[R]: میزان مصرف متاسپیس (کیلوبایت). .PP \f[CR]CCSC\f[R]: اندازه تعهدشده فضای کلاس فشرده (کیلوبایت). .PP \f[CR]CCSU\f[R]: فضای استفاده‌شده کلاس فشرده (کیلوبایت). .PP \f[CR]OC\f[R]: ظرفیت فعلی فضای قدیم (کیلوبایت). .PP \f[CR]OU\f[R]: میزان مصرف فضای قدیم (کیلوبایت). .PP \f[CR]YGC\f[R]: تعداد رخدادهای GC نسل جدید. .PP \f[CR]FGC\f[R]: تعداد رخدادهای GC کامل. .PP \f[CR]FGCT\f[R]: زمان جمع‌آوری زباله کامل. .PP \f[CR]GCT\f[R]: مجموع کل زمان جمع‌آوری زباله. .RE .TP گزینه \f[CR]\-gcoldcapacity\f[R] آمار نسل قدیم. .RS \f[CR]OGCMN\f[R]: حداقل ظرفیت نسل قدیم (کیلوبایت). .PP \f[CR]OGCMX\f[R]: حداکثر ظرفیت نسل قدیم (کیلوبایت). .PP \f[CR]OGC\f[R]: ظرفیت فعلی نسل قدیم (کیلوبایت). .PP \f[CR]OC\f[R]: ظرفیت فعلی فضای قدیم (کیلوبایت). .PP \f[CR]YGC\f[R]: تعداد رخدادهای GC نسل جدید. .PP \f[CR]FGC\f[R]: تعداد رخدادهای GC کامل. .PP \f[CR]FGCT\f[R]: زمان جمع‌آوری زباله کامل. .PP \f[CR]GCT\f[R]: مجموع کل زمان جمع‌آوری زباله. .RE .TP گزینه \f[CR]\-gcmetacapacity\f[R] آمار اندازه متاسپیس. .RS \f[CR]MCMN\f[R]: حداقل ظرفیت متاسپیس (کیلوبایت). .PP \f[CR]MCMX\f[R]: حداکثر ظرفیت متاسپیس (کیلوبایت). .PP \f[CR]MC\f[R]: اندازه تعهدشده متاسپیس (کیلوبایت). .PP \f[CR]CCSMN\f[R]: حداقل ظرفیت فضای کلاس فشرده (کیلوبایت). .PP \f[CR]CCSMX\f[R]: حداکثر ظرفیت فضای کلاس فشرده (کیلوبایت). .PP \f[CR]YGC\f[R]: تعداد رخدادهای GC نسل جدید. .PP \f[CR]FGC\f[R]: تعداد رخدادهای GC کامل. .PP \f[CR]FGCT\f[R]: زمان جمع‌آوری زباله کامل. .PP \f[CR]GCT\f[R]: مجموع کل زمان جمع‌آوری زباله. .RE .TP گزینه \f[CR]\-gcutil\f[R] خلاصه آمار جمع‌آوری زباله. .RS \f[CR]S0\f[R]: درصد مصرف فضای بازمانده ۰ نسبت به ظرفیت فعلی فضا. .PP \f[CR]S1\f[R]: درصد مصرف فضای بازمانده ۱ نسبت به ظرفیت فعلی فضا. .PP \f[CR]E\f[R]: درصد مصرف فضای ایدن نسبت به ظرفیت فعلی فضا. .PP \f[CR]O\f[R]: درصد مصرف فضای قدیم نسبت به ظرفیت فعلی فضا. .PP \f[CR]M\f[R]: درصد مصرف متاسپیس نسبت به ظرفیت فعلی فضا. .PP \f[CR]CCS\f[R]: درصد استفاده از فضای کلاس فشرده. .PP \f[CR]YGC\f[R]: تعداد رخدادهای GC نسل جدید. .PP \f[CR]YGCT\f[R]: زمان جمع‌آوری زباله نسل جدید. .PP \f[CR]FGC\f[R]: تعداد رخدادهای GC کامل. .PP \f[CR]FGCT\f[R]: زمان جمع‌آوری زباله کامل. .PP \f[CR]GCT\f[R]: مجموع کل زمان جمع‌آوری زباله. .RE .TP گزینه \f[CR]\-printcompilation\f[R] آمار متدهای کامپایلر Java HotSpot VM. .RS \f[CR]Compiled\f[R]: تعداد وظایف کامپایل انجام‌شده توسط متدی که اخیراً کامپایل شده است. .PP \f[CR]Size\f[R]: تعداد بایت‌های بایت‌کد متدی که اخیراً کامپایل شده است. .PP \f[CR]Type\f[R]: نوع کامپایل متدی که اخیراً کامپایل شده است. .PP \f[CR]Method\f[R]: نام کلاس و متدی که مشخص‌کننده متدی است که اخیراً کامپایل شده است. نام کلاس به جای نقطه (.) از اسلش (/) به عنوان جداکننده فضای نام استفاده می‌کند. نام متد، متد درون کلاس مشخص‌شده است. قالب این دو فیلد با گزینه \f[CR]\-XX:+PrintCompilation\f[R] در HotSpot مطابقت دارد. .RE .SH "شناسه ماشین مجازی (VIRTUAL MACHINE IDENTIFIER)" نحو رشته \f[CR]vmid\f[R] با نحو یک URI مطابقت دارد: .RS .PP [\f[I]protocol\f[R]\f[CR]:\f[R]][\f[CR]//\f[R]]\f[I]lvmid\f[R][\f[CR]\(at\f[R]\f[I]hostname\f[R][\f[CR]:\f[R]\f[I]port\f[R]][\f[CR]/\f[R]\f[I]servername\f[R]] .RE .PP نحو رشته \f[CR]vmid\f[R] با نحو یک URI مطابقت دارد. رشته \f[CR]vmid\f[R] می‌تواند از یک عدد صحیح ساده که نشان‌دهنده یک JVM محلی است تا ساختار پیچیده‌تری که پروتکل ارتباطی، شماره پورت و سایر مقادیر وابسته به پیاده‌سازی را مشخص می‌کند، متغیر باشد. .TP \f[I]protocol\f[R] پروتکل ارتباطی. اگر مقدار \f[I]protocol\f[R] حذف شود و نام میزبان مشخص نشده باشد، پروتکل پیش‌فرض یک پروتکل محلی بهینه‌سازی‌شده برای پلتفرم خواهد بود. اگر مقدار \f[I]protocol\f[R] حذف شود و نام میزبان مشخص شده باشد، پروتکل پیش‌فرض \f[CR]rmi\f[R] است. .TP \f[I]lvmid\f[R] شناسه محلی ماشین مجازی برای JVM هدف. مقدار \f[I]lvmid\f[R] یک مقدار وابسته به پلتفرم است که یک JVM را به طور یکتا در سیستم شناسایی می‌کند. مقدار \f[I]lvmid\f[R] تنها بخش الزامی یک شناسه ماشین مجازی است. مقدار \f[I]lvmid\f[R] معمولاً (اما نه لزوماً) شناسه فرآیند سیستم‌عامل (PID) برای فرآیند JVM هدف است. می‌توانید از دستور \f[CR]jps\f[R] برای تعیین \f[I]lvmid\f[R] استفاده کنید، به شرطی که فرآیندهای JVM در یک نمونه داکر جداگانه اجرا نشوند. همچنین می‌توانید در پلتفرم‌های لینوکس و macOS با دستور \f[CR]ps\f[R] و در ویندوز با Task Manager مقدار \f[I]lvmid\f[R] را تعیین کنید. .TP \f[I]hostname\f[R] نام میزبان یا آدرس IP که میزبان هدف را مشخص می‌کند. اگر مقدار \f[I]hostname\f[R] حذف شود، میزبان هدف همان میزبان محلی خواهد بود. .TP \f[I]port\f[R] پورت پیش‌فرض برای برقراری ارتباط با سرور راه دور. اگر مقدار \f[I]hostname\f[R] حذف شود یا مقدار \f[I]protocol\f[R] یک پروتکل محلی بهینه‌شده را مشخص کند، مقدار \f[I]port\f[R] نادیده گرفته می‌شود. در غیر این صورت، رفتار با پارامتر \f[I]port\f[R] وابسته به پیاده‌سازی است. برای پروتکل پیش‌فرض \f[CR]rmi\f[R]، مقدار پورت نشان‌دهنده شماره پورت \f[CR]rmiregistry\f[R] در میزبان راه دور است. اگر مقدار \f[I]port\f[R] حذف شود و مقدار \f[I]protocol\f[R] نشان‌دهنده \f[CR]rmi\f[R] باشد، از پورت پیش‌فرض rmiregistry (یعنی 1099) استفاده می‌شود. .TP \f[I]servername\f[R] نحوه برخورد با پارامتر \f[I]servername\f[R] به پیاده‌سازی بستگی دارد. برای پروتکل محلی بهینه‌شده، این فیلد نادیده گرفته می‌شود. برای پروتکل \f[CR]rmi\f[R]، این مقدار نشان‌دهنده نام شیء راه دور RMI در میزبان راه دور است. .SH "مثال‌ها (EXAMPLES)" این بخش چند مثال از مانیتورینگ یک JVM محلی با شناسه \f[I]lvmid\f[R] برابر با 21891 ارائه می‌دهد. .SS "گزینه GCUTIL (THE GCUTIL OPTION)" این مثال به lvmid برابر با 21891 متصل شده و ۷ نمونه در بازه‌های زمانی ۲۵۰ میلی‌ثانیه‌ای می‌گیرد و خروجی را مطابق با گزینه \f[CR]\-gcutil\f[R] نمایش می‌دهد. .PP خروجی این مثال نشان می‌دهد که یک جمع‌آوری نسل جدید بین نمونه سوم و چهارم رخ داده است. این جمع‌آوری ۰٫۰۷۸ ثانیه طول کشیده و اشیاء را از فضای ایدن (E) به فضای قدیم (O) ارتقا داده است که منجر به افزایش مصرف فضای قدیم از ۶۶٫۸۰٪ به ۶۸٫۱۹٪ شده است. قبل از جمع‌آوری، ۹۷٫۰۲٪ از فضای بازمانده مصرف شده بود، اما پس از این جمع‌آوری مصرف آن به ۹۱٫۰۳٪ رسیده است. .IP .EX jstat \-gcutil 21891 250 7 S0 S1 E O M CCS YGC YGCT FGC FGCT GCT 0.00 97.02 70.31 66.80 95.52 89.14 7 0.300 0 0.000 0.300 0.00 97.02 86.23 66.80 95.52 89.14 7 0.300 0 0.000 0.300 0.00 97.02 96.53 66.80 95.52 89.14 7 0.300 0 0.000 0.300 91.03 0.00 1.98 68.19 95.89 91.24 8 0.378 0 0.000 0.378 91.03 0.00 15.82 68.19 95.89 91.24 8 0.378 0 0.000 0.378 91.03 0.00 17.80 68.19 95.89 91.24 8 0.378 0 0.000 0.378 91.03 0.00 17.80 68.19 95.89 91.24 8 0.378 0 0.000 0.378 .EE .SS "تکرار رشته سرستون‌ها (REPEAT THE COLUMN HEADER STRING)" این مثال به lvmid برابر با 21891 متصل شده و نمونه‌هایی را در بازه‌های ۲۵۰ میلی‌ثانیه‌ای می‌گیرد و خروجی را طبق گزینه \f[CR]\-gcnew\f[R] نمایش می‌دهد. علاوه بر این، از گزینه \f[CR]\-h3\f[R] برای نمایش سرستون پس از هر ۳ سطر داده استفاده می‌کند. .PP علاوه بر نمایش تکرار رشته سرستون، این مثال نشان می‌دهد که بین نمونه‌های دوم و سوم یک GC نسل جدید رخ داده است. مدت زمان آن ۰٫۰۰۱ ثانیه بوده است. این جمع‌آوری به اندازه کافی داده فعال پیدا کرده که مصرف فضای بازمانده ۰ (S0U) از اندازه مطلوب بازماندگان (DSS) فراتر می‌رفت. در نتیجه، اشیاء به نسل قدیم ارتقا یافتند (که در این خروجی قابل مشاهده نیست) و آستانه ماندگاری (TT) از ۳۱ به ۲ کاهش یافت. .PP جمع‌آوری دیگری بین نمونه‌های پنجم و ششم رخ می‌دهد. این جمع‌آوری بازماندگان بسیار کمی پیدا کرد و آستانه ماندگاری را به ۳۱ بازگرداند. .IP .EX jstat \-gcnew \-h3 21891 250 S0C S1C S0U S1U TT MTT DSS EC EU YGC YGCT 64.0 64.0 0.0 31.7 31 31 32.0 512.0 178.6 249 0.203 64.0 64.0 0.0 31.7 31 31 32.0 512.0 355.5 249 0.203 64.0 64.0 35.4 0.0 2 31 32.0 512.0 21.9 250 0.204 S0C S1C S0U S1U TT MTT DSS EC EU YGC YGCT 64.0 64.0 35.4 0.0 2 31 32.0 512.0 245.9 250 0.204 64.0 64.0 35.4 0.0 2 31 32.0 512.0 421.1 250 0.204 64.0 64.0 0.0 19.0 31 31 32.0 512.0 84.4 251 0.204 S0C S1C S0U S1U TT MTT DSS EC EU YGC YGCT 64.0 64.0 0.0 19.0 31 31 32.0 512.0 306.7 251 0.204 .EE .SS "درج برچسب زمانی برای هر نمونه (INCLUDE A TIME STAMP FOR EACH SAMPLE)" این مثال به lvmid برابر با 21891 متصل شده و ۳ نمونه در بازه‌های ۲۵۰ میلی‌ثانیه‌ای می‌گیرد. از گزینه \f[CR]\-t\f[R] برای تولید برچسب زمانی برای هر نمونه در ستون اول استفاده شده است. .PP ستون Timestamp زمان سپری‌شده به ثانیه از زمان شروع JVM هدف را گزارش می‌دهد. علاوه بر این، خروجی \f[CR]\-gcoldcapacity\f[R] نشان می‌دهد که ظرفیت نسل قدیم (OGC) و ظرفیت فضای قدیم (OC) با گسترش هیپ برای پاسخگویی به تقاضاهای تخصیص یا ارتقا، افزایش می‌یابند. ظرفیت نسل قدیم (OGC) پس از هشتاد و یکمین جمع‌آوری زباله کامل (FGC) از ۱۱٬۶۹۶ کیلوبایت به ۱۳٬۸۲۰ کیلوبایت افزایش یافته است. حداکثر ظرفیت این نسل (و فضا) ۶۰٬۵۴۴ کیلوبایت (OGCMX) است، بنابراین هنوز جا برای گسترش دارد. .IP .EX Timestamp OGCMN OGCMX OGC OC YGC FGC FGCT GCT 150.1 1408.0 60544.0 11696.0 11696.0 194 80 2.874 3.799 150.4 1408.0 60544.0 13820.0 13820.0 194 81 2.938 3.863 150.7 1408.0 60544.0 13820.0 13820.0 194 81 2.938 3.863 .EE .SS "مانیتورینگ ابزاربندی برای یک JVM راه دور (MONITOR INSTRUMENTATION FOR A REMOTE JVM)" این مثال با استفاده از گزینه \f[CR]\-gcutil\f[R] به lvmid برابر با 40496 روی سیستمی به نام \f[CR]remote.domain\f[R] متصل شده و نمونه‌هایی را در هر ثانیه به طور نامحدود می‌گیرد. .PP مقدار lvmid با نام میزبان راه دور ترکیب شده تا یک vmid به صورت \f[CR]40496\(atremote.domain\f[R] بسازد. این vmid منجر به استفاده از پروتکل \f[CR]rmi\f[R] برای ارتباط با سرور پیش‌فرض \f[CR]jstatd\f[R] در میزبان راه دور می‌شود. سرور \f[CR]jstatd\f[R] با استفاده از دستور \f[CR]rmiregistry\f[R] در \f[CR]remote.domain\f[R] که به پورت پیش‌فرض دستور \f[CR]rmiregistry\f[R] (پورت 1099) متصل شده است، مکان‌یابی می‌شود. .IP .EX jstat \-gcutil 40496\(atremote.domain 1000 \&... خروجی حذف شده است .EE