RRDXPORT(1)                         rrdtool                        RRDXPORT(1)


نام (NAME)
       rrdxport - برون‌بری داده‌ها در قالب XML بر پایه داده‌های یک یا چند RRD

خلاصه دستور (SYNOPSIS)
       rrdtool xport [-s|--start seconds] [-e|--end seconds]
       [-m|--maxrows rows] [-S|--step value] [--json] [-t|--showtime]
       [--enumds] [--daemon|-d address] [DEF:vname=rrd:ds-name:CF]
       [CDEF:vname=rpn-expression] [XPORT:vname[:legend]]

توضیحات (DESCRIPTION)
       هدف اصلی تابع xport نوشتن بازنمودی با قالب XML از داده‌های ذخیره‌شده در
       یک یا چند RRD است. این تابع همچنین می‌تواند گزارش‌های عددی استخراج کند.

       اگر هیچ گزارهٔ XPORT یافت نشود، هیچ خروجی‌ای تولید نخواهد شد.

       -s|--start seconds (پیش‌فرض end-1day)
           زمانی که محدودهٔ برون‌بری‌شده باید آغاز شود. زمان بر حسب ثانیه از مبدأ
           زمانی (epoch؛ 1970-01-01) الزامی است. اعداد منفی نسبت به زمان کنونی
           سنجیده می‌شوند. به‌طور پیش‌فرض، داده‌های به اندازهٔ یک روز چاپ خواهند
           شد.  همچنین برای توضیحات تفصیلی دربارهٔ چگونگی تعیین زمان، بخش
           «AT-STYLE TIME SPECIFICATION» در rrdfetch را ببینید.

           برای جزئیات دربارهٔ چگونگی تأثیر این مورد بر خروجی، بخش «قالب خروجی
           (OUTPUT FORMAT)» را در زیر ببینید.

       -e|--end seconds (پیش‌فرض now)
           زمانی که محدودهٔ برون‌بری‌شده باید پایان یابد. زمان بر حسب ثانیه از
           مبدأ زمانی (epoch).  همچنین برای توضیحات تفصیلی دربارهٔ چگونگی تعیین
           زمان، بخش «AT-STYLE TIME SPECIFICATION» در rrdfetch را ببینید.

           برای جزئیات دربارهٔ چگونگی تأثیر این مورد بر خروجی، بخش «قالب خروجی
           (OUTPUT FORMAT)» را در زیر ببینید.

       -m|--maxrows rows (پیش‌فرض ۴۰۰ سطر)
           این گزینه مانند پارامتر -w|--width در rrdgraph عمل می‌کند.  در واقع
           دقیقاً همان است، اما نام پارامتر تغییر یافته تا هدف آن در این ماژول
           توصیف شود. برای جزئیات به مستندات rrdgraph مراجعه کنید.

       -S|--step value (پیش‌فرض خودکار)
           مستندات rrdgraph را ببینید.

       --daemon|-d address
           نشانی دیمن rrdcached. در صورت تعیین، پیش از خواندن فایل‌های RRD، یک
           دستور "flush" به کارساز فرستاده می‌شود. این کار به rrdtool اجازه
           می‌دهد تا حتی اگر دیمن طوری پیکربندی شده باشد که مقادیر را برای مدتی
           طولانی کش کند، داده‌های تازه را بازگرداند.  برای مشاهدهٔ فهرستی از
           قالب‌های پذیرفته‌شده، گزینهٔ -l را در راهنمای rrdcached ببینید.

             rrdtool xport --daemon unix:/var/run/rrdcached.sock ...

       -t|--showtime
           زمان را در هر سطر داده می‌گنجاند.

       --json
           تولید خروجی با قالب json (به جای xml).

       --enumds
           فایل xml تولیدشده باید مقادیر داده را در برچسب‌های شماره‌گذاری‌شده
           قرار دهد.

            <v0>val</v0><v1>val</v1>

       DEF:vname=rrd:ds-name:CF
           مستندات rrdgraph را ببینید.

       CDEF:vname=rpn-expression
           مستندات rrdgraph را ببینید.

       XPORT:vname[:legend]
           حداقل یک گزارهٔ XPORT باید وجود داشته باشد. مقادیری که توسط vname
           ارجاع داده شده‌اند چاپ می‌شوند. به‌صورت اختیاری یک عنوان/راهنما
           (legend) اضافه کنید.

قالب خروجی (OUTPUT FORMAT)
       خروجی درون یک عنصر xport قرار می‌گیرد و شامل دو بلوک است. بلوک نخست توسط
       یک عنصر meta در بر گرفته شده و حاوی فراداده است. بلوک دوم توسط یک عنصر
       data در بر گرفته شده و شامل سطرهای داده است.

       فرض کنید که دستور xport به این شکل باشد:

         rrdtool xport \
                 --start now-1h --end now \
                 DEF:xx=host-inout.lo.rrd:output:AVERAGE \
                 DEF:yy=host-inout.lo.rrd:input:AVERAGE \
                 CDEF:aa=xx,yy,+,8,* \
                 XPORT:xx:"out bytes" \
                 XPORT:aa:"in and out bits"

       بخش فرادادهٔ حاصل به این صورت خواهد بود (مقادیر به مشخصات RRD بستگی
       خواهند داشت):

         <meta>
           <start>1020611700</start>
           <step>300</step>
           <end>1020615600</end>
           <rows>14</rows>
           <columns>2</columns>
           <legend>
             <entry>out bytes</entry>
             <entry>in and out bits</entry>
           </legend>
         </meta>

       بخش دادهٔ حاصل به این صورت است:

         <data>
           <row><t>1020611700</t><v>3.4000000000e+00</v><v>5.4400000000e+01</v></row>
           <row><t>1020612000</t><v>3.4000000000e+00</v><v>5.4400000000e+01</v></row>
           <row><t>1020612300</t><v>3.4000000000e+00</v><v>5.4400000000e+01</v></row>
           <row><t>1020612600</t><v>3.4113333333e+00</v><v>5.4581333333e+01</v></row>
           <row><t>1020612900</t><v>3.4000000000e+00</v><v>5.4400000000e+01</v></row>
           <row><t>1020613200</t><v>3.4000000000e+00</v><v>5.4400000000e+01</v></row>
           <row><t>1020613500</t><v>3.4000000000e+00</v><v>5.4400000000e+01</v></row>
           <row><t>1020613800</t><v>3.4000000000e+00</v><v>5.4400000000e+01</v></row>
           <row><t>1020614100</t><v>3.4000000000e+00</v><v>5.4400000000e+01</v></row>
           <row><t>1020614400</t><v>3.4000000000e+00</v><v>5.4400000000e+01</v></row>
           <row><t>1020614700</t><v>3.7333333333e+00</v><v>5.9733333333e+01</v></row>
           <row><t>1020615000</t><v>3.4000000000e+00</v><v>5.4400000000e+01</v></row>
           <row><t>1020615300</t><v>3.4000000000e+00</v><v>5.4400000000e+01</v></row>
           <row><t>1020615600</t><v>NaN</v><v>NaN</v></row>
         </data>

       تمام آمارها در خروجی از گام (step) یکسانی استفاده خواهند کرد. نخستین
       نمونه، اولین نمونه‌ای خواهد بود که بلافاصله پس از --start آغاز می‌شود.
       آخرین نمونه، نمونه‌ای خواهد بود که در زمان --end یا بلافاصله پس از آن
       پایان می‌یابد.

       هر نمونه دارای یک برچسب زمانی (timestamp) و یک یا چند مقدار است.
       برچسب‌های زمانی مرتبط با یک مقدار در RRDtool همواره بیانگر زمانی هستند
       که نمونه گرفته شده است. از آن‌جا که هر مقداری که نمونه‌برداری می‌کنید
       نشان‌دهندهٔ نوعی حالت گذشته است که سازوکار نمونه‌برداری شما گردآوری کرده،
       برچسب زمانی همیشه در پایان دورهٔ نمونه‌برداری خواهد بود.

       ابزار RRDtool نمونه‌های واقعی را ذخیره نمی‌کند، بلکه بازنمونه‌گیری
       (resampling) درونی بر روی مقادیر ارائه‌شده به آن انجام می‌دهد. با این
       وجود، هنگامی که یک مقدار داده با یک برچسب زمانی منفرد ارائه می‌شود، این
       برچسب زمانی در پایان دوره‌ای قرار دارد که مقدار نمایانگر آن است. توجه
       داشته باشید که خود برچسب زمانی خارج از دوره‌ای است که نمونه برای آن
       معتبر است. برای جزئیات بیشتر در این باره، توضیحات محاسبهٔ PDP را ببینید.

       بنابراین محدودهٔ زمانی برای یک نمونه با یک برچسب زمانی در واقع از
       "timestamp - step" (شامل آن) تا "timestamp" (غیرشامل) است.

       نخستین سطر از خروجی نمونه:

           <row><t>1020611700</t><v>3.4000000000e+00</v><v>5.4400000000e+01</v></row>

       بنابراین بدین معناست که مقادیر بازهٔ 1020611400 تا 1020611699 به ترتیب
       برای «out bytes» و «in and out bits» برابر با 3.4 و 54.4 بوده‌اند، چرا
       که این مقدار در 1020611700 ثبت شده است.

مثال ۱ (EXAMPLE 1)
         rrdtool xport \
                 DEF:out=if1-inouts.rrd:outoctets:AVERAGE \
                 XPORT:out:"out bytes"

مثال ۲ (EXAMPLE 2)
         rrdtool xport \
                 DEF:out1=if1-inouts.rrd:outoctets:AVERAGE \
                 DEF:out2=if2-inouts.rrd:outoctets:AVERAGE \
                 CDEF:sum=out1,out2,+ \
                 XPORT:out1:"if1 out bytes" \
                 XPORT:out2:"if2 out bytes" \
                 XPORT:sum:"output sum"

متغیرهای محیطی (ENVIRONMENT VARIABLES)
       متغیرهای محیطی زیر را می‌توان برای تغییر رفتار "rrdtool xport" به کار
       برد:

       RRDCACHED_ADDRESS
           اگر این متغیر محیطی تنظیم شده باشد، اثری مشابه با مشخص کردن گزینهٔ
           "--daemon" در خط فرمان خواهد داشت. در صورت وجود هر دو، آرگومان خط
           فرمان اولویت دارد.

نویسندگان (AUTHORS)
       Tobias Oetiker <tobi@oetiker.ch>

1.11.0                            2026-08-08                       RRDXPORT(1)