.\" Copyright (c) 2004, 2020, Oracle and/or its affiliates. All rights reserved.
.\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
.\"
.\" This code is free software; you can redistribute it and/or modify it
.\" under the terms of the GNU General Public License version 2 only, as
.\" published by the Free Software Foundation.
.\"
.\" This code is distributed in the hope that it will be useful, but WITHOUT
.\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
.\" FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
.\" version 2 for more details (a copy is included in the LICENSE file that
.\" accompanied this code).
.\"
.\" You should have received a copy of the GNU General Public License version
.\" 2 along with this work; if not, write to the Free Software Foundation,
.\" Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
.\"
.\" Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
.\" or visit www.oracle.com if you need additional information or have any
.\" questions.
.\"
.\" Automatically generated by Pandoc 2.3.1
.\"
.TH "JSTAT" "1" "2021" "JDK 17" "JDK Commands"
.hy
.SH "نام (NAME)"
.PP
jstat \- پایش آمارهای JVM
.SH "خلاصه دستور (SYNOPSIS)"
.PP
\f[B]نکته:\f[R] این دستور آزمایشی است و پشتیبانی نمی‌شود.
.PP
\f[CB]jstat\f[R] \f[I]generalOptions\f[R]
.PP
\f[CB]jstat\f[R] \f[I]outputOptions\f[R] [\f[CB]\-t\f[R]] [\f[CB]\-h\f[R]
\f[I]lines\f[R]] \f[I]vmid\f[R] [\f[I]interval\f[R] [\f[I]count\f[R]]]
.TP
.B \f[I]generalOptions\f[R]
یک تک‌گزینه عمومی خط فرمان.
بخش \f[B]General Options\f[R] را ببینید.
.RS
.RE
.TP
.B \f[I]outputOptions\f[R]
گزینه‌ای که توسط گزینه \f[CB]\-options\f[R] گزارش شده است.
یک یا چند گزینه خروجی که شامل یک \f[CB]statOption\f[R] منفرد،
به‌همراه هر یک از گزینه‌های \f[CB]\-t\f[R]، \f[CB]\-h\f[R] و \f[CB]\-J\f[R] است.
بخش \f[B]Output Options for the jstat Command\f[R] را ببینید.
.RS
.RE
.TP
.B \f[CB]\-t\f[R]
یک ستون برچسب زمان (time\-stamp) را به‌عنوان نخستین ستون خروجی نمایش می‌دهد.
برچسب زمان، مدت‌زمان سپری‌شده از زمان شروع JVM هدف است.
.RS
.RE
.TP
.B \f[CB]\-h\f[R] \f[I]n\f[R]
یک سرستون را به‌ازای هر \f[I]n\f[R] نمونه (ردیف‌های خروجی) نمایش می‌دهد، که در آن
\f[I]n\f[R] یک عدد صحیح مثبت است.
مقدار پیش‌فرض \f[CB]0\f[R] است، که سرستون را برای نخستین ردیف داده‌ها نمایش می‌دهد.
.RS
.RE
.TP
.B \f[I]vmid\f[R]
شناسه ماشین مجازی، که رشته‌ای نمایانگر JVM هدف است.
بخش \f[B]Virtual Machine Identifier\f[R] را ببینید.
.RS
.RE
.TP
.B \f[I]interval\f[R]
بازه زمانی نمونه‌برداری با واحدهای مشخص‌شده، ثانیه (s) یا
میلی‌ثانیه (ms).
واحد پیش‌فرض میلی‌ثانیه است.
این مقدار باید یک عدد صحیح مثبت باشد.
در صورت تعیین، دستور \f[CB]jstat\f[R] خروجی خود را در هر بازه زمانی
تولید می‌کند.
.RS
.RE
.TP
.B \f[I]count\f[R]
تعداد نمونه‌ها برای نمایش.
مقدار پیش‌فرض بی‌نهایت است، که باعث می‌شود دستور \f[CB]jstat\f[R]
آمار را تا زمانی که JVM هدف خاتمه یابد یا خود دستور
\f[CB]jstat\f[R] متوقف شود، نمایش دهد.
این مقدار باید یک عدد صحیح مثبت باشد.
.RS
.RE.SH "توضیحات (DESCRIPTION)"
.PP
دستور \f[CB]jstat\f[R] آمارهای عملکردی را برای یک Java HotSpot VM ابزاربندی‌شده نمایش می‌دهد.
ماشین مجازی JVM هدف توسط شناسه ماشین مجازی (virtual machine identifier) یا گزینه \f[CB]vmid\f[R] مشخص می‌شود.
.PP
دستور \f[CB]jstat\f[R] از دو نوع گزینه پشتیبانی می‌کند: گزینه‌های عمومی و گزینه‌های خروجی.
گزینه‌های عمومی باعث می‌شوند دستور \f[CB]jstat\f[R] اطلاعات کاربردی ساده و نسخه را نمایش دهد.
گزینه‌های خروجی، محتوا و قالب خروجی آماری را تعیین می‌کنند.
.PP
تمام گزینه‌ها و عملکردهای آن‌ها ممکن است در نسخه‌های بعدی دستخوش تغییر یا حذف شوند.
.SH "گزینه‌های عمومی (GENERAL OPTIONS)"
.PP
اگر یکی از گزینه‌های عمومی را مشخص کنید، نمی‌توانید هیچ گزینه یا پارامتر دیگری را تعیین نمایید.
.TP
.B \f[CB]\-help\f[R]
یک پیام راهنما را نمایش می‌دهد.
.RS
.RE
.TP
.B \f[CB]\-options\f[R]
فهرستی از گزینه‌های آماری را نمایش می‌دهد.
بخش \f[B]گزینه‌های خروجی برای دستور JSTAT\f[R] را ببینید.
.RS
.RE
.SH "گزینه‌های خروجی برای دستور JSTAT (OUTPUT OPTIONS FOR THE JSTAT COMMAND)"
.PP
اگر گزینه عمومی را مشخص نکنید، می‌توانید گزینه‌های خروجی را تعیین کنید.
گزینه‌های خروجی، محتوا و قالب خروجی دستور \f[CB]jstat\f[R] را تعیین کرده و شامل یک \f[CB]statOption\f[R] منفرد به‌همراه هر یک از دیگر گزینه‌های خروجی (\f[CB]\-h\f[R]، \f[CB]\-t\f[R] و \f[CB]\-J\f[R]) هستند.
گزینه \f[CB]statOption\f[R] باید در ابتدا بیاید.
.PP
خروجی در قالب یک جدول قالب‌بندی می‌شود که ستون‌های آن با فاصله از یکدیگر جدا شده‌اند.
یک سطر سرایند با عنوان‌ها، ستون‌ها را توصیف می‌کند.
از گزینه \f[CB]\-h\f[R] برای تنظیم بسامد نمایش سرایند استفاده کنید.
نام‌های سرایند ستون‌ها در بین گزینه‌های مختلف یکپارچه هستند.
به‌طور کلی، اگر دو گزینه ستونی با نام یکسان ارائه دهند، منبع داده آن دو ستون یکسان است.
.PP
از گزینه \f[CB]\-t\f[R] برای نمایش یک ستون برچسب زمان، با عنوان Timestamp به‌عنوان نخستین ستون خروجی استفاده کنید.
ستون Timestamp شامل زمان سپری‌شده (به ثانیه) از زمان شروع JVM هدف است.
دقت برچسب زمان به عوامل متعددی بستگی دارد و ممکن است به‌دلیل تأخیر در زمان‌بندی رشته‌ها (thread scheduling) در سیستم‌های زیر بار سنگین، دستخوش نوسان شود.
.PP
از پارامترهای interval و count به‌ترتیب برای مشخص کردن بسامد زمانی و تعداد دفعاتی که دستور \f[CB]jstat\f[R] خروجی خود را نمایش می‌دهد، استفاده کنید.
.PP
\f[B]نکته:\f[R]
.PP
برای پردازش و تجزیه خروجی دستور \f[CB]jstat\f[R] اسکریپت ننویسید؛ زیرا قالب آن ممکن است در نسخه‌های آینده تغییر کند.
اگر اسکریپت‌هایی برای تجزیه خروجی دستور \f[CB]jstat\f[R] می‌نویسید، انتظار داشته باشید که مجبور به اصلاح آن‌ها برای نسخه‌های بعدی این ابزار شوید.
.TP
.B \f[CB]\-statOption\f[R]
اطلاعات آماری‌ای را که دستور \f[CB]jstat\f[R] نمایش می‌دهد تعیین می‌کند.
موارد زیر گزینه‌های موجود را فهرست می‌کنند.
از گزینه عمومی \f[CB]\-options\f[R] برای نمایش فهرست گزینه‌ها در یک نصب خاص از بستر استفاده کنید.
بخش \f[B]گزینه‌های آماری و خروجی (Stat Options and Output)\f[R] را ببینید.
.RS
.PP
\f[CB]class\f[R]: آمارهای مربوط به رفتار بارگذار کلاس (class loader) را نمایش می‌دهد.
.PP
\f[CB]compiler\f[R]: آمارهای مربوط به رفتار کامپایلر درجا (Just\-in\-Time) ماشین مجازی Java HotSpot را نمایش می‌دهد.
.PP
\f[CB]gc\f[R]: آمارهای مربوط به رفتار حافظه هیپ زباله‌روبی‌شده (garbage collected heap) را نمایش می‌دهد.
.PP
\f[CB]gccapacity\f[R]: آمارهای مربوط به ظرفیت‌های نسل‌ها و فضاهای متناظر آن‌ها را نمایش می‌دهد.
.PP
\f[CB]gccause\f[R]: خلاصه‌ای از آمارهای زباله‌روبی (مشابه \f[CB]\-gcutil\f[R]) را همراه با علت آخرین رویداد زباله‌روبی و رویداد فعلی (در صورت وجود) نمایش می‌دهد.
.PP
\f[CB]gcnew\f[R]: آمارهای مربوط به رفتار نسل جدید (new generation) را نمایش می‌دهد.
.PP
\f[CB]gcnewcapacity\f[R]: آمارهای مربوط به اندازه‌های نسل جدید و فضاهای متناظر آن‌ها را نمایش می‌دهد.
.PP
\f[CB]gcold\f[R]: آمارهای مربوط به رفتار نسل قدیم (old generation) و آمارهای metaspace را نمایش می‌دهد.
.PP
\f[CB]gcoldcapacity\f[R]: آمارهای مربوط به اندازه‌های نسل قدیم را نمایش می‌دهد.
.PP
\f[CB]gcmetacapacity\f[R]: آمارهای مربوط به اندازه‌های metaspace را نمایش می‌دهد.
.PP
\f[CB]gcutil\f[R]: خلاصه‌ای از آمارهای مربوط به زباله‌روبی را نمایش می‌دهد.
.PP
\f[CB]printcompilation\f[R]: آمارهای متد کامپایل Java HotSpot VM را نمایش می‌دهد.
.RE
.TP
.B \f[CB]\-J\f[R]\f[I]javaOption\f[R]
مقدار \f[I]javaOption\f[R] را به راه‌انداز برنامه جاوا (launcher) ارسال می‌کند.
برای نمونه، \f[CB]\-J\-Xms48m\f[R] حافظه راه‌اندازی را روی ۴۸ مگابایت تنظیم می‌کند.
برای فهرست کامل گزینه‌ها، \f[B]java\f[R] را ببینید.
.RS
.RE.SH "گزینه‌های آماری و خروجی (STAT OPTIONS AND OUTPUT)"
.PP
اطلاعات زیر ستون‌هایی را که دستور \f[CB]jstat\f[R] برای هر \f[I]statOption\f[R] در خروجی نمایش می‌دهد، خلاصه می‌کند.
.TP
.B \f[I]گزینهٔ\f[R] \f[CB]\-class\f[R]
آمار بارگذار کلاس.
.RS
.PP
\f[CB]Loaded\f[R]: تعداد کلاس‌های بارگذاری‌شده.
.PP
\f[CB]Bytes\f[R]: تعداد کیلوبایت‌های بارگذاری‌شده.
.PP
\f[CB]Unloaded\f[R]: تعداد کلاس‌های تخلیه‌شده.
.PP
\f[CB]Bytes\f[R]: تعداد کیلوبایت‌های تخلیه‌شده.
.PP
\f[CB]Time\f[R]: مدت‌زمان صرف‌شده برای انجام عملیات بارگذاری و تخلیهٔ کلاس‌ها.
.RE
.TP
.B \f[I]گزینهٔ\f[R] \f[CB]\-compiler\f[R]
آمار کامپایلر Just\-in\-Time در Java HotSpot VM.
.RS
.PP
\f[CB]Compiled\f[R]: تعداد وظایف کامپایل انجام‌شده.
.PP
\f[CB]Failed\f[R]: تعداد وظایف کامپایل شکست‌خورده.
.PP
\f[CB]Invalid\f[R]: تعداد وظایف کامپایلی که باطل شده‌اند.
.PP
\f[CB]Time\f[R]: مدت‌زمان صرف‌شده برای انجام وظایف کامپایل.
.PP
\f[CB]FailedType\f[R]: نوع کامپایل آخرین کامپایل ناموفق.
.PP
\f[CB]FailedMethod\f[R]: نام کلاس و متد آخرین کامپایل ناموفق.
.RE
.TP
.B \f[I]گزینهٔ\f[R] \f[CB]\-gc\f[R]
آمار هیپ زباله‌روبی‌شده.
.RS
.PP
\f[CB]S0C\f[R]: ظرفیت فعلی فضای بازماندهٔ ۰ (KB).
.PP
\f[CB]S1C\f[R]: ظرفیت فعلی فضای بازماندهٔ ۱ (KB).
.PP
\f[CB]S0U\f[R]: میزان استفاده از فضای بازماندهٔ ۰ (KB).
.PP
\f[CB]S1U\f[R]: میزان استفاده از فضای بازماندهٔ ۱ (KB).
.PP
\f[CB]EC\f[R]: ظرفیت فعلی فضای eden (بر حسب KB).
.PP
\f[CB]EU\f[R]: میزان استفاده از فضای eden (بر حسب KB).
.PP
\f[CB]OC\f[R]: ظرفیت فعلی فضای قدیمی (KB).
.PP
\f[CB]OU\f[R]: میزان استفاده از فضای قدیمی (KB).
.PP
\f[CB]MC\f[R]: اندازهٔ تخصیص‌یافتهٔ Metaspace (بر حسب KB).
.PP
\f[CB]MU\f[R]: میزان استفاده از Metaspace (بر حسب KB).
.PP
\f[CB]CCSC\f[R]: اندازهٔ تخصیص‌یافتهٔ کلاس فشرده (KB).
.PP
\f[CB]CCSU\f[R]: میزان استفاده از فضای کلاس فشرده (KB).
.PP
\f[CB]YGC\f[R]: تعداد رخدادهای زباله‌روبی (GC) نسل جوان.
.PP
\f[CB]YGCT\f[R]: مدت‌زمان زباله‌روبی نسل جوان.
.PP
\f[CB]FGC\f[R]: تعداد رخدادهای GC کامل (Full GC).
.PP
\f[CB]FGCT\f[R]: مدت‌زمان زباله‌روبی کامل.
.PP
\f[CB]GCT\f[R]: کل مدت‌زمان زباله‌روبی.
.RE
.TP
.B \f[I]گزینهٔ\f[R] \f[CB]\-gccapacity\f[R]
ظرفیت‌های فضا و نسل‌های استخر حافظه.
.RS
.PP
\f[CB]NGCMN\f[R]: حداقل ظرفیت نسل جدید (KB).
.PP
\f[CB]NGCMX\f[R]: حداکثر ظرفیت نسل جدید (KB).
.PP
\f[CB]NGC\f[R]: ظرفیت فعلی نسل جدید (KB).
.PP
\f[CB]S0C\f[R]: ظرفیت فعلی فضای بازماندهٔ ۰ (KB).
.PP
\f[CB]S1C\f[R]: ظرفیت فعلی فضای بازماندهٔ ۱ (KB).
.PP
\f[CB]EC\f[R]: ظرفیت فعلی فضای eden (بر حسب KB).
.PP
\f[CB]OGCMN\f[R]: حداقل ظرفیت نسل قدیم (KB).
.PP
\f[CB]OGCMX\f[R]: حداکثر ظرفیت نسل قدیم (KB).
.PP
\f[CB]OGC\f[R]: ظرفیت فعلی نسل قدیم (KB).
.PP
\f[CB]OC\f[R]: ظرفیت فعلی فضای قدیمی (KB).
.PP
\f[CB]MCMN\f[R]: حداقل ظرفیت Metaspace (بر حسب KB).
.PP
\f[CB]MCMX\f[R]: حداکثر ظرفیت Metaspace (بر حسب KB).
.PP
\f[CB]MC\f[R]: اندازهٔ تخصیص‌یافتهٔ Metaspace (بر حسب KB).
.PP
\f[CB]CCSMN\f[R]: حداقل ظرفیت فضای کلاس فشرده (KB).
.PP
\f[CB]CCSMX\f[R]: حداکثر ظرفیت فضای کلاس فشرده (KB).
.PP
\f[CB]CCSC\f[R]: اندازهٔ تخصیص‌یافتهٔ فضای کلاس فشرده (KB).
.PP
\f[CB]YGC\f[R]: تعداد رخدادهای GC در نسل جوان.
.PP
\f[CB]FGC\f[R]: تعداد رخدادهای GC کامل.
.RE
.TP
.B \f[I]گزینهٔ\f[R] \f[CB]\-gccause\f[R]
این گزینه همان خلاصهٔ آمارهای زباله‌روبی را که توسط گزینهٔ \f[CB]\-gcutil\f[R]
نمایش داده می‌شود ارائه می‌کند، اما علت‌های آخرین رخداد زباله‌روبی
و (در صورت وجود) رخداد زباله‌روبیِ فعلی را نیز شامل می‌شود.
علاوه بر ستون‌های فهرست‌شده برای \f[CB]\-gcutil\f[R]، این گزینه
ستون‌های زیر را اضافه می‌کند:
.RS
.PP
\f[CB]LGCC\f[R]: علت آخرین زباله‌روبی
.PP
\f[CB]GCC\f[R]: علت زباله‌روبی فعلی
.RE
.TP
.B \f[I]گزینهٔ\f[R] \f[CB]\-gcnew\f[R]
آمارهای نسل جدید.
.RS
.PP
\f[CB]S0C\f[R]: ظرفیت فعلی فضای بازماندهٔ ۰ (KB).
.PP
\f[CB]S1C\f[R]: ظرفیت فعلی فضای بازماندهٔ ۱ (KB).
.PP
\f[CB]S0U\f[R]: میزان استفاده از فضای بازماندهٔ ۰ (KB).
.PP
\f[CB]S1U\f[R]: میزان استفاده از فضای بازماندهٔ ۱ (KB).
.PP
\f[CB]TT\f[R]: آستانهٔ ارتقا (Tenuring threshold).
.PP
\f[CB]MTT\f[R]: حداکثر آستانهٔ ارتقا.
.PP
\f[CB]DSS\f[R]: اندازهٔ مطلوب فضای بازمانده (KB).
.PP
\f[CB]EC\f[R]: ظرفیت فعلی فضای eden (بر حسب KB).
.PP
\f[CB]EU\f[R]: میزان استفاده از فضای eden (بر حسب KB).
.PP
\f[CB]YGC\f[R]: تعداد رخدادهای GC نسل جوان.
.PP
\f[CB]YGCT\f[R]: مدت‌زمان زباله‌روبی نسل جوان.
.RE
.TP
.B \f[I]گزینهٔ\f[R] \f[CB]\-gcnewcapacity\f[R]
آمارهای اندازهٔ فضای نسل جدید.
.RS
.PP
\f[CB]NGCMN\f[R]: حداقل ظرفیت نسل جدید (KB).
.PP
\f[CB]NGCMX\f[R]: حداکثر ظرفیت نسل جدید (KB).
.PP
\f[CB]NGC\f[R]: ظرفیت فعلی نسل جدید (KB).
.PP
\f[CB]S0CMX\f[R]: حداکثر ظرفیت فضای بازماندهٔ ۰ (KB).
.PP
\f[CB]S0C\f[R]: ظرفیت فعلی فضای بازماندهٔ ۰ (KB).
.PP
\f[CB]S1CMX\f[R]: حداکثر ظرفیت فضای بازماندهٔ ۱ (KB).
.PP
\f[CB]S1C\f[R]: ظرفیت فعلی فضای بازماندهٔ ۱ (KB).
.PP
\f[CB]ECMX\f[R]: حداکثر ظرفیت فضای eden (بر حسب KB).
.PP
\f[CB]EC\f[R]: ظرفیت فعلی فضای eden (بر حسب KB)..PP
\f[CB]YGC\f[R]: تعداد رویدادهای GC نسل جوان.
.PP
\f[CB]FGC\f[R]: تعداد رویدادهای Full GC.
.RE
.TP
.B \f[CB]\-gcold\f[R] \f[I]گزینه\f[R]
آمارهای اندازهٔ نسل قدیم.
.RS
.PP
\f[CB]MC\f[R]: اندازهٔ تخصیص‌یافتهٔ Metaspace (کیلوبایت).
.PP
\f[CB]MU\f[R]: میزان استفاده از Metaspace (کیلوبایت).
.PP
\f[CB]CCSC\f[R]: اندازهٔ تخصیص‌یافتهٔ کلاس فشرده (کیلوبایت).
.PP
\f[CB]CCSU\f[R]: فضای استفاده‌شدهٔ کلاس فشرده (کیلوبایت).
.PP
\f[CB]OC\f[R]: ظرفیت فعلی فضای قدیم (کیلوبایت).
.PP
\f[CB]OU\f[R]: میزان استفاده از فضای قدیم (کیلوبایت).
.PP
\f[CB]YGC\f[R]: تعداد رویدادهای GC نسل جوان.
.PP
\f[CB]FGC\f[R]: تعداد رویدادهای Full GC.
.PP
\f[CB]FGCT\f[R]: زمان جمع‌آوری زباله کامل (Full GC).
.PP
\f[CB]GCT\f[R]: کل زمان جمع‌آوری زباله.
.RE
.TP
.B \f[CB]\-gcoldcapacity\f[R] \f[I]گزینه\f[R]
آمارهای نسل قدیم.
.RS
.PP
\f[CB]OGCMN\f[R]: حداقل ظرفیت نسل قدیم (کیلوبایت).
.PP
\f[CB]OGCMX\f[R]: حداکثر ظرفیت نسل قدیم (کیلوبایت).
.PP
\f[CB]OGC\f[R]: ظرفیت فعلی نسل قدیم (کیلوبایت).
.PP
\f[CB]OC\f[R]: ظرفیت فعلی فضای قدیم (کیلوبایت).
.PP
\f[CB]YGC\f[R]: تعداد رویدادهای GC نسل جوان.
.PP
\f[CB]FGC\f[R]: تعداد رویدادهای Full GC.
.PP
\f[CB]FGCT\f[R]: زمان جمع‌آوری زباله کامل (Full GC).
.PP
\f[CB]GCT\f[R]: کل زمان جمع‌آوری زباله.
.RE
.TP
.B \f[CB]\-gcmetacapacity\f[R] \f[I]گزینه\f[R]
آمارهای اندازهٔ Metaspace.
.RS
.PP
\f[CB]MCMN\f[R]: حداقل ظرفیت Metaspace (کیلوبایت).
.PP
\f[CB]MCMX\f[R]: حداکثر ظرفیت Metaspace (کیلوبایت).
.PP
\f[CB]MC\f[R]: اندازهٔ تخصیص‌یافتهٔ Metaspace (کیلوبایت).
.PP
\f[CB]CCSMN\f[R]: حداقل ظرفیت فضای کلاس فشرده (کیلوبایت).
.PP
\f[CB]CCSMX\f[R]: حداکثر ظرفیت فضای کلاس فشرده (کیلوبایت).
.PP
\f[CB]YGC\f[R]: تعداد رویدادهای GC نسل جوان.
.PP
\f[CB]FGC\f[R]: تعداد رویدادهای Full GC.
.PP
\f[CB]FGCT\f[R]: زمان جمع‌آوری زباله کامل (Full GC).
.PP
\f[CB]GCT\f[R]: کل زمان جمع‌آوری زباله.
.RE
.TP
.B \f[CB]\-gcutil\f[R] \f[I]گزینه\f[R]
خلاصهٔ آمارهای جمع‌آوری زباله.
.RS
.PP
\f[CB]S0\f[R]: میزان استفاده از فضای نجات‌یافته ۰ (Survivor space 0) به صورت درصدی از ظرفیت فعلی فضا.
.PP
\f[CB]S1\f[R]: میزان استفاده از فضای نجات‌یافته ۱ (Survivor space 1) به صورت درصدی از ظرفیت فعلی فضا.
.PP
\f[CB]E\f[R]: میزان استفاده از فضای Eden به صورت درصدی از ظرفیت فعلی فضا.
.PP
\f[CB]O\f[R]: میزان استفاده از فضای قدیم (Old space) به صورت درصدی از ظرفیت فعلی فضا.
.PP
\f[CB]M\f[R]: میزان استفاده از Metaspace به صورت درصدی از ظرفیت فعلی فضا.
.PP
\f[CB]CCS\f[R]: میزان استفاده از فضای کلاس فشرده به صورت درصد.
.PP
\f[CB]YGC\f[R]: تعداد رویدادهای GC نسل جوان.
.PP
\f[CB]YGCT\f[R]: زمان جمع‌آوری زباله نسل جوان.
.PP
\f[CB]FGC\f[R]: تعداد رویدادهای Full GC.
.PP
\f[CB]FGCT\f[R]: زمان جمع‌آوری زباله کامل (Full GC).
.PP
\f[CB]GCT\f[R]: کل زمان جمع‌آوری زباله.
.RE
.TP
.B \f[CB]\-printcompilation\f[R] \f[I]گزینه\f[R]
آمارهای متدهای کامپایلر Java HotSpot VM.
.RS
.PP
\f[CB]Compiled\f[R]: تعداد وظایف کامپایل انجام‌شده توسط جدیدترین متد کامپایل‌شده.
.PP
\f[CB]Size\f[R]: تعداد بایت‌های بایت‌کدِ جدیدترین متد کامپایل‌شده.
.PP
\f[CB]Type\f[R]: نوع کامپایل جدیدترین متد کامپایل‌شده.
.PP
\f[CB]Method\f[R]: نام کلاس و نام متدی که جدیدترین متد کامپایل‌شده را مشخص می‌کنند.
نام کلاس به جای نقطه (.) از یک اسلش (/) به عنوان جداکنندهٔ فضای نام استفاده می‌کند.
نام متد، متدِ درون کلاس مشخص‌شده است.
قالب این دو فیلد با گزینهٔ \f[CB]\-XX:+PrintCompilation\f[R] در HotSpot سازگار است.
.RE.SH "شناسه ماشین مجازی (VIRTUAL MACHINE IDENTIFIER)"
.PP
ساختار نوشتاری رشتهٔ \f[CB]vmid\f[R] متناظر با نحو یک URI است:
.RS
.PP
[\f[I]protocol\f[R]\f[CB]:\f[R]][\f[CB]//\f[R]]\f[I]lvmid\f[R][\f[CB]\@\f[R]\f[I]hostname\f[R][\f[CB]:\f[R]\f[I]port\f[R]][\f[CB]/\f[R]\f[I]servername\f[R]]
.RE
.PP
ساختار رشتهٔ \f[CB]vmid\f[R] با ساختار یک URI همخوانی دارد.
رشتهٔ \f[CB]vmid\f[R] می‌تواند از یک عدد صحیح ساده که نشان‌دهندهٔ یک JVM محلی است تا ساختاری پیچیده‌تر که پروتکل ارتباطی، شماره پورت و سایر مقادیر وابسته به پیاده‌سازی را مشخص می‌کند، متغیر باشد.
.TP
.B \f[I]protocol\f[R]
پروتکل ارتباطی.
اگر مقدار \f[I]protocol\f[R] حذف شود و نام میزبانی مشخص نشده باشد، پروتکل پیش‌فرض یک پروتکل محلی بهینه‌شده و وابسته به پلتفرم خواهد بود.
اگر مقدار \f[I]protocol\f[R] حذف شود اما نام میزبان مشخص شده باشد، پروتکل پیش‌فرض \f[CB]rmi\f[R] است.
.RS
.RE
.TP
.B \f[I]lvmid\f[R]
شناسهٔ محلی ماشین مجازی برای JVM هدف.
مقدار \f[I]lvmid\f[R] یک مقدار وابسته به پلتفرم است که به‌طور یکتا یک JVM را روی سیستم مشخص می‌کند.
\f[I]lvmid\f[R] تنها مؤلفهٔ الزامی در شناسهٔ ماشین مجازی است.
به‌طور معمول، اما نه لزوماً، \f[I]lvmid\f[R] همان شناسه فرایند (PID) سیستم‌عامل برای فرایند JVM هدف است.
در صورتی که فرایندهای JVM در یک نمونهٔ مجزای docker اجرا نشده باشند، می‌توانید از دستور \f[CB]jps\f[R] برای تعیین \f[I]lvmid\f[R] استفاده کنید.
همچنین می‌توانید \f[I]lvmid\f[R] را در پلتفرم‌های Linux و OS X با دستور \f[CB]ps\f[R]، و در Windows از طریق Task Manager ویندوز به دست آورید.
.RS
.RE
.TP
.B \f[I]hostname\f[R]
نام میزبان یا نشانی IP که میزبان هدف را مشخص می‌کند.
اگر مقدار \f[I]hostname\f[R] حذف شود، میزبان هدف همان میزبان محلی خواهد بود.
.RS
.RE
.TP
.B \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[CB]rmi\f[R]، مقدار پورت نشان‌دهندهٔ شماره پورت برای \f[CB]rmiregistry\f[R] روی میزبان دوردست است.
اگر مقدار \f[I]port\f[R] حذف شود و مقدار \f[I]protocol\f[R] نمایانگر \f[CB]rmi\f[R] باشد، از پورت پیش‌فرض rmiregistry یعنی (1099) استفاده می‌شود.
.RS
.RE
.TP
.B \f[I]servername\f[R]
نحوهٔ رفتار با پارامتر \f[I]servername\f[R] به پیاده‌سازی بستگی دارد.
برای پروتکل محلی بهینه‌شده، این فیلد نادیده گرفته می‌شود.
برای پروتکل \f[CB]rmi\f[R]، این فیلد نشان‌دهندهٔ نام شیء دوردست RMI روی میزبان دوردست است.
.RS
.RE
.SH "مثال‌ها (EXAMPLES)"
.PP
این بخش چند مثال از پایش یک JVM محلی با \f[I]lvmid\f[R] برابر با 21891 را ارائه می‌دهد.
.SH "گزینه GCUTIL (THE GCUTIL OPTION)"
.PP
این مثال به lvmid با شمارهٔ 21891 متصل شده و ۷ نمونه در فواصل زمانی ۲۵۰ میلی‌ثانیه‌ای می‌گیرد و خروجی را همان‌طور که توسط گزینهٔ \f[CB]\-gcutil\f[R] تعیین شده نمایش می‌دهد.
.PP
خروجی این مثال نشان می‌دهد که یک جمع‌آوری حافظه در نسل جوان (young generation collection) بین نمونه‌های سوم و چهارم رخ داده است.
این جمع‌آوری 0.078 ثانیه به طول انجامید و اشیاء را از فضای eden (با E) به فضای old (با O) ارتقا داد، که منجر به افزایش بهره‌برداری از فضای old از 66.80% به 68.19% شد.
پیش از این جمع‌آوری، فضای survivor به میزان 97.02% مورد استفاده بود، اما پس از این جمع‌آوری بهره‌برداری از آن به 91.03% رسید.
.IP
.nf
\f[CB]
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
\f[R]
.fi.SH "تکرار رشته سرستون (REPEAT THE COLUMN HEADER STRING)"
.PP
این مثال به lvmid 21891 متصل شده و در بازه‌های زمانی ۲۵۰ میلی‌ثانیه‌ای نمونه‌برداری می‌کند و خروجی را همان‌گونه که توسط گزینه
\f[CB]\-gcnew\f[R] مشخص شده، نمایش می‌دهد.
علاوه بر این، از گزینه \f[CB]\-h3\f[R] برای نمایش سرستون پس از هر ۳ سطر داده استفاده می‌کند.
.PP
این مثال، علاوه بر نمایش رشته سرستون تکرارشونده، نشان می‌دهد که بین نمونه‌های دوم و سوم، یک GC نسل جوان (young GC) رخ داده است.
مدت زمان آن 0.001 ثانیه بود.
این گردآوری به اندازه کافی داده فعال پیدا کرد که در نتیجه آن، میزان مصرف فضای بازمانده ۰ (S0U) از اندازه بازمانده مطلوب (DSS) فراتر می‌رفت.
در نتیجه، اشیاء به نسل قدیمی (old generation) ارتقا یافتند (که در این خروجی قابل مشاهده نیست) و آستانه ماندگاری (TT) از ۳۱ به ۲ کاهش یافت.
.PP
گردآوری دیگری بین نمونه‌های پنجم و ششم رخ می‌دهد.
این گردآوری، بازماندگان بسیار اندکی یافت و آستانه ماندگاری را به ۳۱ بازگرداند.
.IP
.nf
\f[CB]
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
\f[R]
.fi
.SH "گنجاندن برچسب زمانی برای هر نمونه (INCLUDE A TIME STAMP FOR EACH SAMPLE)"
.PP
این مثال به lvmid 21891 متصل شده و ۳ نمونه در بازه‌های زمانی ۲۵۰ میلی‌ثانیه‌ای می‌گیرد.
گزینه \f[CB]\-t\f[R] برای ایجاد یک برچسب زمانی برای هر نمونه در ستون اول استفاده شده است.
.PP
ستون Timestamp زمان سپری‌شده بر حسب ثانیه را از زمان شروع JVM هدف گزارش می‌کند.
علاوه بر این، خروجی \f[CB]\-gcoldcapacity\f[R] نشان می‌دهد که ظرفیت نسل قدیمی (OGC) و ظرفیت فضای قدیمی (OC) هم‌زمان با گسترش heap برای برآورده کردن نیازهای تخصیص یا ارتقا، افزایش می‌یابند.
ظرفیت نسل قدیمی (OGC) پس از هشتاد و یکمین گردآوری زباله کامل (FGC)، از ۱۱٬۶۹۶ کیلوبایت به ۱۳٬۸۲۰ کیلوبایت افزایش یافته است.
حداکثر ظرفیت این نسل (و فضا) ۶۰٬۵۴۴ کیلوبایت (OGCMX) است، بنابراین هنوز فضای کافی برای گسترش دارد.
.IP
.nf
\f[CB]
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
\f[R]
.fi
.SH "پایش ابزار دقیق برای یک JVM از راه دور (MONITOR INSTRUMENTATION FOR A REMOTE JVM)"
.PP
این مثال به lvmid 40496 در سیستمی به نام
\f[CB]remote.domain\f[R] با استفاده از گزینه \f[CB]\-gcutil\f[R] متصل می‌شود، و نمونه‌ها هر یک ثانیه یک‌بار به‌طور نامحدود گرفته می‌شوند.
.PP
مقدار lvmid با نام میزبان راه دور ترکیب می‌شود تا یک vmid به صورت
\f[CB]40496\@remote.domain\f[R] بسازد.
این vmid موجب استفاده از پروتکل \f[CB]rmi\f[R] برای برقراری ارتباط با سرور پیش‌فرض \f[CB]jstatd\f[R] در میزبان راه دور می‌شود.
سرور \f[CB]jstatd\f[R] با استفاده از دستور \f[CB]rmiregistry\f[R] در \f[CB]remote.domain\f[R] تعیین مکان می‌شود که به درگاه پیش‌فرض دستور \f[CB]rmiregistry\f[R] (درگاه 1099) مقید شده است.
.IP
.nf
\f[CB]
jstat\ \-gcutil\ 40496\@remote.domain\ 1000
\&...\ output\ omitted
\f[R]
.fi