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)