.\" Automatically generated by Pandoc 3.10.2
.\"
.TH "JSTATD" "1" "2026" "JDK 25.0.4.1" "JDK Commands"
.SH "نام (NAME)"
jstatd-openjdk25 \- دیمن نظارت بر ماشین مجازی جاوا (JVM) جهت پایش کارایی
.SH "خلاصه دستور (SYNOPSIS)"
\f[B]هشدار:\f[R] این دستور آزمایشی، پشتیبانی‌نشده و منسوخ است.
این دستور در نگارش‌های آتی حذف خواهد شد.
.PP
\f[CR]jstatd\f[R] [\f[I]گزینه‌ها\f[R]]
.TP
\f[I]گزینه‌ها\f[R]
گزینه‌های خط فرمان \f[CR]jstatd\f[R] را مشخص می‌کند.
بخش \f[B]گزینه‌های دستور jstatd\f[R] را ببینید.
.SH "توضیحات (DESCRIPTION)"
دستور \f[CR]jstatd\f[R] یک برنامه کارساز RMI است که ایجاد و خاتمه ماشین‌های مجازی Java HotSpot ابزارمندسازی‌شده (instrumented) را نظارت کرده و رابطی برای فعال‌سازی ابزارهای پایش از راه دور، یعنی
\f[CR]jstat\f[R] و \f[CR]jps\f[R]، فراهم می‌آورد تا به JVMهای در حال اجرا روی میزبان محلی متصل شده و اطلاعات فرایند JVM را گردآوری کنند.
.PP
کارساز \f[CR]jstatd\f[R] نیازمند یک رجیستری RMI روی میزبان محلی است.
کارساز \f[CR]jstatd\f[R] تلاش می‌کند به رجیستری RMI روی درگاه پیش‌فرض یا روی درگاهی که با گزینه \f[CR]\-p\f[R] \f[CR]port\f[R] مشخص شده متصل شود.
اگر رجیستری RMI یافت نشود، یک رجیستری درون برنامه \f[CR]jstatd\f[R] ایجاد می‌شود که به درگاه مشخص‌شده با گزینه \f[CR]\-p\f[R] \f[CR]port\f[R] یا درگاه پیش‌فرض رجیستری RMI (در صورت حذف گزینه \f[CR]\-p\f[R] \f[CR]port\f[R]) متصل می‌گردد.
با مشخص کردن گزینه \f[CR]\-nr\f[R] می‌توانید از ایجاد رجیستری داخلی RMI جلوگیری کنید.
.SH "گزینه‌های دستور JSTATD (OPTIONS FOR THE JSTATD COMMAND)"
.TP
\f[CR]\-nr\f[R]
این گزینه در صورت پیدا نشدن رجیستری RMI موجود، از تلاش برای ایجاد رجیستری داخلی RMI در فرایند \f[CR]jstatd\f[R] جلوگیری می‌کند.
.TP
\f[CR]\-p\f[R] \f[I]port\f[R]
این گزینه شماره درگاهی را تنظیم می‌کند که انتظار می‌رود رجیستری RMI روی آن یافت شود، یا در صورت پیدا نشدن (چنانچه گزینه \f[CR]\-nr\f[R] مشخص نشده باشد) روی آن ایجاد گردد.
.TP
\f[CR]\-r\f[R] \f[I]rmiport\f[R]
این گزینه شماره درگاهی را تعیین می‌کند که رابط RMI به آن متصل می‌شود.
در صورت عدم تعیین، از یک درگاه آزاد تصادفی استفاده می‌شود.
.TP
\f[CR]\-n\f[R] \f[I]rminame\f[R]
این گزینه نامی را تعیین می‌کند که شیء راه دور RMI در رجیستری RMI با آن مقید (bound) می‌شود.
نام پیش‌فرض \f[CR]JStatRemoteHost\f[R] است.
اگر چندین کارساز \f[CR]jstatd\f[R] روی یک میزبان راه‌اندازی شوند، نام شیء RMI ارائه‌شده برای هر کارساز را می‌توان با تعیین این گزینه یکتا ساخت.
با این حال، انجام این کار مستلزم آن است که نام یکتای کارساز در رشته‌های \f[CR]hostid\f[R] و \f[CR]vmid\f[R] کلاینت پایش گنجانده شود.
.TP
\f[CR]\-J\f[R]\f[I]option\f[R]
این گزینه یک گزینه جاوا (\f[CR]option\f[R]) را به JVM ارسال می‌کند؛ گزینه‌ای که یکی از موارد شرح داده‌شده در صفحه راهنمای راه‌انداز برنامه جاوا است.
برای نمونه، \f[CR]\-J\-Xms48m\f[R] مقدار حافظه هنگام راه‌اندازی را روی ۴۸ مگابایت تنظیم می‌کند.
\f[B]java\f[R] را ببینید.
.SH "امنیت (SECURITY)"
کارساز \f[CR]jstatd\f[R] تنها می‌تواند JVMهایی را پایش کند که دسترسی‌های محلی مناسب برای آن‌ها را داشته باشد.
بنابراین، فرایند \f[CR]jstatd\f[R] باید با همان اعتبارنامه کاربری JVMهای هدف اجرا شود.
برخی اعتبارنامه‌های کاربری، مانند کاربر ریشه (root) در سیستم‌عامل‌های لینوکس و macOS، دسترسی به ابزارمندی‌های ارائه‌شده توسط هر JVM روی سیستم را دارا هستند.
فرایند \f[CR]jstatd\f[R] که با چنین اعتبارنامه‌هایی اجرا شود می‌تواند هر JVM موجود در سیستم را پایش کند، اما نگرانی‌های امنیتی بیشتری به همراه خواهد داشت.
.PP
کارساز \f[CR]jstatd\f[R] هیچ‌گونه اعتبارسنجی و احراز هویتی برای کلاینت‌های راه دور ارائه نمی‌دهد.
بنابراین، اجرای فرایند کارساز \f[CR]jstatd\f[R] موجب می‌شود ابزارمندی ارائه‌شده توسط تمام JVMهایی که فرایند \f[CR]jstatd\f[R] به آن‌ها دسترسی دارد برای هر کاربری در شبکه فاش شود.
این افشاگری ممکن است در محیط کاری شما مطلوب نباشد، بنابراین پیش از اجرای فرایند \f[CR]jstatd\f[R]، باید سیاست‌های امنیتی محلی مورد بررسی قرار گیرند، به‌ویژه در محیط‌های عملیاتی یا شبکه‌های ناامن.
.PP
به دلایل امنیتی، کارساز \f[CR]jstatd\f[R] از یک \f[CR]ObjectInputFilter\f[R] در RMI استفاده می‌کند تا تنها به کلاس‌های ضروری اجازه واچینی (deserialization) داده شود.
.PP
اگر نگرانی‌های امنیتی شما برطرف نمی‌شود، ایمن‌ترین اقدام این است که کارساز \f[CR]jstatd\f[R] را اجرا نکرده و از ابزارهای \f[CR]jstat\f[R] و \f[CR]jps\f[R] به صورت محلی استفاده نمایید.
با این وجود، هنگام استفاده از \f[CR]jps\f[R] برای دریافت فهرست JVMهای ابزارمندسازی‌شده، این فهرست شامل JVMهای در حال اجرا درون کانتینرهای داکر نخواهد بود.
.SH "رابط راه دور (REMOTE INTERFACE)"
رابط ارائه‌شده توسط فرایند \f[CR]jstatd\f[R] اختصاصی بوده و تغییر آن در آینده حتمی است.
به کاربران و توسعه‌دهندگان توصیه می‌شود از کدنویسی روی این رابط خودداری کنند.
.SH "مثال‌ها (EXAMPLES)"
در ادامه مثال‌هایی از دستور \f[CR]jstatd\f[R] آورده شده است.
اسکریپت‌های \f[CR]jstatd\f[R] به صورت خودکار کارساز را در پس‌زمینه اجرا می‌کنند.
.SH "رجیستری داخلی RMI (INTERNAL RMI REGISTRY)"
این مثال نحوه اجرای یک نشست \f[CR]jstatd\f[R] را با یک رجیستری داخلی RMI نشان می‌دهد.
این مثال فرض می‌کند هیچ کارساز دیگری به درگاه پیش‌فرض رجیستری RMI (درگاه \f[CR]1099\f[R]) متصل نشده است.
.RS
.PP
\f[CR]jstatd\f[R]
.RE
.SH "رجیستری خارجی RMI (EXTERNAL RMI REGISTRY)"
این مثال یک نشست \f[CR]jstatd\f[R] را با یک رجیستری خارجی RMI اجرا می‌کند.
.IP
.EX
rmiregistry&
jstatd
.EE
.PP
این مثال یک نشست \f[CR]jstatd\f[R] را با یک کارساز رجیستری خارجی RMI روی درگاه \f[CR]2020\f[R] اجرا می‌کند.
.IP
.EX
jrmiregistry 2020&
jstatd \-p 2020
.EE
.PP
این مثال یک نشست \f[CR]jstatd\f[R] را با یک کارساز رجیستری خارجی RMI روی درگاه \f[CR]2020\f[R] و اتصال‌دهنده JMX متصل به درگاه \f[CR]2021\f[R] اجرا می‌کند.
.IP
.EX
jrmiregistry 2020&
jstatd \-p 2020 \-r 2021
.EE
.PP
این مثال یک نشست \f[CR]jstatd\f[R] را با یک رجیستری خارجی RMI روی درگاه 2020 که با نام \f[CR]AlternateJstatdServerName\f[R] متصل شده اجرا می‌کند.
.IP
.EX
rmiregistry 2020&
jstatd \-p 2020 \-n AlternateJstatdServerName
.EE
.SH "توقف ایجاد رجیستری درون‌فرایندی RMI (STOP THE CREATION OF AN IN-PROCESS RMI REGISTRY)"
این مثال یک نشست \f[CR]jstatd\f[R] را آغاز می‌کند که در صورت پیدا نشدن رجیستری RMI، رجیستری جدیدی ایجاد نمی‌کند.
این مثال فرض می‌کند رجیستری RMI از قبل در حال اجرا است.
اگر رجیستری RMI در حال اجرا نباشد، یک پیام خطا نمایش داده می‌شود.
.RS
.PP
\f[CR]jstatd \-nr\f[R]
.RE
.SH "فعال‌سازی ثبت وقایع RMI (ENABLE RMI LOGGING)"
این مثال یک نشست \f[CR]jstatd\f[R] را با فعال بودن قابلیت‌های ثبت وقایع (logging) RMI آغاز می‌کند.
این روش برای عیب‌یابی یا پایش فعالیت‌های کارساز سودمند است.
.RS
.PP
\f[CR]jstatd \-J\-Djava.rmi.server.logCalls=true\f[R]
.RE