.\" -*- mode: troff; coding: utf-8 -*- .\" Automatically generated by Pod::Man v6.0.2 (Pod::Simple 3.45) .\" .\" Standard preamble: .\" ======================================================================== .de Sp \" Vertical space (when we can't use .PP) .if t .sp .5v .if n .sp .. .de Vb \" Begin verbatim text .ft CW .nf .ne \\$1 .. .de Ve \" End verbatim text .ft R .fi .. .\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>. .ie n \{\ . ds C` "" . ds C' "" 'br\} .el\{\ . ds C` . ds C' 'br\} .\" .\" Escape single quotes in literal strings from groff's Unicode transform. .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" .\" If the F register is >0, we'll generate index entries on stderr for .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index .\" entries marked with X<> in POD. Of course, you'll have to process the .\" output yourself in some meaningful fashion. .\" .\" Avoid warning from groff about undefined register 'F'. .de IX .. .nr rF 0 .if \n(.g .if rF .nr rF 1 .if (\n(rF:(\n(.g==0)) \{\ . if \nF \{\ . de IX . tm Index:\\$1\t\\n%\t"\\$2" .. . if !\nF==2 \{\ . nr % 0 . nr F 2 . \} . \} .\} .rr rF .\" .\" Required to disable full justification in groff 1.23.0. .if n .ds AD l .\" ======================================================================== .\" .IX Title "RRDTUNE 1" .TH RRDTUNE 1 2026-08-08 1.11.0 rrdtool .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l .nh .SH "نام (NAME)" rrdtune \- اصلاح برخی از ویژگی‌های پایه‌ای پایگاه‌دادهٔ Round Robin .SH "خلاصه دستور (SYNOPSIS)" .IX Header "SYNOPSIS" \&\fBrrdtool\fR \fBtune\fR \fIfilename\fR [\fB\-\-heartbeat\fR|\fB\-h\fR\ \fIds\-name\fR:\fIheartbeat\fR] [\fB\-\-minimum\fR|\fB\-i\fR\ \fIds\-name\fR:\fImin\fR] [\fB\-\-maximum\fR|\fB\-a\fR\ \fIds\-name\fR:\fImax\fR] [\fB\-\-data\-source\-type\fR|\fB\-d\fR\ \fIds\-name\fR:\fIDST\fR] [\fB\-\-data\-source\-rename\fR|\fB\-r\fR\ \fIold\-name\fR:\fInew\-name\fR] [\fB\-\-deltapos\fR|\fB\-p\fR\ \fIscale\-value\fR] [\fB\-\-deltaneg\fR|\fB\-n\fR\ \fIscale\-value\fR] [\fB\-\-failure\-threshold\fR|\fB\-f\fR\ \fIfailure\-threshold\fR] [\fB\-\-window\-length\fR|\fB\-w\fR\ \fIwindow\-length\fR] [\fB\-\-alpha\fR|\fB\-x\fR\ \fIadaption\-parameter\fR] [\fB\-\-beta\fR|\fB\-y\fR\ \fIadaption\-parameter\fR] [\fB\-\-gamma\fR|\fB\-z\fR\ \fIadaption\-parameter\fR] [\fB\-\-gamma\-deviation\fR|\fB\-v\fR\ \fIadaption\-parameter\fR] [\fB\-\-smoothing\-window\fR|\fB\-s\fR\ \fIfraction\-of\-season\fR] [\fB\-\-smoothing\-window\-deviation\fR|\fB\-S\fR\ \fIfraction\-of\-season\fR] [\fB\-\-aberrant\-reset\fR|\fB\-b\fR\ \fIds\-name\fR] [\fB\-\-step\fR|\fB\-t\fR\ \fInewstep\fR] [\fB\-\-daemon\fR|\fB\-D\fR\ \fIaddress\fR] [\fBDEL:\fR\fIds\-name\fR] [\fBDS:\fR\fIds\-spec\fR] [\fBDELRRA:\fR\fIindex\fR] [\fBRRA:\fR\fIrra\-spec\fR] [\fBRRA#\fR\fIindex\fR:[+\-=] .SH "توضیحات (DESCRIPTION)" .IX Header "DESCRIPTION" گزینهٔ tune به شما امکان می‌دهد برخی از مقادیر پیکربندی پایه‌ای ذخیره‌شده در ناحیهٔ سرایند یک پایگاه‌دادهٔ Round Robin (\fBRRD\fR) را تغییر دهید. .PP یک کاربرد تابع \fBtune\fR، تسهیل قوانین اعتبارسنجی روی یک \fBRRD\fR است. این کار به شما امکان می‌دهد یک \fBRRD\fR جدید را با داده‌هایی که در بازه‌های زمانی بزرگ‌تر از حد مجاز معمول در دسترس هستند پر کنید. هنگام عملیات tune روی منابع داده از نوع COMPUTE بسیار مراقب باشید. تنظیم \fImin\fR، \fImax\fR و \fIheartbeat\fR برای یک منبع دادهٔ COMPUTE بدون تغییر دادن نوع منبع داده به یک \fBDST\fR غیر COMPUTE، سرایند منبع داده را در \fBRRD\fR خراب خواهد کرد. .PP دومین کاربرد تابع \fBtune\fR، تعیین یا تغییر پارامترهای مورداستفاده توسط \fBRRA\fRهای تخصصی برای تشخیص رفتار ناهنجار (aberrant behavior) است. .PP کاربرد دیگر، افزودن یا حذف منابع داده (DS) یا افزودن، حذف یا اصلاح برخی جنبه‌های بایگانی‌های round\-robin (اصطلاحاً RRA) است. این عملیات‌ها در واقع به‌صورت درجا (in\-place) انجام نمی‌شوند، بلکه درون برنامه یک فایل RRD جدید تولید شده و جایگزین فایل اصلی می‌شود. داده‌ها در طول این عملیات دست‌نخورده باقی می‌مانند. برای اصلاحات عمیق‌تر می‌توانید گزینه‌های \fB\-\-source\fR و \fB\-\-template\fR در تابع \fBcreate\fR را بررسی کنید که به شما اجازه می‌دهند چند فایل RRD را در یک فایل جدید ادغام کنید و حتی در نگه‌داری یا «بازسازی» داده‌ها هوشمندانه‌تر عمل می‌کنند. .IP \fIfilename\fR 8 .IX Item "filename" نام \fBRRD\fR موردنظری که می‌خواهید آن را تنظیم (tune) کنید. .IP "\fB\-\-heartbeat\fR|\fB\-h\fR\ \fIds\-name\fR:\fIheartbeat\fR" 8 .IX Item "--heartbeat|-h ds-name:heartbeat" اصلاح \fIheartbeat\fR یک منبع داده. با تنظیم آن روی یک مقدار بزرگ، RRD مواردی مانند دریافت یک مقدار در روز را می‌پذیرد. .IP "\fB\-\-minimum\fR|\fB\-i\fR\ \fIds\-name\fR:\fImin\fR" 8 .IX Item "--minimum|-i ds-name:min" تغییر کمینه مقدار قابل‌قبول به‌عنوان ورودی از منبع داده. تنظیم \fImin\fR روی \*(AqU\*(Aq این محدودیت را غیرفعال می‌کند. .IP "\fB\-\-maximum\fR|\fB\-a\fR\ \fIds\-name\fR:\fImax\fR" 8 .IX Item "--maximum|-a ds-name:max" تغییر بیشینه مقدار قابل‌قبول به‌عنوان ورودی از منبع داده. تنظیم \fImax\fR روی \*(AqU\*(Aq این محدودیت را غیرفعال می‌کند. .IP "\fB\-\-data\-source\-type\fR|\fB\-d\fR\ \fIds\-name\fR:\fIDST\fR" 8 .IX Item "--data-source-type|-d ds-name:DST" تغییر نوع منبع داده (\fBDST\fR). .IP "\fB\-\-data\-source\-rename\fR|\fB\-r\fR\ \fIold\-name\fR:\fInew\-name\fR" 8 .IX Item "--data-source-rename|-r old-name:new-name" تغییر نام یک منبع داده. .IP "\fB\-\-deltapos\fR|\fB\-p\fR\ \fIscale\-value\fR" 8 .IX Item "--deltapos|-p scale-value" تغییر ضریب مقیاس‌بندی انحراف برای کران بالای باند اطمینان (confidence band) که درون برنامه برای محاسبهٔ موارد نقض در \fBRRA\fR با نام FAILURES استفاده می‌شود. مقدار پیش‌فرض 2 است. توجه داشته باشید که این پارامتر ارتباطی با رسم کران‌های اطمینان ندارد؛ این کران‌ها برای ایجاد یک نمودار باید به‌عنوان یک آرگومان CDEF مشخص شوند. ضریب مقیاس نمودار نیازی ندارد که با مقدار استفاده‌شده درون \fBRRA\fR با نام FAILURES مطابقت داشته باشد. .IP "\fB\-\-deltaneg\fR|\fB\-n\fR\ \fIscale\-value\fR" 8 .IX Item "--deltaneg|-n scale-value" تغییر ضریب مقیاس‌بندی انحراف برای کران پایین باند اطمینان که درون برنامه برای محاسبهٔ موارد نقض در \fBRRA\fR با نام FAILURES استفاده می‌شود. مقدار پیش‌فرض 2 است. همانند \fB\-\-deltapos\fR، این آرگومان با ضریب مقیاس انتخاب‌شده هنگام رسم کران‌های اطمینان ارتباطی ندارد. .IP "\fB\-\-failure\-threshold\fR|\fB\-f\fR\ \fIfailure\-threshold\fR" 8 .IX Item "--failure-threshold|-f failure-threshold" تغییر تعداد موارد نقض کران اطمینان که برای اهداف \fBRRA\fR با نام FAILURES یک شکست (failure) تلقی می‌شوند. این مقدار باید یک عدد صحیح کمتر یا مساوی با طول پنجرهٔ (window length) \fBRRA\fR با نام FAILURES باشد. این محدودیت توسط گزینهٔ tune بررسی نمی‌شود، بنابراین می‌توان failure\-threshold و window\-length را به‌طور هم‌زمان بازنشانی کرد. تنظیم این گزینه شمارش موارد نقض را به 0 بازنشانی می‌کند. .IP "\fB\-\-window\-length\fR|\fB\-w\fR\ \fIwindow\-length\fR" 8 .IX Item "--window-length|-w window-length" تغییر تعداد نقاط زمانی در پنجرهٔ زمانی برای تعیین شکست‌ها. این مقدار باید یک عدد صحیح بزرگ‌تر یا مساوی با طول پنجرهٔ \fBRRA\fR با نام FAILURES و کمتر یا مساوی با 28 باشد. تنظیم این گزینه شمارش موارد نقض را به 0 بازنشانی می‌کند. .IP "\fB\-\-alpha\fR|\fB\-x\fR\ \fIadaption\-parameter\fR" 8 .IX Item "--alpha|-x adaption-parameter" تغییر پارامتر تطبیق عرض از مبدأ (intercept) برای الگوریتم پیش‌بینی Holt\-Winters. این پارامتر باید بین 0 و 1 باشد. .IP "\fB\-\-beta\fR|\fB\-y\fR\ \fIadaption\-parameter\fR" 8 .IX Item "--beta|-y adaption-parameter" تغییر پارامتر تطبیق شیب (slope) برای الگوریتم پیش‌بینی Holt\-Winters. این پارامتر باید بین 0 و 1 باشد. .IP "\fB\-\-gamma\fR|\fB\-z\fR\ \fIadaption\-parameter\fR" 8 .IX Item "--gamma|-z adaption-parameter" تغییر پارامتر تطبیق ضریب فصلی برای \fBRRA\fR با نام SEASONAL. این پارامتر باید بین 0 و 1 باشد. .IP "\fB\-\-gamma\-deviation\fR|\fB\-v\fR\ \fIadaption\-parameter\fR" 8 .IX Item "--gamma-deviation|-v adaption-parameter" تغییر پارامتر تطبیق انحراف فصلی برای \fBRRA\fR با نام DEVSEASONAL. این پارامتر باید بین 0 و 1 باشد. .IP "\fB\-\-smoothing\-window\fR|\fB\-s\fR\ \fIfraction\-of\-season\fR" 8 .IX Item "--smoothing-window|-s fraction-of-season" تغییر اندازهٔ پنجرهٔ هموارسازی برای \fBRRA\fR با نام SEASONAL. این مقدار باید بین 0 و 1 باشد. .IP "\fB\-\-smoothing\-window\-deviation\fR|\fB\-S\fR\ \fIfraction\-of\-season\fR" 8 .IX Item "--smoothing-window-deviation|-S fraction-of-season" تغییر اندازهٔ پنجرهٔ هموارسازی برای \fBRRA\fR با نام DEVSEASONAL. این مقدار باید بین 0 و 1 باشد. .IP "\fB\-\-aberrant\-reset\fR|\fB\-b\fR\ \fIds\-name\fR" 8 .IX Item "--aberrant-reset|-b ds-name" این گزینه باعث می‌شود الگوریتم تشخیص رفتار ناهنجار برای منبع دادهٔ مشخص‌شده بازنشانی شود؛ یعنی هر آنچه را که تاکنون آموخته است فراموش کند. به‌طور مشخص، برای \fBRRA\fR با نام HWPREDICT یا MHWPREDICT، ضرایب عرض از مبدأ و شیب را روی نامشخص (unknown) تنظیم می‌کند. برای \fBRRA\fR با نام SEASONAL، تمام ضرایب فصلی را روی نامشخص قرار می‌دهد. برای \fBRRA\fR با نام DEVSEASONAL، تمام ضرایب انحراف فصلی را روی نامشخص قرار می‌دهد. برای \fBRRA\fR با نام FAILURES، تاریخچهٔ موارد نقض را پاک می‌کند. توجه داشته باشید که بازنشانی، پیش‌بینی‌های گذشته (مقادیر \fBRRA\fR با نام HWPREDICT یا MHWPREDICT)، انحراف‌های پیش‌بینی‌شده (مقادیر \fBRRA\fR با نام DEVPREDICT)، یا تاریخچهٔ شکست‌ها (مقادیر \fBRRA\fR با نام FAILURES) را پاک نمی‌کند. این گزینه حتی اگر همهٔ \fBRRA\fRهای ذکرشده موجود نباشند نیز عمل خواهد کرد. .Sp به دلیل نحوهٔ پیاده‌سازی این گزینه، یک اثر غیرمستقیم روی سایر منابع داده در RRD وجود دارد. الگوریتم هموارسازی به‌صورت دوره‌ای روی مقادیر SEASONAL و DEVSEASONAL اعمال می‌شود. در طول راه‌اندازی اولیه (bootstrap)، این هموارسازی به تعویق می‌افتد. برای کارایی بیشتر، پیاده‌سازی هموارسازی مختص یک منبع داده نیست. این بدان معناست که استفاده از بازنشانی برای یک منبع داده، اجرای الگوریتم هموارسازی را برای تمام منابع داده در فایل به تأخیر می‌اندازد. بعید است این موضوع پیامدهای جدی داشته باشد، مگر اینکه داده‌های در حال جمع‌آوری برای منابع دادهٔ بازنشانی‌نشده در طول دورهٔ راه‌اندازی مجدد منبع دادهٔ بازنشانی‌شده به‌طرز نامعمولی پرنوسان باشند. .Sp استفاده از این گزینهٔ تنظیم زمانی توصیه می‌شود که رفتار سری زمانی منبع داده به‌شکلی چشمگیر و دائمی تغییر کند. .IP "\fB\-\-step\fR|\fB\-t\fR \fInewstep\fR" 8 .IX Item "--step|-t newstep" اندازهٔ گام (step size) در RRD را به newstep تغییر می‌دهد. .Sp TODO: مستندات مناسب اضافه شود .IP "\fB\-\-daemon\fR|\fB\-D\fR \fIaddress\fR" 8 .IX Item "--daemon|-D address" \&\fBنکته\fR: از آنجا که گزینهٔ \fB\-d\fR (حرف کوچک \*(Aqd\*(Aq) قبلاً استفاده شده بود، این تابع (برخلاف اکثر موارد دیگر) از حرف بزرگ \*(AqD\*(Aq برای گزینهٔ تک‌حرفی جهت مشخص کردن دیمن حافظهٔ پنهان استفاده می‌کند. .Sp در صورت مشخص شدن، \fBRRDtool\fR تلاش خواهد کرد تا به دیمن حافظهٔ پنهان rrdcached در \fIaddress\fR متصل شود و اگر اتصال برقرار نشود، ناموفق خواهد بود. اگر اتصال با موفقیت برقرار شود، داده‌های مربوط به \fIfilename\fR قبل از انجام عملیات رونوشت/تغییر به دیسک تخلیه (flush) خواهند شد. پس از آن، \fIfilename\fR توسط دیمن حافظهٔ پنهان فراموش خواهد شد، به‌طوری که دسترسی بعدی با استفاده از دیمن حافظهٔ پنهان، ساختار درست را بخواند. .Sp این توالی از عملیات به‌گونه‌ای طراحی شده است که در صورت استفاده از هر یک از عملیات تغییر \fBDS\fR یا \fBRRA\fR، از نظر سازگاری درونی فایل RRD به نتیجه‌ای منسجم دست یابد (بدین معنا که: فایل حاصل باید همواره یک فایل RRD معتبر باشد، صرف‌نظر از به‌روزرسانی‌های هم‌روند از طریق دیمن حافظهٔ پنهان). در رابطه با یکپارچگی داده‌ها چنین تضمینی داده نمی‌شود: بدون هماهنگ‌سازی خارجی ممکن است به‌روزرسانی‌های هم‌روند از دست بروند. .Sp برای مشاهدهٔ فهرستی از قالب‌های پذیرفته‌شده، گزینهٔ \fB\-l\fR را در راهنمای rrdcached ببینید. .IP \fBDEL:\fR\fIds\-name\fR 8 .IX Item "DEL:ds-name" هر منبع داده‌ای که با یک مشخصهٔ DEL نام‌گذاری شود، حذف خواهد شد. RRD حاصل هم تعریف و هم داده‌های آن منبع داده را از دست خواهد داد. تعیین چندین مشخصهٔ DEL مجاز است. .IP \fBDS:\fR\fIds\-spec\fR 8 .IX Item "DS:ds-spec" به ازای هر تعریف منبع داده (برای نحو دقیق، دستور \fBcreate\fR را ببینید)، یک منبع دادهٔ جدید به RRD افزوده خواهد شد. تعیین چندین مشخصهٔ DS مجاز است. .IP \fBDELRRA:\fR\fIindex\fR 8 .IX Item "DELRRA:index" بایگانی RRA با نمایهٔ \fIindex\fR را حذف می‌کند. این نمایه مبتنی بر صفر است، یعنی اولین RRA دارای نمایهٔ 0 است. .IP \fBRRA:\fR\fIrra\-spec\fR 8 .IX Item "RRA:rra-spec" به ازای هر تعریف بایگانی (برای نحو دقیق، دستور \fBcreate\fR را ببینید)، یک RRA جدید به RRD خروجی افزوده خواهد شد. تعیین چندین مشخصهٔ RRA مجاز است. .IP \fBRRA#\fR\fIindex\fR:[+\-=] 8 .IX Item "RRA#index:[+-=]" تعداد ردیف‌های مشخص‌شده را به RRA با نمایهٔ می‌افزاید/حذف می‌کند یا تنظیم می‌نماید. این نمایه مبتنی بر صفر است، یعنی اولین RRA دارای نمایهٔ 0 است. .SH "مثال ۱ (EXAMPLE 1)" .IX Header "EXAMPLE 1" \&\f(CW\*(C`rrdtool tune data.rrd \-h in:100000 \-h out:100000 \-h through:100000\*(C'\fR .PP حداقل heartbeat موردنیاز برای منابع دادهٔ \*(Aqin\*(Aq، \*(Aqout\*(Aq و \*(Aqthrough\*(Aq را در data.rrd روی 100\*(Aq000 ثانیه (کمی بیش از یک روز) تنظیم می‌کند. این کار اجازه می‌دهد داده‌های قدیمی از MRTG\-2.0 مستقیماً به RRDtool وارد شوند، بدون آنکه ورودی‌های *UNKNOWN* تولید شوند. .SH "مثال ۲ (EXAMPLE 2)" .IX Header "EXAMPLE 2" \&\f(CW\*(C`rrdtool tune monitor.rrd \-\-window\-length 5 \-\-failure\-threshold 3\*(C'\fR .PP اگر \fBRRA\fR از نوع FAILURES به‌صورت ضمنی ایجاد شده باشد، window\-length پیش‌فرض برابر با 9 و failure\-threshold پیش‌فرض برابر با 7 است. این دستور اکنون یک شکست را به‌عنوان ۳ مورد نقض یا بیشتر در یک پنجرهٔ زمانی متشکل از ۵ نقطهٔ زمانی تعریف می‌کند. .SH "مثال ۳ (EXAMPLE 3)" .IX Header "EXAMPLE 3" \&\f(CW\*(C`rrdtool tune some.rrd DEL:a RRA#0:+10\*(C'\fR .PP منبع دادهٔ با نام \fBa\fR را حذف کرده و نخستین بایگانی را ۱۰ ردیف گسترش می‌دهد. این دستور در واقع RRD ورودی را با یک RRD جدید جایگزین کرده و تمام داده‌های موجود را حفظ می‌کند. برای بیشتر کاربردهای عملی، این فرایند با یک اصلاح واقعی درجا (in\-place) یکسان است. .SH "نویسندگان (AUTHORS)" .IX Header "AUTHORS" Tobias Oetiker , Peter Stamfest