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-j\bjs\bso\bon\bn] [-\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
26 printed. See also AT-STYLE TIME SPECIFICATION section in the
28 time.
31 The time when the exported range should end. Time in seconds since
32 epoch. See also AT-STYLE TIME SPECIFICATION section in the
34 specify 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
46 sent to the server before reading the RRD files. This allows
48 cache values for a long time. For a list of accepted formats, see
51 rrdtool xport --daemon unix:/var/run/rrdcached.sock ...
54 produce json formated output (instead of xml)
57 The generated xml should contain the data values in enumerated
58 tags.
60 <v0>val</v0><v1>val</v1>
65 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
76 rows.
80 rrdtool xport \
81 --start now-1h --end now \
82 DEF:xx=host-inout.lo.rrd:output:AVERAGE \
83 DEF:yy=host-inout.lo.rrd:input:AVERAGE \
84 CDEF:aa=xx,yy,+,8,* \
85 XPORT:xx:"out bytes" \
86 XPORT:aa:"in and out bits"
88 The resulting meta data section is (the values will depend on the RRD
89 characteristics):
91 <meta>
92 <start>1020611700</start>
93 <step>300</step>
94 <end>1020615600</end>
95 <rows>14</rows>
96 <columns>2</columns>
97 <legend>
98 <entry>out bytes</entry>
99 <entry>in and out bits</entry>
100 </legend>
101 </meta>
103 The resulting data section is:
105 <data>
106 <row><t>1020611700</t><v>3.4000000000e+00</v><v>5.4400000000e+01</v></row>
107 <row><t>1020612000</t><v>3.4000000000e+00</v><v>5.4400000000e+01</v></row>
108 <row><t>1020612300</t><v>3.4000000000e+00</v><v>5.4400000000e+01</v></row>
109 <row><t>1020612600</t><v>3.4113333333e+00</v><v>5.4581333333e+01</v></row>
110 <row><t>1020612900</t><v>3.4000000000e+00</v><v>5.4400000000e+01</v></row>
111 <row><t>1020613200</t><v>3.4000000000e+00</v><v>5.4400000000e+01</v></row>
112 <row><t>1020613500</t><v>3.4000000000e+00</v><v>5.4400000000e+01</v></row>
113 <row><t>1020613800</t><v>3.4000000000e+00</v><v>5.4400000000e+01</v></row>
114 <row><t>1020614100</t><v>3.4000000000e+00</v><v>5.4400000000e+01</v></row>
115 <row><t>1020614400</t><v>3.4000000000e+00</v><v>5.4400000000e+01</v></row>
116 <row><t>1020614700</t><v>3.7333333333e+00</v><v>5.9733333333e+01</v></row>
117 <row><t>1020615000</t><v>3.4000000000e+00</v><v>5.4400000000e+01</v></row>
118 <row><t>1020615300</t><v>3.4000000000e+00</v><v>5.4400000000e+01</v></row>
119 <row><t>1020615600</t><v>NaN</v><v>NaN</v></row>
120 </data>
123 rrdtool xport \
124 DEF:out=if1-inouts.rrd:outoctets:AVERAGE \
125 XPORT:out:"out bytes"
128 rrdtool xport \
129 DEF:out1=if1-inouts.rrd:outoctets:AVERAGE \
130 DEF:out2=if2-inouts.rrd:outoctets:AVERAGE \
131 CDEF:sum=out1,out2,+ \
132 XPORT:out1:"if1 out bytes" \
133 XPORT:out2:"if2 out bytes" \
134 XPORT:sum:"output sum"
137 The following environment variables may be used to change the behavior
138 of "rrdtool xport":
141 If this environment variable is set it will have the same effect as
142 specifying the "--daemon" option on the command line. If both are
143 present, the command line argument takes precedence.
146 Tobias Oetiker <tobi@oetiker.ch>
150 1.4.8 2013-05-23 RRDXPORT(1)