\'\" t
.\" Copyright (c) 2004, 2015, 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.
.\"
.\" Title: jstat
.\" Language: English
.\" Date: 03 March 2015
.\" SectDesc: Monitoring Tools
.\" Software: JDK 8
.\" Arch: generic
.\" Part Number: E38207-04
.\" Doc ID: JSSON
.\"
.if n .pl 99999
.TH "jstat" "1" "03 March 2015" "JDK 8" "Monitoring Tools"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "نام (NAME)"
jstat \- پایش آمار عملکرد ماشین مجازی جاوا (JVM)
.SH "خلاصه دستور (SYNOPSIS)"
.sp
.if n \{\
.RS 4
.\}
.nf
\fBjstat\fR [ \fIgeneralOption\fR | \fIoutputOptions vmid\fR [ \fIinterval\fR[s|ms] [ \fIcount \fR] ]
.fi
.if n \{\
.RE
.\}
.PP
\fIgeneralOption\fR
.RS 4
یک گزینه عمومی تکی خط فرمان
\fB\-help\fR
یا
\fB\-options\fR\&. بخش گزینه‌های عمومی را ببینید\&.
.RE
.PP
\fIoutputOptions\fR
.RS 4
یک یا چند گزینه خروجی شامل یک
\fBstatOption\fR
تکی، به همراه هر یک از گزینه‌های
\fB\-t\fR،
\fB\-h\fR و
\fB\-J\fR\&.
بخش گزینه‌های خروجی را ببینید\&.
.RE
.PP
\fIvmid\fR
.RS 4
شناسه ماشین مجازی؛ رشته‌ای که JVM هدف را مشخص می‌کند\&. نحو کلی به صورت زیر است:
.sp
.if n \{\
.RS 4
.\}
.nf
\fB[protocol:][//]lvmid[@hostname[:port]/servername]\fR
 
.fi
.if n \{\
.RE
.\}
نحو رشته
\fBvmid\fR
متناظر با نحو یک URI است\&. رشته
\fBvmid\fR
می‌تواند از یک عدد صحیح ساده که نشان‌دهنده یک JVM محلی است تا ساختار پیچیده‌تری که پروتکل ارتباطی، شماره پورت و سایر مقادیر وابسته به پیاده‌سازی را مشخص می‌کند، متغیر باشد\&. بخش شناسه ماشین مجازی را ببینید\&.
.RE
.PP
\fIinterval\fR [s|ms]
.RS 4
بازه نمونه‌برداری با واحدهای مشخص‌شده، ثانیه (s) یا میلی‌ثانیه (ms)\&. واحد پیش‌فرض میلی‌ثانیه است\&. باید یک عدد صحیح مثبت باشد\&. در صورت تعیین، دستور
\fBjstat\fR
خروجی خود را در هر بازه زمانی تولید می‌کند\&.
.RE
.PP
\fIcount\fR
.RS 4
تعداد نمونه‌هایی که باید نمایش داده شوند\&. مقدار پیش‌فرض بی‌نهایت است که باعث می‌شود دستور
\fBjstat\fR
تا زمان پایان کار JVM هدف یا متوقف شدن دستور
\fBjstat\fR،
آمار را نمایش دهد\&. این مقدار باید یک عدد صحیح مثبت باشد\&.
.RE
.SH "توضیحات (DESCRIPTION)"
.PP
دستور
\fBjstat\fR
آمار عملکرد یک ماشین مجازی Java HotSpot VM دارای ابزار دقیق (instrumented) را نمایش می‌دهد\&. JVM هدف با شناسه ماشین مجازی آن یا گزینه
\fBvmid\fR
مشخص می‌شود\&.
.SH "شناسه ماشین مجازی (VIRTUAL MACHINE IDENTIFIER)"
.PP
نحو رشته
\fBvmid\fR
با نحو یک URI مطابقت دارد:
.sp
.if n \{\
.RS 4
.\}
.nf
\fB[protocol:][//]lvmid[@hostname[:port]/servername]\fR
 
.fi
.if n \{\
.RE
.\}
.PP
\fIprotocol\fR
.RS 4
پروتکل ارتباطی\&. اگر مقدار
\fIprotocol\fR
حذف شود و نام میزبان مشخص نشده باشد، پروتکل پیش‌فرض یک پروتکل محلی بهینه‌سازی‌شده و وابسته به پلتفرم است\&. اگر مقدار
\fIprotocol\fR
حذف شود و یک نام میزبان مشخص شده باشد، پروتکل پیش‌فرض
\fBrmi\fR
خواهد بود\&.
.RE
.PP
\fIlvmid\fR
.RS 4
شناسه محلی ماشین مجازی برای JVM هدف\&. مقدار
\fBlvmid\fR
یک مقدار وابسته به پلتفرم است که یک JVM را به‌طور یکتا روی سیستم مشخص می‌کند\&.
\fBlvmid\fR
تنها مؤلفه الزامی یک شناسه ماشین مجازی است\&.
\fBlvmid\fR
معمولاً، اما نه لزوماً، همان شناسه فرآیند (PID) سیستم‌عامل برای فرآیند JVM هدف است\&. می‌توانید از دستور
\fBjps\fR
برای تعیین
\fBlvmid\fR
استفاده کنید\&. همچنین، می‌توانید
\fBlvmid\fR
را در پلتفرم‌های Solaris، لینوکس و OS X با دستور
\fBps\fR
و در ویندوز با Windows Task Manager تعیین کنید\&.
.RE
.PP
\fIhostname\fR
.RS 4
نام میزبان یا نشانی IP که میزبان هدف را مشخص می‌کند\&. اگر مقدار
\fIhostname\fR
حذف شود، میزبان هدف همان میزبان محلی است\&.
.RE
.PP
\fIport\fR
.RS 4
پورت پیش‌فرض برای برقراری ارتباط با سرور راه دور\&. اگر مقدار
\fIhostname\fR
حذف شود یا مقدار
\fIprotocol\fR
یک پروتکل محلی و بهینه‌شده را مشخص کند، مقدار
\fIport\fR
نادیده گرفته می‌شود\&. در غیر این صورت، نحوه مدیریت پارامتر
\fBport\fR
وابسته به پیاده‌سازی است\&. برای پروتکل پیش‌فرض
\fBrmi\fR،
مقدار پورت نشان‌دهنده شماره پورت برای rmiregistry روی میزبان راه دور است\&. اگر مقدار
\fIport\fR
حذف شود و مقدار
\fIprotocol\fR
بیانگر
\fBrmi\fR
باشد، پورت پیش‌فرض rmiregistry (۱۰۹۹) استفاده می‌شود\&.
.RE
.PP
\fIservername\fR
.RS 4
مدیریت پارامتر
\fBservername\fR
بستگی به پیاده‌سازی دارد\&. برای پروتکل محلی بهینه‌شده، این فیلد نادیده گرفته می‌شود\&. برای پروتکل
\fBrmi\fR،
این مقدار نمایانگر نام شیء راه دور RMI در میزبان از راه دور است\&.
.RE
.SH "گزینه‌ها (OPTIONS)"
.PP
دستور
\fBjstat\fR
از دو نوع گزینه پشتیبانی می‌کند: گزینه‌های عمومی و گزینه‌های خروجی\&. گزینه‌های عمومی باعث می‌شوند دستور
\fBjstat\fR
اطلاعات ساده مربوط به نحوه استفاده و نسخه را نمایش دهد\&. گزینه‌های خروجی، محتوا و قالب خروجی آماری را تعیین می‌کنند\&.
.PP
تمامی گزینه‌ها و عملکردهای آن‌ها ممکن است در نسخه‌های آینده تغییر کرده یا حذف شوند\&.
.SS "گزینه‌های عمومی (General Options)"
.PP
اگر یکی از گزینه‌های عمومی را مشخص کنید، نمی‌توانید گزینه یا پارامتر دیگری را تعیین کنید\&.
.PP
\-help
.RS 4
پیام راهنما را نمایش می‌دهد\&.
.RE
.PP
\-options
.RS 4
فهرستی از گزینه‌های آماری را نمایش می‌دهد\&. بخش گزینه‌های خروجی را ببینید\&.
.RE
.SS "گزینه‌های خروجی (Output Options)"
.PP
اگر گزینه عمومی را مشخص نکنید، می‌توانید گزینه‌های خروجی را تعیین کنید\&. گزینه‌های خروجی محتوا و قالب خروجی دستور
\fBjstat\fR
را تعیین کرده و شامل یک
\fBstatOption\fR
تکی، به همراه هر یک از گزینه‌های خروجی دیگر (\fB\-h\fR،
\fB\-t\fR و
\fB\-J\fR) هستند\&. گزینه
\fBstatOption\fR
باید در ابتدا بیاید\&.
.PP
خروجی به صورت یک جدول قالب‌بندی می‌شود که ستون‌های آن با فاصله از هم جدا شده‌اند\&. یک سطر عنوان با عناوین توصیف‌کننده ستون‌ها نمایش داده می‌شود\&. از گزینه
\fB\-h\fR
برای تعیین تواتر نمایش عنوان ستون‌ها استفاده کنید\&. نام عناوین ستون‌ها در بین گزینه‌های مختلف یکپارچه و سازگار است\&. به طور کلی، اگر دو گزینه ستونی با نام یکسان ارائه دهند، منبع داده آن دو ستون یکسان است\&.
.PP
از گزینه
\fB\-t\fR
برای نمایش یک ستون برچسب زمانی با عنوان Timestamp به عنوان اولین ستون خروجی استفاده کنید\&. ستون Timestamp شامل زمان سپری‌شده (به ثانیه) از زمان شروع JVM هدف است\&. دقت برچسب زمانی به عوامل مختلفی بستگی دارد و ممکن است به دلیل تأخیر در زمان‌بندی نخ‌ها در سیستم‌های با بار سنگین دچار تغییر شود\&.
.PP
از پارامترهای interval و count برای تعیین به ترتیب بسامد و تعداد دفعات نمایش خروجی توسط دستور
\fBjstat\fR
استفاده کنید\&.
.PP
\fBنکته:\fR
برای تجزیه خروجی دستور
\fBjstat\fR
اسکریپت ننویسید، زیرا ممکن است فرمت آن در نسخه‌های بعدی تغییر کند\&. اگر اسکریپت‌هایی برای تجزیه خروجی دستور
\fBjstat\fR
می‌نویسید، انتظار داشته باشید که برای نسخه‌های بعدی این ابزار نیاز به اصلاح داشته باشند\&.
.PP
\-\fIstatOption\fR
.RS 4
اطلاعات آماری را که دستور
\fBjstat\fR
نمایش می‌دهد تعیین می‌کند\&. فهرست زیر گزینه‌های موجود را نشان می‌دهد\&. برای نمایش فهرست گزینه‌ها برای یک نصب خاص از پلتفرم، از گزینه عمومی
\fB\-options\fR
استفاده کنید\&. بخش گزینه‌ها و خروجی‌های آماری را ببینید\&.
.sp
\fBclass\fR: آماری درباره رفتار بارگذار کلاس (Class Loader) نمایش می‌دهد\&.
.sp
\fBcompiler\fR: آماری درباره رفتار کامپایلر درجا (JIT) در Java HotSpot VM نمایش می‌دهد\&.
.sp
\fBgc\fR: آماری درباره رفتار هیپ تحت مدیریت زباله‌روب نمایش می‌دهد\&.
.sp
\fBgccapacity\fR: آماری درباره ظرفیت نسل‌ها و فضاهای متناظر آن‌ها نمایش می‌دهد\&.
.sp
\fBgccause\fR: خلاصه‌ای از آمار جمع‌آوری زباله را (مشابه
\fB\-gcutil\fR) به همراه علت آخرین رویداد جمع‌آوری زباله و رویداد جاری (در صورت وجود) نمایش می‌دهد\&.
.sp
\fBgcnew\fR: آماری از رفتار نسل جوان (New Generation) را نمایش می‌دهد\&.
.sp
\fBgcnewcapacity\fR: آماری درباره اندازه‌های نسل‌های جدید و فضاهای متناظر آن نمایش می‌دهد\&.
.sp
\fBgcold\fR: آماری درباره رفتار نسل قدیمی (Old Generation) و آمار متاسپیس (Metaspace) نمایش می‌دهد\&.
.sp
\fBgcoldcapacity\fR: آماری درباره اندازه‌های نسل قدیمی نمایش می‌دهد\&.
.sp
\fBgcmetacapacity\fR: آماری درباره اندازه‌های متاسپیس نمایش می‌دهد\&.
.sp
\fBgcutil\fR: خلاصه‌ای از آمار جمع‌آوری زباله را نمایش می‌دهد\&.
.sp
\fBprintcompilation\fR: آمار متدهای کامپایل‌شده توسط Java HotSpot VM را نمایش می‌دهد\&.
.RE
.PP
\-h \fIn\fR
.RS 4
عناوین ستون‌ها را به ازای هر
\fIn\fR
نمونه (سطرهای خروجی) نمایش می‌دهد، که در آن
\fIn\fR
یک عدد صحیح مثبت است\&. مقدار پیش‌فرض ۰ است که عناوین ستون‌ها را فقط برای نخستین سطر داده‌ها نمایش می‌دهد\&.
.RE
.PP
\-t
.RS 4
یک ستون برچسب زمانی را به عنوان اولین ستون خروجی نمایش می‌دهد\&. این برچسب زمانی، زمان سپری‌شده از لحظه شروع JVM هدف است\&.
.RE
.PP
\-J\fIjavaOption\fR
.RS 4
گزینه
\fBjavaOption\fR
را به اجراکننده برنامه جاوا ارسال می‌کند\&. برای نمونه،
\fB\-J\-Xms48m\fR
حافظه راه‌اندازی را روی ۴۸ مگابایت تنظیم می‌کند\&. برای فهرست کامل گزینه‌ها، راهنمای
java(1)\&.
را ببینید\&.
.RE
.SS "گزینه‌ها و خروجی‌های آماری (Stat Options and Output)"
.PP
اطلاعات زیر ستون‌هایی را که دستور
\fBjstat\fR
برای هر
\fIstatOption\fR
خروجی می‌دهد خلاصه می‌کند\&.
.PP
\-class \fIoption\fR
.RS 4
آمار بارگذار کلاس\&.
.sp
\fBLoaded\fR: تعداد کلاس‌های بارگذاری‌شده\&.
.sp
\fBBytes\fR: تعداد کیلوبایت‌های بارگذاری‌شده\&.
.sp
\fBUnloaded\fR: تعداد کلاس‌های تخلیه‌شده\&.
.sp
\fBBytes\fR: تعداد کیلوبایت‌های تخلیه‌شده\&.
.sp
\fBTime\fR: زمان صرف‌شده برای انجام عملیات بارگذاری و تخلیه کلاس‌ها\&.
.RE
.PP
\-compiler \fIoption\fR
.RS 4
آمار کامپایلر درجا (JIT) در Java HotSpot VM\&.
.sp
\fBCompiled\fR: تعداد وظایف کامپایل انجام‌شده\&.
.sp
\fBFailed\fR: تعداد وظایف کامپایل شکست‌خورده\&.
.sp
\fBInvalid\fR: تعداد وظایف کامپایلی که نامعتبر شده‌اند\&.
.sp
\fBTime\fR: زمان صرف‌شده برای انجام وظایف کامپایل\&.
.sp
\fBFailedType\fR: نوع کامپایل آخرین کامپایل ناموفق\&.
.sp
\fBFailedMethod\fR: نام کلاس و متد آخرین کامپایل ناموفق\&.
.RE
.PP
\-gc \fIoption\fR
.RS 4
آمار هیپ جمع‌آوری زباله\&.
.sp
\fBS0C\fR: ظرفیت فعلی فضای بازمانده ۰ (Survivor Space 0) بر حسب کیلوبایت\&.
.sp
\fBS1C\fR: ظرفیت فعلی فضای بازمانده ۱ بر حسب کیلوبایت\&.
.sp
\fBS0U\fR: میزان استفاده از فضای بازمانده ۰ بر حسب کیلوبایت\&.
.sp
\fBS1U\fR: میزان استفاده از فضای بازمانده ۱ بر حسب کیلوبایت\&.
.sp
\fBEC\fR: ظرفیت فعلی فضای ایدن (Eden Space) بر حسب کیلوبایت\&.
.sp
\fBEU\fR: میزان استفاده از فضای ایدن بر حسب کیلوبایت\&.
.sp
\fBOC\fR: ظرفیت فعلی فضای قدیمی (Old Space) بر حسب کیلوبایت\&.
.sp
\fBOU\fR: میزان استفاده از فضای قدیمی بر حسب کیلوبایت\&.
.sp
\fBMC\fR: ظرفیت متاسپیس (Metaspace) بر حسب کیلوبایت\&.
.sp
\fBMU\fR: میزان استفاده از متاسپیس بر حسب کیلوبایت\&.
.sp
\fBCCSC\fR: ظرفیت فضای کلاس فشرده (Compressed Class Space) بر حسب کیلوبایت\&.
.sp
\fBCCSU\fR: فضای کلاس فشرده استفاده‌شده بر حسب کیلوبایت\&.
.sp
\fBYGC\fR: تعداد رویدادهای جمع‌آوری زباله نسل جوان\&.
.sp
\fBYGCT\fR: زمان جمع‌آوری زباله نسل جوان\&.
.sp
\fBFGC\fR: تعداد رویدادهای GC کامل (Full GC)\&.
.sp
\fBFGCT\fR: زمان جمع‌آوری زباله کامل\&.
.sp
\fBGCT\fR: مجموع زمان جمع‌آوری زباله\&.
.RE
.PP
\-gccapacity \fIoption\fR
.RS 4
ظرفیت‌های نسل‌ها و فضاهای استخر حافظه\&.
.sp
\fBNGCMN\fR: حداقل ظرفیت نسل جدید بر حسب کیلوبایت\&.
.sp
\fBNGCMX\fR: حداکثر ظرفیت نسل جدید بر حسب کیلوبایت\&.
.sp
\fBNGC\fR: ظرفیت فعلی نسل جدید بر حسب کیلوبایت\&.
.sp
\fBS0C\fR: ظرفیت فعلی فضای بازمانده ۰ بر حسب کیلوبایت\&.
.sp
\fBS1C\fR: ظرفیت فعلی فضای بازمانده ۱ بر حسب کیلوبایت\&.
.sp
\fBEC\fR: ظرفیت فعلی فضای ایدن بر حسب کیلوبایت\&.
.sp
\fBOGCMN\fR: حداقل ظرفیت نسل قدیمی بر حسب کیلوبایت\&.
.sp
\fBOGCMX\fR: حداکثر ظرفیت نسل قدیمی بر حسب کیلوبایت\&.
.sp
\fBOGC\fR: ظرفیت فعلی نسل قدیمی بر حسب کیلوبایت\&.
.sp
\fBOC\fR: ظرفیت فعلی فضای قدیمی بر حسب کیلوبایت\&.
.sp
\fBMCMN\fR: حداقل ظرفیت متاسپیس بر حسب کیلوبایت\&.
.sp
\fBMCMX\fR: حداکثر ظرفیت متاسپیس بر حسب کیلوبایت\&.
.sp
\fBMC\fR: ظرفیت متاسپیس بر حسب کیلوبایت\&.
.sp
\fBCCSMN\fR: حداقل ظرفیت فضای کلاس فشرده بر حسب کیلوبایت\&.
.sp
\fBCCSMX\fR: حداکثر ظرفیت فضای کلاس فشرده بر حسب کیلوبایت\&.
.sp
\fBCCSC\fR: ظرفیت فضای کلاس فشرده بر حسب کیلوبایت\&.
.sp
\fBYGC\fR: تعداد رویدادهای GC نسل جوان\&.
.sp
\fBFGC\fR: تعداد رویدادهای GC کامل\&.
.RE
.PP
\-gccause \fIoption\fR
.RS 4
این گزینه همان خلاصه آمار جمع‌آوری زباله گزینه
\fB\-gcutil\fR
را نمایش می‌دهد، اما علل آخرین رویداد جمع‌آوری زباله و رویداد جاری (در صورت وجود) را نیز در بر می‌گیرد\&. علاوه بر ستون‌های فهرست‌شده برای
\fB\-gcutil\fR، این گزینه ستون‌های زیر را می‌افزاید\&.
.sp
\fBLGCC\fR: علت آخرین جمع‌آوری زباله
.sp
\fBGCC\fR: علت جمع‌آوری زباله فعلی
.RE
.PP
\-gcnew \fIoption\fR
.RS 4
آمار نسل جدید\&.
.sp
\fBS0C\fR: ظرفیت فعلی فضای بازمانده ۰ بر حسب کیلوبایت\&.
.sp
\fBS1C\fR: ظرفیت فعلی فضای بازمانده ۱ بر حسب کیلوبایت\&.
.sp
\fBS0U\fR: میزان استفاده از فضای بازمانده ۰ بر حسب کیلوبایت\&.
.sp
\fBS1U\fR: میزان استفاده از فضای بازمانده ۱ بر حسب کیلوبایت\&.
.sp
\fBTT\fR: آستانه ماندگاری (Tenuring Threshold)\&.
.sp
\fBMTT\fR: حداکثر آستانه ماندگاری\&.
.sp
\fBDSS\fR: اندازه مطلوب بازمانده (بر حسب کیلوبایت)\&.
.sp
\fBEC\fR: ظرفیت فعلی فضای ایدن بر حسب کیلوبایت\&.
.sp
\fBEU\fR: میزان استفاده از فضای ایدن بر حسب کیلوبایت\&.
.sp
\fBYGC\fR: تعداد رویدادهای GC نسل جوان\&.
.sp
\fBYGCT\fR: زمان جمع‌آوری زباله نسل جوان\&.
.RE
.PP
\-gcnewcapacity \fIoption\fR
.RS 4
آمار اندازه فضای نسل جدید\&.
.sp
\fBNGCMN\fR: حداقل ظرفیت نسل جدید بر حسب کیلوبایت\&.
.sp
\fBNGCMX\fR: حداکثر ظرفیت نسل جدید بر حسب کیلوبایت\&.
.sp
\fBNGC\fR: ظرفیت فعلی نسل جدید بر حسب کیلوبایت\&.
.sp
\fBS0CMX\fR: حداکثر ظرفیت فضای بازمانده ۰ بر حسب کیلوبایت\&.
.sp
\fBS0C\fR: ظرفیت فعلی فضای بازمانده ۰ بر حسب کیلوبایت\&.
.sp
\fBS1CMX\fR: حداکثر ظرفیت فضای بازمانده ۱ بر حسب کیلوبایت\&.
.sp
\fBS1C\fR: ظرفیت فعلی فضای بازمانده ۱ بر حسب کیلوبایت\&.
.sp
\fBECMX\fR: حداکثر ظرفیت فضای ایدن بر حسب کیلوبایت\&.
.sp
\fBEC\fR: ظرفیت فعلی فضای ایدن بر حسب کیلوبایت\&.
.sp
\fBYGC\fR: تعداد رویدادهای GC نسل جوان\&.
.sp
\fBFGC\fR: تعداد رویدادهای GC کامل\&.
.RE
.PP
\-gcold \fIoption\fR
.RS 4
آمار رفتار نسل قدیمی و متاسپیس\&.
.sp
\fBMC\fR: ظرفیت متاسپیس بر حسب کیلوبایت\&.
.sp
\fBMU\fR: میزان استفاده از متاسپیس بر حسب کیلوبایت\&.
.sp
\fBCCSC\fR: ظرفیت فضای کلاس فشرده بر حسب کیلوبایت\&.
.sp
\fBCCSU\fR: فضای کلاس فشرده استفاده‌شده بر حسب کیلوبایت\&.
.sp
\fBOC\fR: ظرفیت فعلی فضای قدیمی بر حسب کیلوبایت\&.
.sp
\fBOU\fR: میزان استفاده از فضای قدیمی بر حسب کیلوبایت\&.
.sp
\fBYGC\fR: تعداد رویدادهای GC نسل جوان\&.
.sp
\fBFGC\fR: تعداد رویدادهای GC کامل\&.
.sp
\fBFGCT\fR: زمان جمع‌آوری زباله کامل\&.
.sp
\fBGCT\fR: مجموع زمان جمع‌آوری زباله\&.
.RE
.PP
\-gcoldcapacity \fIoption\fR
.RS 4
آمار اندازه نسل قدیمی\&.
.sp
\fBOGCMN\fR: حداقل ظرفیت نسل قدیمی بر حسب کیلوبایت\&.
.sp
\fBOGCMX\fR: حداکثر ظرفیت نسل قدیمی بر حسب کیلوبایت\&.
.sp
\fBOGC\fR: ظرفیت فعلی نسل قدیمی بر حسب کیلوبایت\&.
.sp
\fBOC\fR: ظرفیت فعلی فضای قدیمی بر حسب کیلوبایت\&.
.sp
\fBYGC\fR: تعداد رویدادهای GC نسل جوان\&.
.sp
\fBFGC\fR: تعداد رویدادهای GC کامل\&.
.sp
\fBFGCT\fR: زمان جمع‌آوری زباله کامل\&.
.sp
\fBGCT\fR: مجموع زمان جمع‌آوری زباله\&.
.RE
.PP
\-gcmetacapacity \fIoption\fR
.RS 4
آمار اندازه متاسپیس\&.
.sp
\fBMCMN\fR: حداقل ظرفیت متاسپیس بر حسب کیلوبایت\&.
.sp
\fBMCMX\fR: حداکثر ظرفیت متاسپیس بر حسب کیلوبایت\&.
.sp
\fBMC\fR: ظرفیت متاسپیس بر حسب کیلوبایت\&.
.sp
\fBCCSMN\fR: حداقل ظرفیت فضای کلاس فشرده بر حسب کیلوبایت\&.
.sp
\fBCCSMX\fR: حداکثر ظرفیت فضای کلاس فشرده بر حسب کیلوبایت\&.
.sp
\fBYGC\fR: تعداد رویدادهای GC نسل جوان\&.
.sp
\fBFGC\fR: تعداد رویدادهای GC کامل\&.
.sp
\fBFGCT\fR: زمان جمع‌آوری زباله کامل\&.
.sp
\fBGCT\fR: مجموع زمان جمع‌آوری زباله\&.
.RE
.PP
\-gcutil \fIoption\fR
.RS 4
خلاصه آمار جمع‌آوری زباله\&.
.sp
\fBS0\fR: میزان استفاده از فضای بازمانده ۰ به صورت درصدی از ظرفیت فعلی آن فضا\&.
.sp
\fBS1\fR: میزان استفاده از فضای بازمانده ۱ به صورت درصدی از ظرفیت فعلی آن فضا\&.
.sp
\fBE\fR: میزان استفاده از فضای ایدن به صورت درصدی از ظرفیت فعلی آن فضا\&.
.sp
\fBO\fR: میزان استفاده از فضای قدیمی به صورت درصدی از ظرفیت فعلی آن فضا\&.
.sp
\fBM\fR: میزان استفاده از متاسپیس به صورت درصدی از ظرفیت فعلی آن فضا\&.
.sp
\fBCCS\fR: میزان استفاده از فضای کلاس فشرده به درصد\&.
.sp
\fBYGC\fR: تعداد رویدادهای GC نسل جوان\&.
.sp
\fBYGCT\fR: زمان جمع‌آوری زباله نسل جوان\&.
.sp
\fBFGC\fR: تعداد رویدادهای GC کامل\&.
.sp
\fBFGCT\fR: زمان جمع‌آوری زباله کامل\&.
.sp
\fBGCT\fR: مجموع زمان جمع‌آوری زباله\&.
.RE
.PP
\-printcompilation \fIoption\fR
.RS 4
آمار متدهای کامپایلر در Java HotSpot VM\&.
.sp
\fBCompiled\fR: تعداد وظایف کامپایل انجام‌شده توسط جدیدترین متد کامپایل‌شده\&.
.sp
\fBSize\fR: تعداد بایت‌های بایت‌کد جدیدترین متد کامپایل‌شده\&.
.sp
\fBType\fR: نوع کامپایل جدیدترین متد کامپایل‌شده\&.
.sp
\fBMethod\fR: نام کلاس و نام متد مشخص‌کننده جدیدترین متد کامپایل‌شده\&. نام کلاس به‌جای نقطه (\&.) از اسلش (/) به عنوان جداکننده فضای نام استفاده می‌کند\&. نام متد، متد درون کلاس مشخص‌شده است\&. قالب این دو فیلد با گزینه
\fB\-XX:+PrintCompilation\fR
در HotSpot مطابقت دارد\&.
.RE
.SH "مثال‌ها (EXAMPLES)"
.PP
این بخش مثال‌هایی از نظارت بر یک JVM محلی با
\fIlvmid\fR
برابر ۲۱۸۹۱ را ارائه می‌دهد\&.
.SS "گزینه gcutil"
.PP
این مثال به lvmid برابر با ۲۱۸۹۱ متصل شده و ۷ نمونه در بازه‌های زمانی ۲۵۰ میلی‌ثانیه‌ای می‌گیرد و خروجی را همان‌طور که توسط گزینه \-\fBgcutil\fR
تعیین شده نمایش می‌دهد\&.
.PP
خروجی این مثال نشان می‌دهد که یک جمع‌آوری نسل جوان بین نمونه‌های سوم و چهارم رخ داده است\&. این جمع‌آوری ۰\&.۰۷۸ ثانیه طول کشید و اشیاء را از فضای ایدن (E) به فضای قدیمی (O) ارتقا داد، که منجر به افزایش میزان استفاده از فضای قدیمی از ۶۶\&.۸۰٪ به ۶۸\&.۱۹٪ شد\&. پیش از جمع‌آوری، ۹۷\&.۰۲٪ از فضای بازمانده مورد استفاده بود، اما پس از این جمع‌آوری ۹۱\&.۰۳٪ آن مورد استفاده است\&.
.sp
.if n \{\
.RS 4
.\}
.nf
\fBjstat \-gcutil 21891 250 7\fR
\fB  S0     S1     E      O      M     CCS    YGC     YGCT    FGC    FGCT     GCT   \fR
\fB  0\&.00  97\&.02  70\&.31  66\&.80  95\&.52  89\&.14      7    0\&.300     0    0\&.000    0\&.300\fR
\fB  0\&.00  97\&.02  86\&.23  66\&.80  95\&.52  89\&.14      7    0\&.300     0    0\&.000    0\&.300\fR
\fB  0\&.00  97\&.02  96\&.53  66\&.80  95\&.52  89\&.14      7    0\&.300     0    0\&.000    0\&.300\fR
\fB 91\&.03   0\&.00   1\&.98  68\&.19  95\&.89  91\&.24      8    0\&.378     0    0\&.000    0\&.378\fR
\fB 91\&.03   0\&.00  15\&.82  68\&.19  95\&.89  91\&.24      8    0\&.378     0    0\&.000    0\&.378\fR
\fB 91\&.03   0\&.00  17\&.80  68\&.19  95\&.89  91\&.24      8    0\&.378     0    0\&.000    0\&.378\fR
\fB 91\&.03   0\&.00  17\&.80  68\&.19  95\&.89  91\&.24      8    0\&.378     0    0\&.000    0\&.378\fR
.fi
.if n \{\
.RE
.\}
.SS "تکرار رشته عنوان ستون‌ها"
.PP
این مثال به lvmid برابر با ۲۱۸۹۱ متصل شده و نمونه‌هایی را در بازه‌های زمانی ۲۵۰ میلی‌ثانیه‌ای می‌گیرد و خروجی را مطابق گزینه
\fB\-gcnew\fR
نمایش می‌دهد\&. علاوه بر این، از گزینه
\fB\-h3\fR
برای نمایش عنوان ستون‌ها پس از هر ۳ سطر داده استفاده می‌کند\&.
.PP
این مثال علاوه بر نمایش تکرار رشته عناوین، نشان می‌دهد که بین نمونه‌های دوم و سوم، یک GC نسل جوان رخ داده است\&. مدت زمان آن ۰\&.۰۰۱ ثانیه بود\&. این جمع‌آوری داده‌های فعال کافی پیدا کرد به طوری که میزان استفاده از فضای بازمانده ۰ (S0U) از اندازه مطلوب بازمانده (DSS) فراتر می‌رفت\&. در نتیجه، اشیاء به نسل قدیمی ارتقا یافتند (که در این خروجی قابل مشاهده نیست) و آستانه ماندگاری (TT) از ۳۱ به ۲ کاهش یافت\&.
.PP
جمع‌آوری دیگری بین نمونه‌های پنجم و ششم رخ می‌دهد\&. این جمع‌آوری بازماندگان بسیار اندکی پیدا کرد و آستانه ماندگاری را به ۳۱ بازگرداند\&.
.sp
.if n \{\
.RS 4
.\}
.nf
\fBjstat \-gcnew \-h3 21891 250\fR
\fB S0C    S1C    S0U    S1U   TT MTT  DSS      EC       EU     YGC     YGCT\fR
\fB  64\&.0   64\&.0    0\&.0   31\&.7 31  31   32\&.0    512\&.0    178\&.6    249    0\&.203\fR
\fB  64\&.0   64\&.0    0\&.0   31\&.7 31  31   32\&.0    512\&.0    355\&.5    249    0\&.203\fR
\fB  64\&.0   64\&.0   35\&.4    0\&.0  2  31   32\&.0    512\&.0     21\&.9    250    0\&.204\fR
\fB S0C    S1C    S0U    S1U   TT MTT  DSS      EC       EU     YGC     YGCT\fR
\fB  64\&.0   64\&.0   35\&.4    0\&.0  2  31   32\&.0    512\&.0    245\&.9    250    0\&.204\fR
\fB  64\&.0   64\&.0   35\&.4    0\&.0  2  31   32\&.0    512\&.0    421\&.1    250    0\&.204\fR
\fB  64\&.0   64\&.0    0\&.0   19\&.0 31  31   32\&.0    512\&.0     84\&.4    251    0\&.204\fR
\fB S0C    S1C    S0U    S1U   TT MTT  DSS      EC       EU     YGC     YGCT\fR
\fB  64\&.0   64\&.0    0\&.0   19\&.0 31  31   32\&.0    512\&.0    306\&.7    251    0\&.204\fR
 
.fi
.if n \{\
.RE
.\}
.SS "گنجاندن برچسب زمانی برای هر نمونه"
.PP
این مثال به lvmid برابر با ۲۱۸۹۱ متصل شده و ۳ نمونه در بازه‌های زمانی ۲۵۰ میلی‌ثانیه‌ای می‌گیرد\&. گزینه
\fB\-t\fR
برای تولید یک برچسب زمانی برای هر نمونه در ستون اول استفاده می‌شود\&.
.PP
ستون Timestamp زمان سپری‌شده به ثانیه را از زمان شروع JVM هدف گزارش می‌کند\&. علاوه بر این، خروجی
\fB\-gcoldcapacity\fR
نشان می‌دهد که با گسترش هیپ برای پاسخگویی به تقاضاهای تخصیص یا ارتقا، ظرفیت نسل قدیمی (OGC) و ظرفیت فضای قدیمی (OC) افزایش می‌یابند\&. ظرفیت نسل قدیمی (OGC) پس از هشتاد و یکمین جمع‌آوری کامل زباله (FGC) از ۱۱٬۶۹۶ کیلوبایت به ۱۳٬۸۲۰ کیلوبایت افزایش یافته است\&. حداکثر ظرفیت این نسل (و فضا) ۶۰٬۵۴۴ کیلوبایت (OGCMX) است، بنابراین هنوز فضا برای گسترش دارد\&.
.sp
.if n \{\
.RS 4
.\}
.nf
\fBTimestamp      OGCMN    OGCMX     OGC       OC       YGC   FGC    FGCT    GCT\fR
\fB          150\&.1   1408\&.0  60544\&.0  11696\&.0  11696\&.0   194    80    2\&.874   3\&.799\fR
\fB          150\&.4   1408\&.0  60544\&.0  13820\&.0  13820\&.0   194    81    2\&.938   3\&.863\fR
\fB          150\&.7   1408\&.0  60544\&.0  13820\&.0  13820\&.0   194    81    2\&.938   3\&.863\fR
 
.fi
.if n \{\
.RE
.\}
.SS "پایش سنجه‌های عملکردی برای JVM از راه دور"
.PP
این مثال با استفاده از گزینه
\fB\-gcutil\fR
به lvmid برابر با ۴۰۴۹۶ بر روی سیستمی به نام remote\&.domain متصل می‌شود و هر ثانیه به طور نامحدود نمونه‌برداری می‌کند\&.
.PP
مقدار lvmid با نام میزبان از راه دور ترکیب می‌شود تا یک
\fIvmid\fR
به صورت
\fB40496@remote\&.domain\fR
بسازد\&. این vmid منجر به استفاده از پروتکل
\fBrmi\fR
برای برقراری ارتباط با سرور پیش‌فرض
\fBjstatd\fR
در میزبان راه دور می‌شود\&. سرور
\fBjstatd\fR
با استفاده از دستور
\fBrmiregistry\fR
در
\fBremote\&.domain\fR
که به پورت پیش‌فرض دستور
\fBrmiregistry\fR
(پورت ۱۰۹۹) متصل است، مکان‌یابی می‌شود\&.
.sp
.if n \{\
.RS 4
.\}
.nf
\fBjstat \-gcutil 40496@remote\&.domain 1000\fR
\fB\fI\&.\&.\&. output omitted\fR\fR
 
.fi
.if n \{\
.RE
.\}
.SH "همچنین ببینید (SEE ALSO)"
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
java(1)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
jps(1)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
jstatd(1)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
rmiregistry(1)
.RE
.br
\'pl 8.5i
\'bp