.\" Automatically generated by Pandoc 3.10.2
.\"
.TH "JFR" "1" "2026" "JDK 26.0.2.1" "دستورات JDK"
.SH "نام (NAME)"
jfr \- چاپ و مدیریت فایل‌های ضبط پرواز (Flight Recorder)
.SH "خلاصه دستور (SYNOPSIS)"
برای چاپ محتویات یک فایل ضبط پرواز در خروجی استاندارد:
.PP
\f[CR]jfr\f[R] \f[CR]print\f[R] [\f[I]گزینه‌ها\f[R]] \f[I]file\f[R]
.PP
برای نمایش داده‌های تجمیع‌شده رویدادها در خروجی استاندارد:
.PP
\f[CR]jfr\f[R] \f[CR]view\f[R] [\f[I]گزینه‌ها\f[R]] \f[I]file\f[R]
.PP
برای پیکربندی یک فایل تنظیمات .jfc:
.PP
\f[CR]jfr\f[R] \f[CR]configure\f[R] [\f[I]گزینه‌ها\f[R]]
.PP
برای چاپ اطلاعات متاداده درباره رویدادهای ضبط پرواز:
.PP
\f[CR]jfr\f[R] \f[CR]metadata\f[R] [\f[I]file\f[R]]
.PP
برای مشاهده آمار خلاصه‌شده یک فایل ضبط پرواز:
.PP
\f[CR]jfr\f[R] \f[CR]summary\f[R] \f[I]file\f[R]
.PP
برای حذف رویدادها از یک فایل ضبط پرواز:
.PP
\f[CR]jfr\f[R] \f[CR]scrub\f[R] [\f[I]گزینه‌ها\f[R]] \f[I]file\f[R]
.PP
برای سرهم‌کردن قطعه‌فایل‌ها در یک فایل ضبط پرواز:
.PP
\f[CR]jfr\f[R] \f[CR]assemble\f[R] \f[I]repository\f[R] \f[I]file\f[R]
.PP
برای تفکیک یک فایل ضبط پرواز به قطعه‌فایل‌ها:
.PP
\f[CR]jfr\f[R] \f[CR]disassemble\f[R] [\f[I]گزینه‌ها\f[R]] \f[I]file\f[R]
.TP
\f[I]گزینه‌ها\f[R]
اختیاری: گزینه‌های خط فرمان را مشخص می‌کند که با فاصله از هم جدا شده‌اند.
برای توضیحات گزینه‌های موجود، به بخش‌های مربوط به زیرمؤلفه‌ها مراجعه کنید.
.TP
\f[I]file\f[R]
نام فایل هدف ضبط پرواز (\f[CR].jfr\f[R]) را مشخص می‌کند.
.TP
\f[I]repository\f[R]
محل قرارگیری قطعه‌فایل‌هایی (chunk files) را مشخص می‌کند که باید در یک ضبط پرواز سرهم شوند.
.SH "توضیحات (DESCRIPTION)"
دستور \f[CR]jfr\f[R] ابزاری برای تعامل با فایل‌های ضبط پرواز (\f[CR].jfr\f[R]) فراهم می‌کند.
کارکرد اصلی آن پالایش، خلاصه‌سازی و خروجی دادن فایل‌های ضبط پرواز به قالبی خوانا برای انسان است.
همچنین از پاک‌سازی (scrubbing)، ادغام و تفکیک فایل‌های ضبط پشتیبانی می‌شود.
.PP
فایل‌های ضبط پرواز به صورت فایل‌های با قالب دودویی (باینری) ایجاد و ذخیره می‌شوند.
داشتن ابزاری که بتواند محتوا را از یک ضبط پرواز استخراج کند، بر محتویات نظارت و دستکاری داشته باشد و آن‌ها را به قالبی خوانا برای انسان ترجمه کند، به توسعه‌دهندگان در رفع اشکالات کارایی برنامه‌های جاوا کمک می‌کند.
.SS "زیردستورها"
دستور \f[CR]jfr\f[R] دارای چندین زیردستور است:
.IP \(bu 2
\f[CR]print\f[R]
.IP \(bu 2
\f[CR]view\f[R]
.IP \(bu 2
\f[CR]configure\f[R]
.IP \(bu 2
\f[CR]metadata\f[R]
.IP \(bu 2
\f[CR]summary\f[R]
.IP \(bu 2
\f[CR]scrub\f[R]
.IP \(bu 2
\f[CR]assemble\f[R]
.IP \(bu 2
\f[CR]disassemble\f[R]
.SS "زیردستور \f[CR]jfr print\f[R]"
از \f[CR]jfr print\f[R] برای چاپ محتویات یک فایل ضبط پرواز در خروجی استاندارد استفاده کنید.
.PP
نحو دستور عبارت است از:
.PP
\f[CR]jfr print\f[R]
[\f[CR]\-\-xml\f[R]|\f[CR]\-\-json\f[R]|\f[CR]\-\-exact\f[R]]
[\f[CR]\-\-categories\f[R] <\f[I]filters\f[R]>] [\f[CR]\-\-events\f[R]
<\f[I]filters\f[R]>] [\f[CR]\-\-stack\-depth\f[R] <\f[I]depth\f[R]>]
<\f[I]file\f[R]>
.PP
که در آن:
.TP
\f[CR]\-\-xml\f[R]
چاپ ضبط در قالب XML.
.TP
\f[CR]\-\-json\f[R]
چاپ ضبط در قالب JSON.
.TP
\f[CR]\-\-exact\f[R]
چاپ زیبا و مرتب اعداد و برچسب‌های زمانی با دقت کامل.
.TP
\f[CR]\-\-categories\f[R] <\f[I]filters\f[R]>
انتخاب رویدادهای منطبق با یک نام دسته‌بندی.
فیلتر یک فهرست جداشده با کاما از نام‌ها (ساده و/یا واجد شرایط کامل) و/یا الگوهای گلوب (glob) داخل گیومه است.
.TP
\f[CR]\-\-events\f[R] <\f[I]filters\f[R]>
انتخاب رویدادهای منطبق با یک نام رویداد.
فیلتر یک فهرست جداشده با کاما از نام‌ها (ساده و/یا واجد شرایط کامل) و/یا الگوهای گلوب داخل گیومه است.
.TP
\f[CR]\-\-stack\-depth\f[R] <\f[I]depth\f[R]>
تعداد فریم‌ها در ردپای پشته (stack trace)، به طور پیش‌فرض 5.
.TP
<\f[I]file\f[R]>
مسیر فایل ضبط (\f[CR].jfr\f[R]).
.PP
قالب پیش‌فرض برای چاپ محتویات فایل ضبط پرواز، قالبی خوانا برای انسان است مگر اینکه \f[CR]xml\f[R] یا \f[CR]json\f[R] مشخص شده باشد.
این گزینه‌ها خروجی ماشین‌خوان ارائه می‌دهند که می‌تواند بعداً توسط اسکریپت‌های ایجادشده توسط کاربر تجزیه یا پردازش شود.
.PP
برای مشاهده نمونه نحوه استفاده از فیلترها از \f[CR]jfr \-\-help print\f[R] استفاده کنید.
.PP
برای کاهش حجم داده‌های نمایش‌داده‌شده، امکان پالایش و فیلتر کردن رویدادها یا دسته‌های رویداد وجود دارد.
فیلتر روی نام نمادین یک رویداد (تنظیم‌شده با استفاده از انوتیشن \f[CR]\(atName\f[R]) یا نام دسته (تنظیم‌شده با استفاده از انوتیشن \f[CR]\(atCategory\f[R]) عمل می‌کند.
اگر چندین فیلتر استفاده شود، رویدادهای هر دو فیلتر گنجانده خواهند شد.
اگر هیچ فیلتری استفاده نشود، تمام رویدادها چاپ می‌شوند.
اگر ترکیبی از فیلتر دسته و فیلتر رویداد استفاده شود، رویدادهای انتخاب‌شده اجتماع دو فیلتر خواهند بود.
.PP
برای نمونه، برای نمایش تمام رویدادهای GC و رویداد CPULoad، دستور زیر می‌تواند استفاده شود:
.PP
\f[CR]jfr print \-\-categories GC \-\-events CPULoad recording.jfr\f[R]
.PP
مقادیر رویداد بر اساس انواع محتوایی که استفاده می‌شوند قالب‌بندی می‌گردند.
برای نمونه، یک فیلد با انوتیشن \f[CR]jdk.jfr.Percentage\f[R] که مقدار 0.52 دارد، به صورت %52 قالب‌بندی می‌شود.
.PP
ردپای پشته به طور پیش‌فرض تا 5 فریم بریده می‌شود، اما این تعداد با استفاده از گزینه خط فرمان \f[CR]\-\-stack\-depth\f[R] قابل افزایش یا کاهش است.
.SS "زیردستور \f[CR]jfr view\f[R]"
از \f[CR]jfr view\f[R] برای تجمیع و نمایش داده‌های رویداد در خروجی استاندارد استفاده کنید.
.PP
نحو دستور عبارت است از:
.PP
\f[CR]jfr view\f[R] [\f[CR]\-\-verbose\f[R]] [\f[CR]\-\-width\f[R]
<\f[I]integer\f[R]>] [\f[CR]\-\-truncate\f[R] <\f[I]mode\f[R]>]
[\f[CR]\-\-cell\-height\f[R] <\f[I]integer\f[R]>] <\f[I]view\f[R]>
<\f[I]file\f[R]>
.PP
که در آن:
.TP
\f[CR]\-\-verbose\f[R]
پرس‌وجویی (query) که نما را تشکیل می‌دهد نمایش می‌دهد.
.TP
\f[CR]\-\-width\f[R] <\f[I]integer\f[R]>
عرض نما بر حسب تعداد نویسه‌ها.
مقدار پیش‌فرض به نوع نما بستگی دارد.
.TP
\f[CR]\-\-truncate\f[R] <\f[I]mode\f[R]>
نحوه کوتاه کردن محتوایی که از فضای یک سلول جدول فراتر می‌رود.
حالت می‌تواند \(aqbeginning\(aq یا \(aqend\(aq باشد.
مقدار پیش‌فرض \(aqend\(aq است.
.TP
\f[CR]\-\-cell\-height\f[R] <\f[I]integer\f[R]>
حداکثر تعداد ردیف‌ها در یک سلول جدول.
مقدار پیش‌فرض به نوع نما بستگی دارد.
.TP
<\f[I]view\f[R]>
نام نما یا نوع رویداد برای نمایش.
برای مشاهده فهرستی از نماهای موجود از \f[CR]jfr \-\-help view\f[R] استفاده کنید.
.TP
<\f[I]file\f[R]>
مسیر فایل ضبط (.jfr).
.PP
پارامتر <\f[I]view\f[R]> می‌تواند نام یک نوع رویداد باشد.
برای مشاهده فهرست، از \f[CR]jfr view types <file>\f[R] استفاده کنید.
برای نمایش تمام نماها، از \f[CR]jfr view all\-views <file>\f[R] استفاده کنید.
برای نمایش تمام رویدادها، از \f[CR]jfr view all\-events <file>\f[R] استفاده کنید.
.SS "زیردستور \f[CR]jfr configure\f[R]"
از \f[CR]jfr configure\f[R] برای پیکربندی یک فایل تنظیمات .jfc استفاده کنید.
.PP
نحو دستور عبارت است از:
.PP
\f[CR]jfr configure\f[R] [\-\-interactive] [\-\-verbose] [\-\-input
<files>] [\-\-output <file>] [option=value]* [event\-setting=value]*
.TP
\f[CR]\-\-interactive\f[R]
حالت تعاملی که در آن پیکربندی توسط مجموعه‌ای از پرسش‌ها تعیین می‌شود.
.TP
\f[CR]\-\-verbose\f[R]
تنظیمات اصلاح‌شده را نمایش می‌دهد.
.TP
\f[CR]\-\-input\f[R] <\f[I]files\f[R]>
فهرستی جداشده با کاما از فایل‌های .jfc که پیکربندی جدید بر پایه آن‌ها است.
اگر هیچ فایلی مشخص نشود، از فایل پیش‌فرض در JDK استفاده می‌شود (default.jfc).
اگر \(aqnone\(aq مشخص شود، پیکربندی جدید به صورت خالی آغاز می‌شود.
.TP
\f[CR]\-\-output\f[R] <\f[I]file\f[R]>
نام فایل خروجی تولیدشده.
اگر مشخص نشود، از نام فایل custom.jfc استفاده خواهد شد.
.TP
\f[I]option=value\f[R]
مقدار گزینه‌ای که باید تغییر کند.
برای دیدن گزینه‌های موجود، از \f[CR]jfr help configure\f[R] استفاده کنید.
.TP
\f[I]event\-setting=value\f[R]
مقدار تنظیم رویداد که باید تغییر کند.
از این قالب استفاده کنید:
<\f[I]event\-name\f[R]>#<\f[I]setting\-name\f[R]>=<\f[I]value\f[R]> برای
افزودن یک تنظیم رویداد جدید، نام رویداد را با \(aq+\(aq پیشوندگذاری کنید.
.PP
جداکننده فاصله می‌تواند برای مقادیر بازه زمانی حذف شود، مانند 20ms.
برای اطلاعات بیشتر درباره نحو تنظیمات، به Javadoc بسته jdk.jfr مراجعه فرمایید.
.SS "زیردستور \f[CR]jfr metadata\f[R]"
از \f[CR]jfr metadata\f[R] برای نمایش اطلاعات رویدادها مانند نام رویدادها، دسته‌بندی‌ها و چیدمان فیلدها در یک فایل ضبط پرواز استفاده کنید.
.PP
نحو دستور عبارت است از:
.PP
\f[CR]jfr metadata\f[R] [\-\-categories <filter>] [\-\-events <filter>]
[<file>]
.TP
\f[CR]\-\-categories\f[R] <\f[I]filter\f[R]>
انتخاب رویدادهای منطبق با یک نام دسته‌بندی.
فیلتر یک فهرست جداشده با کاما از نام‌ها (ساده و/یا واجد شرایط کامل) و/یا الگوهای گلوب داخل گیومه است.
.TP
\f[CR]\-\-events\f[R] <\f[I]filter\f[R]>
انتخاب رویدادهای منطبق با یک نام رویداد.
فیلتر یک فهرست جداشده با کاما از نام‌ها (ساده و/یا واجد شرایط کامل) و/یا الگوهای گلوب داخل گیومه است.
.TP
<\f[I]file\f[R]>
مسیر فایل ضبط (.jfr).
.PP
اگر پارامتر <file> حذف شود، از متاداده همان JDK که ابزار \(aqjfr\(aq در آن قرار دارد استفاده خواهد شد.
.SS "زیردستور \f[CR]jfr summary\f[R]"
از \f[CR]jfr summary\f[R] برای چاپ آمارهای یک فایل ضبط استفاده کنید.
برای نمونه، یک خلاصه می‌تواند تعداد رویدادهای ثبت‌شده و میزان فضای دیسک مصرفی آن‌ها را نشان دهد.
این دستور برای عیب‌یابی و درک تأثیر تنظیمات رویدادها سودمند است.
.PP
نحو دستور عبارت است از:
.PP
\f[CR]jfr summary\f[R] <\f[I]file\f[R]>
.PP
که در آن:
.TP
<\f[I]file\f[R]>
مسیر فایل ضبط پرواز (\f[CR].jfr\f[R]).
.SS "زیردستور \f[CR]jfr scrub\f[R]"
از \f[CR]jfr scrub\f[R] برای حذف محتویات حساس از یک فایل یا کاهش اندازه آن استفاده کنید.
.PP
نحو دستور عبارت است از:
.PP
\f[CR]jfr scrub\f[R] [\-\-include\-events <\f[I]filter\f[R]>]
[\-\-exclude\-events <\f[I]filter\f[R]>] [\-\-include\-categories
<\f[I]filter\f[R]>] [\-\-exclude\-categories <\f[I]filter\f[R]>]
[\-\-include\-threads <\f[I]filter\f[R]>] [\-\-exclude\-threads
<\f[I]filter\f[R]>] <\f[I]input\-file\f[R]> [<\f[I]output\-file\f[R]>]
.TP
\f[CR]\-\-include\-events\f[R] <\f[I]filter\f[R]>
انتخاب رویدادهای منطبق با یک نام رویداد.
.TP
\f[CR]\-\-exclude\-events\f[R] <\f[I]filter\f[R]>
مستثنی‌کردن رویدادهای منطبق با یک نام رویداد.
.TP
\f[CR]\-\-include\-categories\f[R] <\f[I]filter\f[R]>
انتخاب رویدادهای منطبق با یک نام دسته‌بندی.
.TP
\f[CR]\-\-exclude\-categories\f[R] <\f[I]filter\f[R]>
مستثنی‌کردن رویدادهای منطبق با یک نام دسته‌بندی.
.TP
\f[CR]\-\-include\-threads\f[R] <\f[I]filter\f[R]>
انتخاب رویدادهای منطبق با یک نام ریسه (thread).
.TP
\f[CR]\-\-exclude\-threads\f[R] <\f[I]filter\f[R]>
مستثنی‌کردن رویدادهای منطبق با یک نام ریسه.
.TP
<\f[I]input\-file\f[R]>
فایل ورودی برای خواندن رویدادها از آن.
.TP
<\f[I]output\-file\f[R]>
فایل خروجی برای نوشتن رویدادهای پالایش‌شده در آن.
اگر فایلی مشخص نشود، در همان مسیر فایل ورودی اما با افزودن \(dq\-scrubbed\(dq به انتهای نام فایل نوشته خواهد شد.
.PP
فیلتر یک فهرست جداشده با کاما از نام‌ها (ساده و/یا واجد شرایط کامل) و/یا الگوهای گلوب داخل گیومه است.
اگر از چندین فیلتر استفاده شود، آن‌ها به ترتیب مشخص‌شده اعمال می‌شوند.
.SS "زیردستور \f[CR]jfr assemble\f[R]"
از \f[CR]jfr assemble\f[R] برای سرهم‌کردن قطعه‌فایل‌ها (chunk files) در یک فایل ضبط استفاده کنید.
.PP
نحو دستور عبارت است از:
.PP
\f[CR]jfr assemble\f[R] <\f[I]repository\f[R]> <\f[I]file\f[R]>
.PP
که در آن:
.TP
<\f[I]repository\f[R]>
دایرکتوری که مخزن حاوی قطعه‌فایل‌ها در آن قرار دارد.
.TP
<\f[I]file\f[R]>
مسیر فایل ضبط پرواز (\f[CR].jfr\f[R]).
.PP
اطلاعات ضبط پرواز به صورت قطعات (chunks) نوشته می‌شوند.
یک قطعه حاوی تمام اطلاعات لازم برای تجزیه و تحلیل است.
یک قطعه معمولاً حاوی رویدادهایی است که برای عیب‌یابی مفید هستند.
در صورتی که JVM دچار فروپاشی (crash) شود، این قطعات می‌توانند بازیابی شوند و برای ایجاد یک فایل ضبط پرواز با استفاده از این دستور \f[CR]jfr assemble\f[R] مورد استفاده قرار گیرند.
این قطعه‌فایل‌ها به ترتیب زمانی به هم متصل می‌شوند و قطعه‌فایل‌هایی که ناتمام مانده‌اند (.part) نادیده گرفته می‌شوند.
.SS "زیردستور \f[CR]jfr disassemble\f[R]"
از \f[CR]jfr disassemble\f[R] برای تجزیه یک فایل ضبط پرواز به قطعه‌فایل‌های سازنده آن استفاده کنید.
.PP
نحو دستور عبارت است از:
.PP
\f[CR]jfr disassemble\f[R] [\f[CR]\-\-max\-chunks\f[R]
<\f[I]chunks\f[R]>] [\f[CR]\-\-output\f[R] <\f[I]directory\f[R]>]
<\f[I]file\f[R]>
.PP
که در آن:
.TP
\f[CR]\-\-output\f[R] <\f[I]directory\f[R]>
محل ذخیره فایل‌های تفکیک‌شده، به طور پیش‌فرض دایرکتوری جاری.
.TP
\f[CR]\-\-max\-chunks\f[R] <\f[I]chunks\f[R]>
حداکثر تعداد قطعات در هر فایل، به طور پیش‌فرض 5.
اندازه قطعه متغیر است، اما معمولاً حدود 15 مگابایت است.
.TP
\f[CR]\-\-max\-size\f[R] <\f[I]size\f[R]>
حداکثر تعداد بایت در هر فایل.
.TP
<\f[I]file\f[R]>
مسیر فایل ضبط پرواز (\f[CR].jfr\f[R]).
.PP
این قابلیت می‌تواند برای تعمیر یک فایل آسیب‌دیده از طریق حذف قطعه معیوب مفید باشد.
همچنین می‌تواند برای کاهش اندازه فایلی که برای انتقال بیش از حد بزرگ است به کار رود.
قطعه‌فایل‌های حاصل با نام‌های \f[CR]myfile_1.jfr\f[R]، \f[CR]myfile_2.jfr\f[R] و غیره نام‌گذاری می‌شوند.
در صورت نیاز، نام فایل‌های حاصل با صفر پر می‌شوند تا ترتیب زمانی حفظ شود.
برای نمونه، اگر ضبط شامل بیش از 100 قطعه باشد، نام قطعه‌فایل \f[CR]myfile_001.jfr\f[R] خواهد بود.
.SS "زیردستورهای version و help در jfr"
از \f[CR]jfr \-\-version\f[R] یا \f[CR]jfr version\f[R] برای مشاهده اطلاعات رشته نسخه این دستور jfr استفاده کنید.
.PP
برای دریافت راهنما در مورد هر یک از زیردستورهای jfr، از دستور زیر استفاده کنید:
.PP
\f[CR]jfr <\-\-help|help>\f[R] [\f[I]subcommand\f[R]]
.PP
که در آن:
.PP
[\f[I]subcommand\f[R]] یکی از موارد زیر است:
.IP \(bu 2
\f[CR]print\f[R]
.IP \(bu 2
\f[CR]view\f[R]
.IP \(bu 2
\f[CR]configure\f[R]
.IP \(bu 2
\f[CR]metadata\f[R]
.IP \(bu 2
\f[CR]summary\f[R]
.IP \(bu 2
\f[CR]scrub\f[R]
.IP \(bu 2
\f[CR]assemble\f[R]
.IP \(bu 2
\f[CR]disassemble\f[R]