'\" 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\&. بخش «گزینه‌های عمومی» (General Options) را ببینید\&.
.RE
.PP
\fIoutputOptions\fR
.RS 4
یک یا چند گزینه خروجی که شامل یک
\fBstatOption\fR
تک، به همراه هر یک از گزینه‌های
\fB\-t\fR،
\fB\-h\fR
و
\fB\-J\fR
است\&. بخش «گزینه‌های خروجی» (Output Options) را ببینید\&.
.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 محلی است تا ساختاری پیچیده‌تر که یک پروتکل ارتباطی، شماره پورت و سایر مقادیر وابسته به پیاده‌سازی را مشخص می‌کند، متغیر باشد\&. بخش «شناسه ماشین مجازی» (Virtual Machine Identifier) را ببینید\&.
.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، Linux و OS X با دستور
\fBps\fR،
و در Windows با 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 (یعنی 1099) استفاده می‌شود\&.
.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 مقصد است\&. دقت تفکیک برچسب زمان به عوامل گوناگونی بستگی دارد و ممکن است به دلیل تأخیر در زمان‌بندی ریسه‌ها (thread scheduling) در سیستم‌های دارای بار کاری سنگین دچار نوسان شود\&.
.PP
از پارامترهای interval و count به‌ترتیب برای تعیین بسامد (نرخ تکرار) و تعداد دفعاتی که دستور
\fBjstat\fR
خروجی خود را نمایش می‌دهد استفاده کنید\&.
.PP
\fBنکته:\fR
برای تجزیه (parse) خروجی دستور
\fBjstat\fR
اسکریپت ننویسید، زیرا قالب آن ممکن است در نگارش‌های آینده تغییر کند\&. اگر اسکریپت‌هایی بنویسید که خروجی دستور
\fBjstat\fR
را تجزیه کنند، باید انتظار داشته باشید که برای نگارش‌های بعدی این ابزار مجبور به اصلاح آن‌ها شوید\&.
.PP
\-\fIstatOption\fR
.RS 4
اطلاعات آماری‌ای را که دستور
\fBjstat\fR
نمایش می‌دهد تعیین می‌کند\&. موارد زیر گزینه‌های موجود را فهرست می‌کنند\&. از گزینه عمومی
\fB\-options\fR
برای نمایش فهرست گزینه‌ها در یک نصب خاص از پلتفرم استفاده کنید\&. بخش گزینه‌ها و خروجی‌های آماری را ببینید\&.
.sp
\fBclass\fR: آماری درباره رفتار بارگذار کلاس (class loader) نمایش می‌دهد\&.
.sp
\fBcompiler\fR: آماری درباره رفتار کامپایلر درجا (Just\-in\-Time) در Java HotSpot VM نمایش می‌دهد\&.
.sp
\fBgc\fR: آماری درباره رفتار هیپِ مدیریت‌شده توسط زباله‌روب (garbage collected heap) نمایش می‌دهد\&.
.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: آماری درباره اندازه‌های metaspace نمایش می‌دهد\&.
.sp
\fBgcutil\fR: خلاصه‌ای از آمارهای جمع‌آوری زباله را نمایش می‌دهد\&.
.sp
\fBprintcompilation\fR: آماری از متدهای کامپایل در Java HotSpot VM نمایش می‌دهد\&.
.RE
.PP
\-h \fIn\fR
.RS 4
به ازای هر
\fIn\fR
نمونه (سطرهای خروجی)، یک سرایند ستون نمایش می‌دهد، که در آن
\fIn\fR
یک عدد صحیح مثبت است\&. مقدار پیش‌فرض 0 است که سرایند ستون را در اولین سطر داده‌ها نمایش می‌دهد\&.
.RE
.PP
\-t
.RS 4
یک ستون برچسب زمان (Timestamp) را به‌عنوان نخستین ستون خروجی نمایش می‌دهد\&. برچسب زمان، زمان سپری‌شده از زمان آغاز به کار JVM مقصد است\&.
.RE
.PP
\-J\fIjavaOption\fR
.RS 4
گزینه
\fBjavaOption\fR
را به اجراکننده برنامه جاوا ارسال می‌کند\&. برای نمونه،
\fB\-J\-Xms48m\fR
مقدار حافظه زمان راه‌اندازی را روی 48 مگابایت تنظیم می‌کند\&. برای مشاهده فهرست کامل گزینه‌ها،
java(1)
را ببینید\&.
.RE.SS "گزینه‌های آمار و خروجی (Stat Options and Output)"
.PP
اطلاعات زیر ستون‌هایی را خلاصه می‌کند که دستور
\fBjstat\fR
برای هر
\fIstatOption\fR\&
در خروجی نمایش می‌دهد.
.PP
\-class \fIoption\fR
.RS 4
آمار بارگذار کلاس (Class loader)\&.
.sp
\fBLoaded\fR: تعداد کلاس‌های بارگذاری‌شده\&.
.sp
\fBBytes\fR: تعداد کیلوبایت‌های بارگذاری‌شده\&.
.sp
\fBUnloaded\fR: تعداد کلاس‌های تخلیه‌شده\&.
.sp
\fBBytes\fR: تعداد کیلوبایت‌های تخلیه‌شده\&.
.sp
\fBTime\fR: زمان صرف‌شده برای انجام عملیات بارگذاری و تخلیه کلاس‌ها\&.
.RE
.PP
\-compiler \fIoption\fR
.RS 4
آمار کامپایلر Just\-in\-Time در 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
آمار حافظه هیپ (Heap) زباله‌روبی‌شده\&.
.sp
\fBS0C\fR: ظرفیت فعلی فضای survivor 0 (kB)\&.
.sp
\fBS1C\fR: ظرفیت فعلی فضای survivor 1 (kB)\&.
.sp
\fBS0U\fR: میزان استفاده از فضای survivor 0 (kB)\&.
.sp
\fBS1U\fR: میزان استفاده از فضای survivor 1 (kB)\&.
.sp
\fBEC\fR: ظرفیت فعلی فضای eden (kB)\&.
.sp
\fBEU\fR: میزان استفاده از فضای eden (kB)\&.
.sp
\fBOC\fR: ظرفیت فعلی فضای old (kB)\&.
.sp
\fBOU\fR: میزان استفاده از فضای old (kB)\&.
.sp
\fBMC\fR: ظرفیت Metaspace (kB)\&.
.sp
\fBMU\fR: میزان استفاده از Metaspace (kB)\&.
.sp
\fBCCSC\fR: ظرفیت فضای compressed class (kB)\&.
.sp
\fBCCSU\fR: میزان استفاده از فضای compressed class (kB)\&.
.sp
\fBYGC\fR: تعداد رخدادهای زباله‌روبی نسل جوان (Young generation)\&.
.sp
\fBYGCT\fR: زمان صرف‌شده برای زباله‌روبی نسل جوان\&.
.sp
\fBFGC\fR: تعداد رخدادهای زباله‌روبی کامل (Full GC)\&.
.sp
\fBFGCT\fR: زمان صرف‌شده برای زباله‌روبی کامل\&.
.sp
\fBGCT\fR: کل زمان صرف‌شده برای زباله‌روبی\&.
.RE
.PP
\-gccapacity \fIoption\fR
.RS 4
ظرفیت‌های فضا و نسل‌های استخر حافظه (Memory pool)\&.
.sp
\fBNGCMN\fR: حداقل ظرفیت نسل جدید (kB)\&.
.sp
\fBNGCMX\fR: حداکثر ظرفیت نسل جدید (kB)\&.
.sp
\fBNGC\fR: ظرفیت فعلی نسل جدید (kB)\&.
.sp
\fBS0C\fR: ظرفیت فعلی فضای survivor 0 (kB)\&.
.sp
\fBS1C\fR: ظرفیت فعلی فضای survivor 1 (kB)\&.
.sp
\fBEC\fR: ظرفیت فعلی فضای eden (kB)\&.
.sp
\fBOGCMN\fR: حداقل ظرفیت نسل قدیم (kB)\&.
.sp
\fBOGCMX\fR: حداکثر ظرفیت نسل قدیم (kB)\&.
.sp
\fBOGC\fR: ظرفیت فعلی نسل قدیم (kB)\&.
.sp
\fBOC\fR: ظرفیت فعلی فضای old (kB)\&.
.sp
\fBMCMN\fR: حداقل ظرفیت Metaspace (kB)\&.
.sp
\fBMCMX\fR: حداکثر ظرفیت Metaspace (kB)\&.
.sp
\fBMC\fR: ظرفیت Metaspace (kB)\&.
.sp
\fBCCSMN\fR: حداقل ظرفیت فضای compressed class (kB)\&.
.sp
\fBCCSMX\fR: حداکثر ظرفیت فضای compressed class (kB)\&.
.sp
\fBCCSC\fR: ظرفیت فضای compressed class (kB)\&.
.sp
\fBYGC\fR: تعداد رخدادهای GC نسل جوان\&.
.sp
\fBFGC\fR: تعداد رخدادهای GC کامل (Full 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
آمار نسل جدید (New generation)\&.
.sp
\fBS0C\fR: ظرفیت فعلی فضای survivor 0 (kB)\&.
.sp
\fBS1C\fR: ظرفیت فعلی فضای survivor 1 (kB)\&.
.sp
\fBS0U\fR: میزان استفاده از فضای survivor 0 (kB)\&.
.sp
\fBS1U\fR: میزان استفاده از فضای survivor 1 (kB)\&.
.sp
\fBTT\fR: آستانه ماندگاری (Tenuring threshold)\&.
.sp
\fBMTT\fR: حداکثر آستانه ماندگاری\&.
.sp
\fBDSS\fR: اندازه مطلوب فضای survivor (kB)\&.
.sp
\fBEC\fR: ظرفیت فعلی فضای eden (kB)\&.
.sp
\fBEU\fR: میزان استفاده از فضای eden (kB)\&.
.sp
\fBYGC\fR: تعداد رخدادهای GC نسل جدید\&.
.sp
\fBYGCT\fR: زمان زباله‌روبی نسل جدید\&.
.RE
.PP
\-gcnewcapacity \fIoption\fR
.RS 4
آمار اندازه فضای نسل جدید\&.
.sp
\fBNGCMN\fR: حداقل ظرفیت نسل جدید (kB)\&.
.sp
\fBNGCMX\fR: حداکثر ظرفیت نسل جدید (kB)\&.
.sp
\fBNGC\fR: ظرفیت فعلی نسل جدید (kB)\&.
.sp
\fBS0CMX\fR: حداکثر ظرفیت فضای survivor 0 (kB)\&.
.sp
\fBS0C\fR: ظرفیت فعلی فضای survivor 0 (kB)\&.
.sp
\fBS1CMX\fR: حداکثر ظرفیت فضای survivor 1 (kB)\&.
.sp
\fBS1C\fR: ظرفیت فعلی فضای survivor 1 (kB)\&.
.sp
\fBECMX\fR: حداکثر ظرفیت فضای eden (kB)\&.
.sp
\fBEC\fR: ظرفیت فعلی فضای eden (kB)\&.
.sp
\fBYGC\fR: تعداد رخدادهای GC نسل جدید\&..sp
\fBFGC\fR: تعداد رویدادهای GC کامل (Full GC)\&.
.RE
.PP
\-gcold \fIگزینه\fR
.RS 4
آمارهای رفتار نسل قدیم (Old generation) و metaspace\&.
.sp
\fBMC\fR: گنجایش metaspace (به کیلوبایت)\&.
.sp
\fBMU\fR: میزان فضای استفاده‌شدهٔ metaspace (به کیلوبایت)\&.
.sp
\fBCCSC\fR: گنجایش فضای کلاس فشرده (Compressed class space) (به کیلوبایت)\&.
.sp
\fBCCSU\fR: میزان فضای کلاس فشردهٔ استفاده‌شده (به کیلوبایت)\&.
.sp
\fBOC\fR: گنجایش کنونی فضای قدیم (Old space) (به کیلوبایت)\&.
.sp
\fBOU\fR: میزان فضای استفاده‌شدهٔ فضای قدیم (به کیلوبایت)\&.
.sp
\fBYGC\fR: تعداد رویدادهای GC نسل جوان (Young generation)\&.
.sp
\fBFGC\fR: تعداد رویدادهای GC کامل (Full GC)\&.
.sp
\fBFGCT\fR: مدت‌زمان بازیافت حافظه کامل (Full GC)\&.
.sp
\fBGCT\fR: مدت‌زمان کل بازیافت حافظه (GC)\&.
.RE
.PP
\-gcoldcapacity \fIگزینه\fR
.RS 4
آمارهای اندازهٔ نسل قدیم (Old generation)\&.
.sp
\fBOGCMN\fR: حداقل گنجایش نسل قدیم (به کیلوبایت)\&.
.sp
\fBOGCMX\fR: حداکثر گنجایش نسل قدیم (به کیلوبایت)\&.
.sp
\fBOGC\fR: گنجایش کنونی نسل قدیم (به کیلوبایت)\&.
.sp
\fBOC\fR: گنجایش کنونی فضای قدیم (Old space) (به کیلوبایت)\&.
.sp
\fBYGC\fR: تعداد رویدادهای GC نسل جوان (Young generation)\&.
.sp
\fBFGC\fR: تعداد رویدادهای GC کامل (Full GC)\&.
.sp
\fBFGCT\fR: مدت‌زمان بازیافت حافظه کامل (Full GC)\&.
.sp
\fBGCT\fR: مدت‌زمان کل بازیافت حافظه (GC)\&.
.RE
.PP
\-gcmetacapacity \fIگزینه\fR
.RS 4
آمارهای اندازهٔ metaspace\&.
.sp
\fBMCMN\fR: حداقل گنجایش metaspace (به کیلوبایت)\&.
.sp
\fBMCMX\fR: حداکثر گنجایش metaspace (به کیلوبایت)\&.
.sp
\fBMC\fR: گنجایش metaspace (به کیلوبایت)\&.
.sp
\fBCCSMN\fR: حداقل گنجایش فضای کلاس فشرده (به کیلوبایت)\&.
.sp
\fBCCSMX\fR: حداکثر گنجایش فضای کلاس فشرده (به کیلوبایت)\&.
.sp
\fBYGC\fR: تعداد رویدادهای GC نسل جوان (Young generation)\&.
.sp
\fBFGC\fR: تعداد رویدادهای GC کامل (Full GC)\&.
.sp
\fBFGCT\fR: مدت‌زمان بازیافت حافظه کامل (Full GC)\&.
.sp
\fBGCT\fR: مدت‌زمان کل بازیافت حافظه (GC)\&.
.RE
.PP
\-gcutil \fIگزینه\fR
.RS 4
خلاصه‌ای از آمارهای بازیافت حافظه (GC)\&.
.sp
\fBS0\fR: میزان استفاده از فضای بازماندهٔ ۰ (Survivor space 0) به صورت درصدی از گنجایش کنونی فضا\&.
.sp
\fBS1\fR: میزان استفاده از فضای بازماندهٔ ۱ (Survivor space 1) به صورت درصدی از گنجایش کنونی فضا\&.
.sp
\fBE\fR: میزان استفاده از فضای عدن (Eden space) به صورت درصدی از گنجایش کنونی فضا\&.
.sp
\fBO\fR: میزان استفاده از فضای قدیم (Old space) به صورت درصدی از گنجایش کنونی فضا\&.
.sp
\fBM\fR: میزان استفاده از metaspace به صورت درصدی از گنجایش کنونی فضا\&.
.sp
\fBCCS\fR: میزان استفاده از فضای کلاس فشرده به صورت درصد\&.
.sp
\fBYGC\fR: تعداد رویدادهای GC نسل جوان (Young generation)\&.
.sp
\fBYGCT\fR: مدت‌زمان بازیافت حافظه نسل جوان\&.
.sp
\fBFGC\fR: تعداد رویدادهای GC کامل (Full GC)\&.
.sp
\fBFGCT\fR: مدت‌زمان بازیافت حافظه کامل (Full GC)\&.
.sp
\fBGCT\fR: مدت‌زمان کل بازیافت حافظه (GC)\&.
.RE
.PP
\-printcompilation \fIگزینه\fR
.RS 4
آمارهای متدهای کامپایلر HotSpot VM جاوا\&.
.sp
\fBCompiled\fR: تعداد وظایف کامپایل انجام‌شده توسط آخرین متد کامپایل‌شده\&.
.sp
\fBSize\fR: تعداد بایت‌های بایت‌کدِ (bytecode) آخرین متد کامپایل‌شده\&.
.sp
\fBType\fR: نوع کامپایل آخرین متد کامپایل‌شده\&.
.sp
\fBMethod\fR: نام کلاس و نام متد مشخص‌کنندهٔ آخرین متد کامپایل‌شده\&. نام کلاس به‌جای نقطه (\&.) از اسلش (/) به عنوان جداکنندهٔ فضای نام استفاده می‌کند\&. نام متد، متدِ درون کلاس مشخص‌شده است\&. قالب این دو فیلد با گزینهٔ
\fB\-XX:+PrintCompilation\fR
در HotSpot سازگار است\&.
.RE.SH "مثال‌ها (EXAMPLES)"
.PP
این بخش مثال‌هایی از پایش یک JVM محلی با
\fIlvmid\fR
برابر با 21891 را ارائه می‌دهد\&.
.SS "گزینه gcutil"
.PP
این مثال به lvmid برابر با 21891 متصل شده، ۷ نمونه در بازه‌های زمانی ۲۵۰ میلی‌ثانیه‌ای می‌گیرد و خروجی را همان‌طور که توسط گزینه
\-\fBgcutil\fR
مشخص شده نمایش می‌دهد\&.
.PP
خروجی این مثال نشان می‌دهد که یک بازیافت حافظه نسل جوان (young generation collection) بین نمونه سوم و چهارم رخ داده است\&. این بازیافت 0\&.078 ثانیه به طول انجامید و اشیاء را از فضای eden (E) به فضای old (O) ارتقا داد، که منجر به افزایش بهره‌برداری از فضای old از 66\&.80% به 68\&.19% شد\&. پیش از این بازیافت، از فضای survivor به میزان 97\&.02% استفاده شده بود، اما پس از این بازیافت به میزان 91\&.03% استفاده می‌شود\&.
.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 برابر با 21891 متصل شده، در بازه‌های ۲۵۰ میلی‌ثانیه‌ای نمونه‌برداری می‌کند و خروجی را طبق مشخصات گزینه
\fB\-gcnew\fR
نمایش می‌دهد\&. علاوه بر این، از گزینه
\fB\-h3\fR
برای نمایش سربرگ ستون‌ها پس از هر ۳ خط داده استفاده می‌کند\&.
.PP
این مثال علاوه بر نمایش تکرار رشته سربرگ، نشان می‌دهد که بین نمونه‌های دوم و سوم یک GC جوان (young GC) رخ داده است\&. مدت زمان آن 0\&.001 ثانیه بود\&. این بازیافت حافظه داده‌های فعال کافی پیدا کرد به طوری که بهره‌برداری از فضای survivor 0 یا (S0U) از اندازه مورد نظر survivor یا (DSS) فراتر می‌رفت\&. در نتیجه، اشیاء به نسل قدیم (old generation) ارتقا یافتند (که در این خروجی قابل مشاهده نیست) و آستانه نگهداری (TT) از 31 به 2 کاهش یافت\&.
.PP
بازیافت دیگری بین نمونه‌های پنجم و ششم رخ می‌دهد\&. این بازیافت بازماندگان بسیار اندکی پیدا کرد و آستانه نگهداری را به 31 بازگرداند\&.
.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 برابر با 21891 متصل می‌شود و ۳ نمونه در بازه‌های زمانی ۲۵۰ میلی‌ثانیه‌ای می‌گیرد\&. گزینه
\fB\-t\fR
برای ایجاد یک برچسب زمانی برای هر نمونه در ستون اول استفاده شده است\&.
.PP
ستون Timestamp زمان سپری‌شده بر حسب ثانیه را از آغاز به کار JVM مقصد گزارش می‌دهد\&. علاوه بر این، خروجی
\fB\-gcoldcapacity\fR
نشان می‌دهد که با گسترش heap برای پاسخگویی به نیازهای تخصیص یا ارتقا، ظرفیت نسل قدیم (OGC) و ظرفیت فضای old یا (OC) افزایش می‌یابند\&. ظرفیت نسل قدیم (OGC) پس از هشتاد و یکمین بازیافت کامل حافظه (FGC)، از 11,696 kB به 13,820 kB افزایش یافته است\&. بیشینه ظرفیت این نسل (و فضا) 60,544 kB یا (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 با شمارهٔ 40496 روی سامانه‌ای به نام remote\&.domain متصل می‌شود و به‌طور نامحدود، هر ثانیه یک نمونه برمی‌دارد\&.
.PP
شناسهٔ lvmid با نام میزبان راه دور ترکیب می‌شود تا یک
\fIvmid\fR
به‌صورت
\fB40496@remote\&.domain\fR
ساخته شود\&. این vmid موجب استفاده از پروتکل
\fBrmi\fR
برای برقراری ارتباط با سرور پیش‌فرض
\fBjstatd\fR
روی میزبان راه دور می‌شود\&. سرور
\fBjstatd\fR
با استفاده از دستور
\fBrmiregistry\fR
روی
\fBremote\&.domain\fR
که به درگاه پیش‌فرض دستور
\fBrmiregistry\fR
(درگاه 1099) متصل شده است، مکان‌یابی می‌شود\&.
.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