1 RRDXPORT(1) rrdtool RRDXPORT(1)
6 rrdxport - Export data in XML format based on data from one or several
7 RRD
10 r\brr\brd\bdt\bto\boo\bol\bl x\bxp\bpo\bor\brt\bt [-\b-s\bs|-\b--\b-s\bst\bta\bar\brt\bt _\bs_\be_\bc_\bo_\bn_\bd_\bs] [-\b-e\be|-\b--\b-e\ben\bnd\bd _\bs_\be_\bc_\bo_\bn_\bd_\bs]
11 [-\b-m\bm|-\b--\b-m\bma\bax\bxr\bro\bow\bws\bs _\br_\bo_\bw_\bs] [-\b--\b-s\bst\bte\bep\bp _\bv_\ba_\bl_\bu_\be] [-\b--\b-d\bda\bae\bem\bmo\bon\bn _\ba_\bd_\bd_\br_\be_\bs_\bs]
12 [D\bDE\bEF\bF:\b:_\bv_\bn_\ba_\bm_\be=\b=_\br_\br_\bd:\b:_\bd_\bs_\b-_\bn_\ba_\bm_\be:\b:_\bC_\bF] [C\bCD\bDE\bEF\bF:\b:_\bv_\bn_\ba_\bm_\be=\b=_\br_\bp_\bn_\b-_\be_\bx_\bp_\br_\be_\bs_\bs_\bi_\bo_\bn]
18 extract numerical reports.
23 The time when the exported range should begin. Time in seconds
24 since epoch (1970-01-01) is required. Negative numbers are relative
25 to the current time. By default one day worth of data will be
28 time.
31 The time when the exported range should end. Time in seconds since
34 time.
37 This works like the -\b-w\bw|-\b--\b-w\bwi\bid\bdt\bth\bh parameter of _\br_\br_\bd_\bg_\br_\ba_\bp_\bh. In fact it
38 is exactly the same, but the parameter was renamed to describe its
42 See rrdgraph documentation.
45 Address of the rrdcached daemon. If specified, a "flush" command is
49 option in the rrdcached manual.
51 rrdtool xport --daemon unix:/var/run/rrdcached.sock ...
54 The generated xml should contain the data values in enumerated
55 tags.
57 <v0>val</v0><v1>val</v1>
62 C\bCD\bDE\bEF\bF:\b:_\bv_\bn_\ba_\bm_\be=\b=_\br_\bp_\bn_\b-_\be_\bx_\bp_\br_\be_\bs_\bs_\bi_\bo_\bn
73 rows.
77 rrdtool xport \
78 --start now-1h --end now \
79 DEF:xx=host-inout.lo.rrd:output:AVERAGE \
80 DEF:yy=host-inout.lo.rrd:input:AVERAGE \
81 CDEF:aa=xx,yy,+,8,* \
82 XPORT:xx:"out bytes" \
83 XPORT:aa:"in and out bits"
85 The resulting meta data section is (the values will depend on the RRD
86 characteristics):
88 <meta>
89 <start>1020611700</start>
90 <step>300</step>
91 <end>1020615600</end>
92 <rows>14</rows>
93 <columns>2</columns>
94 <legend>
95 <entry>out bytes</entry>
96 <entry>in and out bits</entry>
97 </legend>
98 </meta>
100 The resulting data section is:
102 <data>
103 <row><t>1020611700</t><v>3.4000000000e+00</v><v>5.4400000000e+01</v></row>
104 <row><t>1020612000</t><v>3.4000000000e+00</v><v>5.4400000000e+01</v></row>
105 <row><t>1020612300</t><v>3.4000000000e+00</v><v>5.4400000000e+01</v></row>
106 <row><t>1020612600</t><v>3.4113333333e+00</v><v>5.4581333333e+01</v></row>
107 <row><t>1020612900</t><v>3.4000000000e+00</v><v>5.4400000000e+01</v></row>
108 <row><t>1020613200</t><v>3.4000000000e+00</v><v>5.4400000000e+01</v></row>
109 <row><t>1020613500</t><v>3.4000000000e+00</v><v>5.4400000000e+01</v></row>
110 <row><t>1020613800</t><v>3.4000000000e+00</v><v>5.4400000000e+01</v></row>
111 <row><t>1020614100</t><v>3.4000000000e+00</v><v>5.4400000000e+01</v></row>
112 <row><t>1020614400</t><v>3.4000000000e+00</v><v>5.4400000000e+01</v></row>
113 <row><t>1020614700</t><v>3.7333333333e+00</v><v>5.9733333333e+01</v></row>
114 <row><t>1020615000</t><v>3.4000000000e+00</v><v>5.4400000000e+01</v></row>
115 <row><t>1020615300</t><v>3.4000000000e+00</v><v>5.4400000000e+01</v></row>
116 <row><t>1020615600</t><v>NaN</v><v>NaN</v></row>
117 </data>
120 rrdtool xport \
121 DEF:out=if1-inouts.rrd:outoctets:AVERAGE \
122 XPORT:out:"out bytes"
125 rrdtool xport \
126 DEF:out1=if1-inouts.rrd:outoctets:AVERAGE \
127 DEF:out2=if2-inouts.rrd:outoctets:AVERAGE \
128 CDEF:sum=out1,out2,+ \
129 XPORT:out1:"if1 out bytes" \
130 XPORT:out2:"if2 out bytes" \
131 XPORT:sum:"output sum"
134 The following environment variables may be used to change the behavior
135 of "rrdtool xport":
138 If this environment variable is set it will have the same effect as
139 specifying the "--daemon" option on the command line. If both are
140 present, the command line argument takes precedence.
143 Tobias Oetiker <tobi@oetiker.ch>
147 1.3.99909060808 2008-09-25 RRDXPORT(1)