.\" Copyright (c) 2004, 2023, 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.19.2
.\"
.\" Define V font for inline verbatim, using C font in formats
.\" that render this, and otherwise B font.
.ie "\f[CB]x\f[R]"x" \{\
. ftr V B
. ftr VI BI
. ftr VB B
. ftr VBI BI
.\}
.el \{\
. ftr V CR
. ftr VI CI
. ftr VB CB
. ftr VBI CBI
.\}
.TH "JSTAT-OPENJDK21" "1" "2023" "JDK 21" "دستورات JDK"
.hy
.SH "نام (NAME)"
jstat-openjdk21 \- مانیتورینگ و نظارت بر آمار عملکرد ماشین مجازی جاوا در OpenJDK 21
.SH "خلاصه دستور (SYNOPSIS)"
.PP
\f[B]نکته:\f[R] این دستور آزمایشی بوده و پشتیبانی نمی‌شود.
.PP
\f[V]jstat\f[R] \f[I]generalOptions\f[R]
.PP
\f[V]jstat\f[R] \f[I]outputOptions\f[R] [\f[V]-t\f[R]] [\f[V]-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[V]-options\f[R] گزارش می‌شود.
یک یا چند گزینه خروجی شامل یک \f[V]statOption\f[R] به همراه هر یک از گزینه‌های
\f[V]-t\f[R]، \f[V]-h\f[R] و \f[V]-J\f[R].
بخش \f[B]گزینه‌های خروجی دستور JSTAT (OUTPUT OPTIONS FOR THE JSTAT COMMAND)\f[R] را ببینید.
.TP
\f[V]-t\f[R]
ستون برچسب زمانی (Timestamp) را به عنوان اولین ستون خروجی نمایش می‌دهد.
این برچسب زمانی، مدت زمان سپری‌شده از زمان شروع JVM هدف است.
.TP
\f[V]-h\f[R] \f[I]n\f[R]
عنوان ستون‌ها (Header) را به ازای هر \f[I]n\f[R] نمونه (سطر خروجی) نمایش می‌دهد، که در آن
\f[I]n\f[R] یک عدد صحیح مثبت است.
مقدار پیش‌فرض \f[V]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[V]jstat\f[R] خروجی خود را در هر بازه زمانی تولید می‌کند.
.TP
\f[I]count\f[R]
تعداد نمونه‌هایی که باید نمایش داده شوند.
مقدار پیش‌فرض بی‌نهایت است، که باعث می‌شود دستور \f[V]jstat\f[R] تا زمان پایان یافتن JVM هدف یا متوقف شدن خود دستور \f[V]jstat\f[R]، آمار را نمایش دهد.
این مقدار باید یک عدد صحیح مثبت باشد.
.SH "توضیحات (DESCRIPTION)"
.PP
دستور \f[V]jstat\f[R] آمار عملکرد یک ماشین مجازی اندازه‌گیری‌شده Java HotSpot VM را نمایش می‌دهد.
ماشین مجازی جاوا (JVM) هدف توسط شناسه ماشین مجازی آن یا گزینه \f[V]vmid\f[R] مشخص می‌شود.
.PP
دستور \f[V]jstat\f[R] از دو نوع گزینه پشتیبانی می‌کند: گزینه‌های عمومی و گزینه‌های خروجی.
گزینه‌های عمومی باعث می‌شوند دستور \f[V]jstat\f[R] اطلاعات ساده راهنما و نسخه را نمایش دهد.
گزینه‌های خروجی، محتوا و قالب خروجی آماری را تعیین می‌کنند.
.PP
تمامی گزینه‌ها و عملکردهای آن‌ها ممکن است در نسخه‌های آینده تغییر کنند یا حذف شوند.
.SH "گزینه‌های عمومی (GENERAL OPTIONS)"
.PP
در صورت تعیین یکی از گزینه‌های عمومی، نمی‌توانید گزینه یا پارامتر دیگری را مشخص کنید.
.TP
\f[V]-help\f[R]
پیام راهنما را نمایش می‌دهد.
.TP
\f[V]-options\f[R]
فهرستی از گزینه‌های آماری ایستا را نمایش می‌دهد.
بخش \f[B]گزینه‌های خروجی دستور JSTAT (OUTPUT OPTIONS FOR THE JSTAT COMMAND)\f[R] را ببینید.
.SH "گزینه‌های خروجی دستور JSTAT (OUTPUT OPTIONS FOR THE JSTAT COMMAND)"
.PP
اگر گزینه عمومی را مشخص نکنید، می‌توانید گزینه‌های خروجی را تعیین نمایید.
گزینه‌های خروجی محتوا و قالب خروجی دستور \f[V]jstat\f[R] را تعیین می‌کنند و شامل یک \f[V]statOption\f[R] به همراه هر یک از گزینه‌های خروجی دیگر (\f[V]-h\f[R]، \f[V]-t\f[R] و \f[V]-J\f[R]) هستند.
گزینه \f[V]statOption\f[R] باید در ابتدا قرار گیرد.
.PP
خروجی به صورت یک جدول قالب‌بندی می‌شود که ستون‌های آن با فاصله از یکدیگر جدا شده‌اند.
سطر عنوان با برچسب‌ها ستون‌ها را توصیف می‌کند.
از گزینه \f[V]-h\f[R] برای تنظیم بسامد نمایش سطر عنوان استفاده کنید.
نام عنوان ستون‌ها در میان گزینه‌های مختلف یکدست است.
به طور کلی، اگر دو گزینه ستونی با نام یکسان ارائه دهند، منبع داده آن دو ستون یکسان است.
.PP
از گزینه \f[V]-t\f[R] برای نمایش ستون برچسب زمانی با عنوان Timestamp به عنوان اولین ستون خروجی استفاده کنید.
ستون Timestamp شامل زمان سپری‌شده بر حسب ثانیه از زمان آغاز به کار JVM هدف است.
دقت برچسب زمانی به عوامل مختلفی بستگی دارد و ممکن است به دلیل تأخیر در زمان‌بندی نخ‌ها در سیستم‌های تحت بار سنگین تغییر کند.
.PP
از پارامترهای interval و count به ترتیب برای تعیین بسامد زمانی و تعداد دفعات نمایش خروجی دستور \f[V]jstat\f[R] استفاده کنید.
.PP
\f[B]نکته:\f[R]
.PP
برای پردازش خروجی دستور \f[V]jstat\f[R] اسکریپت ننویسید زیرا ممکن است قالب آن در نسخه‌های آینده تغییر کند.
اگر اسکریپت‌هایی می‌نویسید که خروجی دستور \f[V]jstat\f[R] را پردازش می‌کنند، انتظار اصلاح آن‌ها را برای نسخه‌های بعدی این ابزار داشته باشید.
.TP
\f[V]-statOption\f[R]
اطلاعات آماری‌ای را که دستور \f[V]jstat\f[R] نمایش می‌دهد تعیین می‌کند.
فهرست زیر گزینه‌های موجود را نشان می‌دهد.
از گزینه عمومی \f[V]-options\f[R] برای نمایش فهرست گزینه‌ها در یک نصب خاص سیستم استفاده کنید.
بخش \f[B]گزینه‌ها و خروجی‌های آماری (STAT OPTIONS AND OUTPUT)\f[R] را ببینید.
.RS
.PP
\f[V]class\f[R]: آماری در مورد رفتار بارگذار کلاس (Class Loader) نمایش می‌دهد.
.PP
\f[V]compiler\f[R]: آماری درباره رفتار کامپایلر درجا (JIT) ماشین مجازی Java HotSpot نمایش می‌دهد.
.PP
\f[V]gc\f[R]: آماری درباره رفتار هیپ تحت مدیریت زباله‌روب (Garbage Collector) نمایش می‌دهد.
.PP
\f[V]gccapacity\f[R]: آماری درباره ظرفیت نسل‌ها و فضاهای متناظر آن‌ها نمایش می‌دهد.
.PP
\f[V]gccause\f[R]: خلاصه‌ای از آمار زباله‌روبی (مشابه \f[V]-gcutil\f[R]) را به همراه علت آخرین رویداد زباله‌روبی و رویداد جاری (در صورت وجود) نمایش می‌دهد.
.PP
\f[V]gcnew\f[R]: آماری درباره رفتار نسل جوان (New Generation) نمایش می‌دهد.
.PP
\f[V]gcnewcapacity\f[R]: آماری درباره اندازه‌های نسل‌های جدید و فضاهای متناظر آن‌ها نمایش می‌دهد.
.PP
\f[V]gcold\f[R]: آماری درباره رفتار نسل قدیم (Old Generation) و آمار فضای متاسپیس (Metaspace) نمایش می‌دهد.
.PP
\f[V]gcoldcapacity\f[R]: آماری درباره اندازه‌های نسل قدیم نمایش می‌دهد.
.PP
\f[V]gcmetacapacity\f[R]: آماری درباره اندازه‌های متاسپیس نمایش می‌دهد.
.PP
\f[V]gcutil\f[R]: خلاصه‌ای از آمار زباله‌روبی را نمایش می‌دهد.
.PP
\f[V]printcompilation\f[R]: آمار متدهای کامپایل‌شده Java HotSpot VM را نمایش می‌دهد.
.RE
.TP
\f[V]-J\f[R]\f[I]javaOption\f[R]
گزینه \f[I]javaOption\f[R] را به راه‌انداز برنامه جاوا ارسال می‌کند.
به عنوان مثال، \f[V]-J-Xms48m\f[R] مقدار حافظه اولیه هنگام شروع را روی ۴۸ مگابایت تنظیم می‌کند.
برای مشاهده فهرست کامل گزینه‌ها، صفحه راهنمای \f[B]java\f[R] را ببینید.
.SH "گزینه‌ها و خروجی‌های آماری (STAT OPTIONS AND OUTPUT)"
.PP
اطلاعات زیر ستون‌هایی را که دستور \f[V]jstat\f[R] برای هر \f[I]statOption\f[R] خروجی می‌دهد خلاصه می‌کند.
.TP
\f[V]-class\f[R] \f[I]option\f[R]
آمار بارگذار کلاس (Class Loader).
.RS
.PP
\f[V]Loaded\f[R]: تعداد کلاس‌های بارگذاری‌شده.
.PP
\f[V]Bytes\f[R]: حجم کیلوبایت‌های بارگذاری‌شده.
.PP
\f[V]Unloaded\f[R]: تعداد کلاس‌های تخلیه‌شده از حافظه.
.PP
\f[V]Bytes\f[R]: حجم کیلوبایت‌های تخلیه‌شده.
.PP
\f[V]Time\f[R]: زمان صرف‌شده برای انجام عملیات بارگذاری و تخلیه کلاس‌ها.
.RE
.TP
\f[V]-compiler\f[R] \f[I]option\f[R]
آمار کامپایلر درجا (JIT) ماشین مجازی Java HotSpot.
.RS
.PP
\f[V]Compiled\f[R]: تعداد وظایف کامپایل انجام‌شده.
.PP
\f[V]Failed\f[R]: تعداد وظایف کامپایل ناموفق.
.PP
\f[V]Invalid\f[R]: تعداد وظایف کامپایلی که نامعتبر شده‌اند.
.PP
\f[V]Time\f[R]: زمان صرف‌شده برای انجام وظایف کامپایل.
.PP
\f[V]FailedType\f[R]: نوع کامپایل آخرین کامپایل ناموفق.
.PP
\f[V]FailedMethod\f[R]: نام کلاس و متد آخرین کامپایل ناموفق.
.RE
.TP
\f[V]-gc\f[R] \f[I]option\f[R]
آمار هیپ تحت مدیریت زباله‌روب.
.RS
.PP
\f[V]S0C\f[R]: ظرفیت جاری فضای بازمانده ۰ (Survivor Space 0) بر حسب کیلوبایت.
.PP
\f[V]S1C\f[R]: ظرفیت جاری فضای بازمانده ۱ (Survivor Space 1) بر حسب کیلوبایت.
.PP
\f[V]S0U\f[R]: میزان استفاده از فضای بازمانده ۰ بر حسب کیلوبایت.
.PP
\f[V]S1U\f[R]: میزان استفاده از فضای بازمانده ۱ بر حسب کیلوبایت.
.PP
\f[V]EC\f[R]: ظرفیت جاری فضای ایدن (Eden Space) بر حسب کیلوبایت.
.PP
\f[V]EU\f[R]: میزان استفاده از فضای ایدن بر حسب کیلوبایت.
.PP
\f[V]OC\f[R]: ظرفیت جاری فضای قدیم (Old Space) بر حسب کیلوبایت.
.PP
\f[V]OU\f[R]: میزان استفاده از فضای قدیم بر حسب کیلوبایت.
.PP
\f[V]MC\f[R]: اندازه تخصیص‌یافته متاسپیس (Metaspace Committed Size) بر حسب کیلوبایت.
.PP
\f[V]MU\f[R]: میزان استفاده از متاسپیس بر حسب کیلوبایت.
.PP
\f[V]CCSC\f[R]: اندازه تخصیص‌یافته کلاس‌های فشرده (Compressed Class Committed Size) بر حسب کیلوبایت.
.PP
\f[V]CCSU\f[R]: فضای استفاده‌شده کلاس‌های فشرده بر حسب کیلوبایت.
.PP
\f[V]YGC\f[R]: تعداد رویدادهای زباله‌روبی نسل جوان (Young Generation GC).
.PP
\f[V]YGCT\f[R]: مدت زمان زباله‌روبی نسل جوان.
.PP
\f[V]FGC\f[R]: تعداد رویدادهای زباله‌روبی کامل (Full GC).
.PP
\f[V]FGCT\f[R]: مدت زمان زباله‌روبی کامل.
.PP
\f[V]GCT\f[R]: کل زمان صرف‌شده برای زباله‌روبی.
.RE
.TP
\f[V]-gccapacity\f[R] \f[I]option\f[R]
ظرفیت‌های نسل‌ها و فضاهای مخزن حافظه.
.RS
.PP
\f[V]NGCMN\f[R]: حداقل ظرفیت نسل جدید (KB).
.PP
\f[V]NGCMX\f[R]: حداکثر ظرفیت نسل جدید (KB).
.PP
\f[V]NGC\f[R]: ظرفیت جاری نسل جدید (KB).
.PP
\f[V]S0C\f[R]: ظرفیت جاری فضای بازمانده ۰ (KB).
.PP
\f[V]S1C\f[R]: ظرفیت جاری فضای بازمانده ۱ (KB).
.PP
\f[V]EC\f[R]: ظرفیت جاری فضای ایدن (KB).
.PP
\f[V]OGCMN\f[R]: حداقل ظرفیت نسل قدیم (KB).
.PP
\f[V]OGCMX\f[R]: حداکثر ظرفیت نسل قدیم (KB).
.PP
\f[V]OGC\f[R]: ظرفیت جاری نسل قدیم (KB).
.PP
\f[V]OC\f[R]: ظرفیت جاری فضای قدیم (KB).
.PP
\f[V]MCMN\f[R]: حداقل ظرفیت متاسپیس (KB).
.PP
\f[V]MCMX\f[R]: حداکثر ظرفیت متاسپیس (KB).
.PP
\f[V]MC\f[R]: اندازه تخصیص‌یافته متاسپیس (KB).
.PP
\f[V]CCSMN\f[R]: حداقل ظرفیت فضای کلاس‌های فشرده (KB).
.PP
\f[V]CCSMX\f[R]: حداکثر ظرفیت فضای کلاس‌های فشرده (KB).
.PP
\f[V]CCSC\f[R]: اندازه تخصیص‌یافته کلاس‌های فشرده (KB).
.PP
\f[V]YGC\f[R]: تعداد رویدادهای GC نسل جوان.
.PP
\f[V]FGC\f[R]: تعداد رویدادهای Full GC.
.RE
.TP
\f[V]-gccause\f[R] \f[I]option\f[R]
این گزینه همان خلاصه آمار زباله‌روبی گزینه \f[V]-gcutil\f[R] را نمایش می‌دهد، اما دلایل آخرین رویداد زباله‌روبی و (در صورت کاربرد) رویداد زباله‌روبی جاری را نیز در بر می‌گیرد.
علاوه بر ستون‌های فهرست‌شده برای \f[V]-gcutil\f[R]، این گزینه ستون‌های زیر را اضافه می‌کند:
.RS
.PP
\f[V]LGCC\f[R]: علت آخرین زباله‌روبی
.PP
\f[V]GCC\f[R]: علت زباله‌روبی جاری
.RE
.TP
\f[V]-gcnew\f[R] \f[I]option\f[R]
آمار نسل جدید (Young/New Generation).
.RS
.PP
\f[V]S0C\f[R]: ظرفیت جاری فضای بازمانده ۰ (KB).
.PP
\f[V]S1C\f[R]: ظرفیت جاری فضای بازمانده ۱ (KB).
.PP
\f[V]S0U\f[R]: میزان استفاده از فضای بازمانده ۰ (KB).
.PP
\f[V]S1U\f[R]: میزان استفاده از فضای بازمانده ۱ (KB).
.PP
\f[V]TT\f[R]: آستانه ارتقا به نسل قدیم (Tenuring threshold).
.PP
\f[V]MTT\f[R]: حداکثر آستانه ارتقا به نسل قدیم (Maximum tenuring threshold).
.PP
\f[V]DSS\f[R]: اندازه مطلوب فضای بازمانده (KB).
.PP
\f[V]EC\f[R]: ظرفیت جاری فضای ایدن (KB).
.PP
\f[V]EU\f[R]: میزان استفاده از فضای ایدن (KB).
.PP
\f[V]YGC\f[R]: تعداد رویدادهای GC نسل جوان.
.PP
\f[V]YGCT\f[R]: مدت زمان زباله‌روبی نسل جوان.
.RE
.TP
\f[V]-gcnewcapacity\f[R] \f[I]option\f[R]
آمار اندازه فضاهای نسل جدید.
.RS
.PP
\f[V]NGCMN\f[R]: حداقل ظرفیت نسل جدید (KB).
.PP
\f[V]NGCMX\f[R]: حداکثر ظرفیت نسل جدید (KB).
.PP
\f[V]NGC\f[R]: ظرفیت جاری نسل جدید (KB).
.PP
\f[V]S0CMX\f[R]: حداکثر ظرفیت فضای بازمانده ۰ (KB).
.PP
\f[V]S0C\f[R]: ظرفیت جاری فضای بازمانده ۰ (KB).
.PP
\f[V]S1CMX\f[R]: حداکثر ظرفیت فضای بازمانده ۱ (KB).
.PP
\f[V]S1C\f[R]: ظرفیت جاری فضای بازمانده ۱ (KB).
.PP
\f[V]ECMX\f[R]: حداکثر ظرفیت فضای ایدن (KB).
.PP
\f[V]EC\f[R]: ظرفیت جاری فضای ایدن (KB).
.PP
\f[V]YGC\f[R]: تعداد رویدادهای GC نسل جوان.
.PP
\f[V]FGC\f[R]: تعداد رویدادهای Full GC.
.RE
.TP
\f[V]-gcold\f[R] \f[I]option\f[R]
آمار اندازه نسل قدیم.
.RS
.PP
\f[V]MC\f[R]: اندازه تخصیص‌یافته متاسپیس (KB).
.PP
\f[V]MU\f[R]: میزان استفاده از متاسپیس (KB).
.PP
\f[V]CCSC\f[R]: اندازه تخصیص‌یافته کلاس‌های فشرده (KB).
.PP
\f[V]CCSU\f[R]: فضای استفاده‌شده کلاس‌های فشرده (KB).
.PP
\f[V]OC\f[R]: ظرفیت جاری فضای قدیم (KB).
.PP
\f[V]OU\f[R]: میزان استفاده از فضای قدیم (KB).
.PP
\f[V]YGC\f[R]: تعداد رویدادهای GC نسل جوان.
.PP
\f[V]FGC\f[R]: تعداد رویدادهای Full GC.
.PP
\f[V]FGCT\f[R]: مدت زمان زباله‌روبی کامل.
.PP
\f[V]GCT\f[R]: کل زمان صرف‌شده برای زباله‌روبی.
.RE
.TP
\f[V]-gcoldcapacity\f[R] \f[I]option\f[R]
آمار نسل قدیم.
.RS
.PP
\f[V]OGCMN\f[R]: حداقل ظرفیت نسل قدیم (KB).
.PP
\f[V]OGCMX\f[R]: حداکثر ظرفیت نسل قدیم (KB).
.PP
\f[V]OGC\f[R]: ظرفیت جاری نسل قدیم (KB).
.PP
\f[V]OC\f[R]: ظرفیت جاری فضای قدیم (KB).
.PP
\f[V]YGC\f[R]: تعداد رویدادهای GC نسل جوان.
.PP
\f[V]FGC\f[R]: تعداد رویدادهای Full GC.
.PP
\f[V]FGCT\f[R]: مدت زمان زباله‌روبی کامل.
.PP
\f[V]GCT\f[R]: کل زمان صرف‌شده برای زباله‌روبی.
.RE
.TP
\f[V]-gcmetacapacity\f[R] \f[I]option\f[R]
آمار اندازه متاسپیس.
.RS
.PP
\f[V]MCMN\f[R]: حداقل ظرفیت متاسپیس (KB).
.PP
\f[V]MCMX\f[R]: حداکثر ظرفیت متاسپیس (KB).
.PP
\f[V]MC\f[R]: اندازه تخصیص‌یافته متاسپیس (KB).
.PP
\f[V]CCSMN\f[R]: حداقل ظرفیت فضای کلاس‌های فشرده (KB).
.PP
\f[V]CCSMX\f[R]: حداکثر ظرفیت فضای کلاس‌های فشرده (KB).
.PP
\f[V]CCSC\f[R]: اندازه تخصیص‌یافته کلاس‌های فشرده (KB).
.PP
\f[V]YGC\f[R]: تعداد رویدادهای GC نسل جوان.
.PP
\f[V]FGC\f[R]: تعداد رویدادهای Full GC.
.PP
\f[V]FGCT\f[R]: مدت زمان زباله‌روبی کامل.
.PP
\f[V]GCT\f[R]: کل زمان صرف‌شده برای زباله‌روبی.
.RE
.TP
\f[V]-gcutil\f[R] \f[I]option\f[R]
خلاصه آمار زباله‌روبی.
.RS
.PP
\f[V]S0\f[R]: میزان استفاده از فضای بازمانده ۰ به صورت درصدی از ظرفیت جاری آن فضا.
.PP
\f[V]S1\f[R]: میزان استفاده از فضای بازمانده ۱ به صورت درصدی از ظرفیت جاری آن فضا.
.PP
\f[V]E\f[R]: میزان استفاده از فضای ایدن به صورت درصدی از ظرفیت جاری آن فضا.
.PP
\f[V]O\f[R]: میزان استفاده از فضای قدیم به صورت درصدی از ظرفیت جاری آن فضا.
.PP
\f[V]M\f[R]: میزان استفاده از متاسپیس به صورت درصدی از ظرفیت جاری آن فضا.
.PP
\f[V]CCS\f[R]: میزان استفاده از فضای کلاس‌های فشرده به صورت درصد.
.PP
\f[V]YGC\f[R]: تعداد رویدادهای GC نسل جوان.
.PP
\f[V]YGCT\f[R]: مدت زمان زباله‌روبی نسل جوان.
.PP
\f[V]FGC\f[R]: تعداد رویدادهای Full GC.
.PP
\f[V]FGCT\f[R]: مدت زمان زباله‌روبی کامل.
.PP
\f[V]GCT\f[R]: کل زمان صرف‌شده برای زباله‌روبی.
.RE
.TP
\f[V]-printcompilation\f[R] \f[I]option\f[R]
آمار متدهای کامپایلر Java HotSpot VM.
.RS
.PP
\f[V]Compiled\f[R]: تعداد وظایف کامپایل انجام‌شده توسط متدی که اخیراً کامپایل شده است.
.PP
\f[V]Size\f[R]: تعداد بایت‌های بایت‌کد متدی که اخیراً کامپایل شده است.
.PP
\f[V]Type\f[R]: نوع کامپایل متدی که اخیراً کامپایل شده است.
.PP
\f[V]Method\f[R]: نام کلاس و نام متد مشخص‌کننده متدی که اخیراً کامپایل شده است.
نام کلاس از یک اسلش (/) به جای نقطه (.) به عنوان جداکننده فضای نام استفاده می‌کند.
نام متد همان متد داخل کلاس مشخص‌شده است.
قالب این دو فیلد با گزینه \f[V]-XX:+PrintCompilation\f[R] در HotSpot یکسان است.
.RE
.SH "شناسه ماشین مجازی (VIRTUAL MACHINE IDENTIFIER)"
.PP
ساختار دستوری رشته \f[V]vmid\f[R] با ساختار دستوری یک نشانی اینترنتی (URI) مطابقت دارد:
.RS
.PP
[\f[I]protocol\f[R]\f[V]:\f[R]][\f[V]//\f[R]]\f[I]lvmid\f[R][\f[V]\[at]\f[R]\f[I]hostname\f[R][\f[V]:\f[R]\f[I]port\f[R]][\f[V]/\f[R]\f[I]servername\f[R]]
.RE
.PP
ساختار دستوری رشته \f[V]vmid\f[R] با ساختار دستوری یک URI مطابقت دارد.
رشته \f[V]vmid\f[R] می‌تواند از یک عدد صحیح ساده که نشان‌دهنده یک JVM محلی است تا ساختاری پیچیده‌تر که پروتکل ارتباطی، شماره پورت و سایر مقادیر وابسته به پیاده‌سازی را مشخص می‌کند، متغیر باشد.
.TP
\f[I]protocol\f[R]
پروتکل ارتباطی.
اگر مقدار \f[I]protocol\f[R] حذف شود و نام میزبان مشخص نشده باشد، پروتکل پیش‌فرض یک پروتکل محلی بهینه‌سازی‌شده برای پلتفرم خواهد بود.
اگر مقدار \f[I]protocol\f[R] حذف شود و نام میزبان مشخص شده باشد، پروتکل پیش‌فرض \f[V]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[V]jps\f[R] برای تعیین \f[I]lvmid\f[R] استفاده کنید، به شرطی که فرایندهای JVM در یک نمونه داکر جداگانه اجرا نشده باشند.
همچنین می‌توانید \f[I]lvmid\f[R] را در پلتفرم‌های لینوکس و macOS با دستور \f[V]ps\f[R] و در ویندوز با Windows Task Manager تعیین کنید.
.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[V]rmi\f[R]، مقدار پورت نشان‌دهنده شماره پورت \f[V]rmiregistry\f[R] در میزبان راه دور است.
اگر مقدار \f[I]port\f[R] حذف شود و مقدار \f[I]protocol\f[R] نشان‌دهنده \f[V]rmi\f[R] باشد، از پورت پیش‌فرض rmiregistry (پورت ۱۰۹۹) استفاده می‌شود.
.TP
\f[I]servername\f[R]
رفتار با پارامتر \f[I]servername\f[R] به پیاده‌سازی بستگی دارد.
برای پروتکل محلی بهینه‌شده، این فیلد نادیده گرفته می‌شود.
برای پروتکل \f[V]rmi\f[R]، این فیلد نام شیء راه دور RMI در میزبان راه دور را نشان می‌دهد.
.SH "مثال‌ها (EXAMPLES)"
.PP
این بخش مثال‌هایی از نظارت بر یک JVM محلی با \f[I]lvmid\f[R] برابر با ۲۱۸۹۱ را ارائه می‌دهد.
.SH "گزینه GCUTIL (THE GCUTIL OPTION)"
.PP
این مثال به lvmid ۲۱۸۹۱ متصل شده و ۷ نمونه با بازه‌های ۲۵۰ میلی‌ثانیه‌ای می‌گیرد و خروجی را طبق گزینه \f[V]-gcutil\f[R] نمایش می‌دهد.
.PP
خروجی این مثال نشان می‌دهد که یک زباله‌روبی نسل جوان بین نمونه سوم و چهارم رخ داده است.
این جمع‌آوری ۰٫۰۷۸ ثانیه طول کشیده و اشیاء را از فضای ایدن (E) به فضای قدیم (O) ارتقا داده است که منجر به افزایش میزان استفاده از فضای قدیم از ۶۶٫۸۰٪ به ۶۸٫۱۹٪ شده است.
پیش از جمع‌آوری، ۹۷٫۰۲٪ از فضای بازمانده استفاده شده بود، اما پس از این جمع‌آوری به ۹۱٫۰۳٪ رسیده است.
.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 ۲۱۸۹۱ متصل می‌شود و با بازه‌های ۲۵۰ میلی‌ثانیه‌ای نمونه‌برداری کرده و خروجی را طبق گزینه \f[V]-gcnew\f[R] نمایش می‌دهد.
علاوه بر این، از گزینه \f[V]-h3\f[R] برای نمایش عنوان ستون‌ها پس از هر ۳ سطر داده استفاده می‌کند.
.PP
علاوه بر نمایش تکرار رشته سرستون، این مثال نشان می‌دهد که بین نمونه دوم و سوم، یک GC نسل جوان رخ داده است.
مدت زمان آن ۰٫۰۰۱ ثانیه بوده است.
این جمع‌آوری داده‌های فعال کافی پیدا کرد به طوری که میزان استفاده از فضای بازمانده ۰ (S0U) از اندازه مطلوب فضای بازمانده (DSS) فراتر می‌رفت.
در نتیجه، اشیاء به نسل قدیم ارتقا یافتند (که در این خروجی قابل مشاهده نیست) و آستانه ارتقا به نسل قدیم (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 ۲۱۸۹۱ متصل شده و ۳ نمونه با بازه‌های ۲۵۰ میلی‌ثانیه‌ای می‌گیرد.
از گزینه \f[V]-t\f[R] برای ایجاد یک برچسب زمانی برای هر نمونه در ستون اول استفاده شده است.
.PP
ستون Timestamp زمان سپری‌شده بر حسب ثانیه از زمان شروع JVM هدف را گزارش می‌کند.
علاوه بر این، خروجی \f[V]-gcoldcapacity\f[R] نشان می‌دهد که ظرفیت نسل قدیم (OGC) و ظرفیت فضای قدیم (OC) با گسترش هیپ برای برآوردن نیازهای تخصیص یا ارتقا، افزایش می‌یابند.
ظرفیت نسل قدیم (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
این مثال با استفاده از گزینه \f[V]-gcutil\f[R] به lvmid ۴۰۴۹۶ در سیستمی با نام
\f[V]remote.domain\f[R] متصل شده و نمونه‌ها را هر ثانیه یک‌بار به صورت نامحدود ثبت می‌کند.
.PP
مقدار lvmid با نام میزبان راه دور ترکیب شده تا vmid به صورت
\f[V]40496\[at]remote.domain\f[R] ساخته شود.
این vmid منجر به استفاده از پروتکل \f[V]rmi\f[R] برای برقراری ارتباط با سرور پیش‌فرض \f[V]jstatd\f[R] در میزبان راه دور می‌شود.
سرور \f[V]jstatd\f[R] با استفاده از دستور \f[V]rmiregistry\f[R] در \f[V]remote.domain\f[R] که به پورت پیش‌فرض دستور \f[V]rmiregistry\f[R] (پورت ۱۰۹۹) متصل است، یافته می‌شود.
.IP
.nf
\f[CB]
jstat -gcutil 40496\[at]remote.domain 1000
\&... خروجی حذف شد
\f[R]
.fi