doc/rrdxport.html

   1 <?xml version="1.0" ?>
   2 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
   3 <html xmlns="http://www.w3.org/1999/xhtml">
   4 <head>
   5 <title>rrdxport</title>
   6 <meta http-equiv="content-type" content="text/html; charset=utf-8" />
   7 <link rev="made" href="mailto:root@localhost" />
   8 </head>
   9
  10 <body style="background-color: white">
  11
  12
  13 <!-- INDEX BEGIN -->
  14 <div name="index">
  15 <p><a name="__index__"></a></p>
  16 <!--
  17
  18 <ul>
  19
  20         <li><a href="#name">NAME</a></li>
  21         <li><a href="#synopsis">SYNOPSIS</a></li>
  22         <li><a href="#description">DESCRIPTION</a></li>
  23         <li><a href="#output_format">Output format</a></li>
  24         <li><a href="#example_1">EXAMPLE 1</a></li>
  25         <li><a href="#example_2">EXAMPLE 2</a></li>
  26         <li><a href="#author">AUTHOR</a></li>
  27 </ul>
  28
  29 -->
  30
  31
  32 </div>
  33 <!-- INDEX END -->
  34
  35 <p>
  36 </p>
  37 <h1><a name="name">NAME</a></h1>
  38 <p>rrdxport - Export data in XML format based on data from one or several RRD</p>
  39 <p>
  40 </p>
  41 <hr />
  42 <h1><a name="synopsis">SYNOPSIS</a></h1>
  43 <p><strong>rrdtool</strong> <strong>xport</strong>
  44 [<strong>-s</strong>|<strong>--start</strong>&nbsp;<em>seconds</em>]
  45 [<strong>-e</strong>|<strong>--end</strong>&nbsp;<em>seconds</em>]
  46 [<strong>-m</strong>|<strong>--maxrows</strong>&nbsp;<em>rows</em>]
  47 [<strong>--step</strong>&nbsp;<em>value</em>]
  48 [<strong>DEF:</strong><em>vname</em><strong>=</strong><em>rrd</em><strong>:</strong><em>ds-name</em><strong>:</strong><em>CF</em>]
  49 [<strong>CDEF:</strong><em>vname</em><strong>=</strong><em>rpn-expression</em>]
  50 [<strong>XPORT</strong><strong>:</strong><em>vname</em>[<strong>:</strong><em>legend</em>]]</p>
  51 <p>
  52 </p>
  53 <hr />
  54 <h1><a name="description">DESCRIPTION</a></h1>
  55 <p>The <strong>xport</strong> function's main purpose is to write an XML formatted
  56 representation of the data stored in one or several <strong>RRD</strong>s. It
  57 can also extract numerical reports.</p>
  58 <p>If no <em>XPORT</em> statements are found, there will be no output.</p>
  59 <dl>
  60 <dt><strong><a name="seconds" class="item"><strong>-s</strong>|<strong>--start</strong> <em>seconds</em> (default end-1day)</a></strong></dt>
  61
  62 <dd>
  63 <p>The time when the exported range should begin. Time in seconds since
  64 epoch (1970-01-01) is required. Negative numbers are relative to the
  65 current time. By default one day worth of data will be printed.
  66 See also AT-STYLE TIME SPECIFICATION section in the <em>rrdfetch</em>
  67 documentation for a detailed explanation on how to specify time.</p>
  68 </dd>
  69 <dt><strong><strong>-e</strong>|<strong>--end</strong> <em>seconds</em> (default now)</strong></dt>
  70
  71 <dd>
  72 <p>The time when the exported range should end. Time in seconds since epoch.
  73 See also AT-STYLE TIME SPECIFICATION section in the <em>rrdfetch</em>
  74 documentation for a detailed explanation of ways to specify time.</p>
  75 </dd>
  76 <dt><strong><a name="rows" class="item"><strong>-m</strong>|<strong>--maxrows</strong> <em>rows</em> (default 400 rows)</a></strong></dt>
  77
  78 <dd>
  79 <p>This works like the <strong>-w</strong>|<strong>--width</strong> parameter of <em>rrdgraph</em>.
  80 In fact it is exactly the same, but the parameter was renamed to
  81 describe its purpose in this module. See <em>rrdgraph</em> documentation
  82 for details.</p>
  83 </dd>
  84 <dt><strong><a name="value" class="item"><strong>--step</strong> <em>value</em> (default automatic)</a></strong></dt>
  85
  86 <dd>
  87 <p>See <a href="././rrdgraph.html">the rrdgraph manpage</a> documentation.</p>
  88 </dd>
  89 <dt><strong><a name="enumds" class="item"><strong>--enumds</strong></a></strong></dt>
  90
  91 <dd>
  92 <p>The generated xml should contain the data values in enumerated tags.</p>
  93 <pre>
  94  &lt;v0&gt;val&lt;/v0&gt;&lt;v1&gt;val&lt;/v1&gt;</pre>
  95 </dd>
  96 <dt><strong><a name="def_vname_rrd_ds_name_cf" class="item"><strong>DEF:</strong><em>vname</em><strong>=</strong><em>rrd</em><strong>:</strong><em>ds-name</em><strong>:</strong><em>CF</em></a></strong></dt>
  97
  98 <dd>
  99 <p>See <em>rrdgraph</em> documentation.</p>
 100 </dd>
 101 <dt><strong><a name="cdef_vname_rpn_expression" class="item"><strong>CDEF:</strong><em>vname</em><strong>=</strong><em>rpn-expression</em></a></strong></dt>
 102
 103 <dd>
 104 <p>See <em>rrdgraph</em> documentation.</p>
 105 </dd>
 106 <dt><strong><a name="xport_vname_legend" class="item"><strong>XPORT:</strong><em>vname</em><strong>:</strong><strong>:</strong><em>legend</em></a></strong></dt>
 107
 108 <dd>
 109 <p>At least one <em>XPORT</em> statement should be present. The values
 110 referenced by <em>vname</em> are printed. Optionally add a legend.</p>
 111 </dd>
 112 </dl>
 113 <p>
 114 </p>
 115 <hr />
 116 <h1><a name="output_format">Output format</a></h1>
 117 <p>The output is enclosed in an <strong>xport</strong> element and contains two
 118 blocks. The first block is enclosed by a <strong>meta</strong> element and
 119 contains some meta data. The second block is enclosed by a
 120 <strong>data</strong> element and contains the data rows.</p>
 121 <p>Let's assume that the <em>xport</em> command looks like this:</p>
 122 <pre>
 123   rrdtool xport \
 124           --start now-1h --end now \
 125           DEF:xx=host-inout.lo.rrd:output:AVERAGE \
 126           DEF:yy=host-inout.lo.rrd:input:AVERAGE \
 127           CDEF:aa=xx,yy,+,8,* \
 128           XPORT:xx:&quot;out bytes&quot; \
 129           XPORT:aa:&quot;in and out bits&quot;</pre>
 130 <p>The resulting meta data section is (the values will depend on the
 131 RRD characteristics):</p>
 132 <pre>
 133   &lt;meta&gt;
 134     &lt;start&gt;1020611700&lt;/start&gt;
 135     &lt;step&gt;300&lt;/step&gt;
 136     &lt;end&gt;1020615600&lt;/end&gt;
 137     &lt;rows&gt;14&lt;/rows&gt;
 138     &lt;columns&gt;2&lt;/columns&gt;
 139     &lt;legend&gt;
 140       &lt;entry&gt;out bytes&lt;/entry&gt;
 141       &lt;entry&gt;in and out bits&lt;/entry&gt;
 142     &lt;/legend&gt;
 143   &lt;/meta&gt;</pre>
 144 <p>The resulting data section is:</p>
 145 <pre>
 146   &lt;data&gt;
 147     &lt;row&gt;&lt;t&gt;1020611700&lt;/t&gt;&lt;v&gt;3.4000000000e+00&lt;/v&gt;&lt;v&gt;5.4400000000e+01&lt;/v&gt;&lt;/row&gt;
 148     &lt;row&gt;&lt;t&gt;1020612000&lt;/t&gt;&lt;v&gt;3.4000000000e+00&lt;/v&gt;&lt;v&gt;5.4400000000e+01&lt;/v&gt;&lt;/row&gt;
 149     &lt;row&gt;&lt;t&gt;1020612300&lt;/t&gt;&lt;v&gt;3.4000000000e+00&lt;/v&gt;&lt;v&gt;5.4400000000e+01&lt;/v&gt;&lt;/row&gt;
 150     &lt;row&gt;&lt;t&gt;1020612600&lt;/t&gt;&lt;v&gt;3.4113333333e+00&lt;/v&gt;&lt;v&gt;5.4581333333e+01&lt;/v&gt;&lt;/row&gt;
 151     &lt;row&gt;&lt;t&gt;1020612900&lt;/t&gt;&lt;v&gt;3.4000000000e+00&lt;/v&gt;&lt;v&gt;5.4400000000e+01&lt;/v&gt;&lt;/row&gt;
 152     &lt;row&gt;&lt;t&gt;1020613200&lt;/t&gt;&lt;v&gt;3.4000000000e+00&lt;/v&gt;&lt;v&gt;5.4400000000e+01&lt;/v&gt;&lt;/row&gt;
 153     &lt;row&gt;&lt;t&gt;1020613500&lt;/t&gt;&lt;v&gt;3.4000000000e+00&lt;/v&gt;&lt;v&gt;5.4400000000e+01&lt;/v&gt;&lt;/row&gt;
 154     &lt;row&gt;&lt;t&gt;1020613800&lt;/t&gt;&lt;v&gt;3.4000000000e+00&lt;/v&gt;&lt;v&gt;5.4400000000e+01&lt;/v&gt;&lt;/row&gt;
 155     &lt;row&gt;&lt;t&gt;1020614100&lt;/t&gt;&lt;v&gt;3.4000000000e+00&lt;/v&gt;&lt;v&gt;5.4400000000e+01&lt;/v&gt;&lt;/row&gt;
 156     &lt;row&gt;&lt;t&gt;1020614400&lt;/t&gt;&lt;v&gt;3.4000000000e+00&lt;/v&gt;&lt;v&gt;5.4400000000e+01&lt;/v&gt;&lt;/row&gt;
 157     &lt;row&gt;&lt;t&gt;1020614700&lt;/t&gt;&lt;v&gt;3.7333333333e+00&lt;/v&gt;&lt;v&gt;5.9733333333e+01&lt;/v&gt;&lt;/row&gt;
 158     &lt;row&gt;&lt;t&gt;1020615000&lt;/t&gt;&lt;v&gt;3.4000000000e+00&lt;/v&gt;&lt;v&gt;5.4400000000e+01&lt;/v&gt;&lt;/row&gt;
 159     &lt;row&gt;&lt;t&gt;1020615300&lt;/t&gt;&lt;v&gt;3.4000000000e+00&lt;/v&gt;&lt;v&gt;5.4400000000e+01&lt;/v&gt;&lt;/row&gt;
 160     &lt;row&gt;&lt;t&gt;1020615600&lt;/t&gt;&lt;v&gt;NaN&lt;/v&gt;&lt;v&gt;NaN&lt;/v&gt;&lt;/row&gt;
 161   &lt;/data&gt;</pre>
 162 <p>
 163 </p>
 164 <hr />
 165 <h1><a name="example_1">EXAMPLE 1</a></h1>
 166 <pre>
 167   rrdtool xport \
 168           DEF:out=if1-inouts.rrd:outoctets:AVERAGE \
 169           XPORT:out:&quot;out bytes&quot;</pre>
 170 <p>
 171 </p>
 172 <hr />
 173 <h1><a name="example_2">EXAMPLE 2</a></h1>
 174 <pre>
 175   rrdtool xport \
 176           DEF:out1=if1-inouts.rrd:outoctets:AVERAGE \
 177           DEF:out2=if2-inouts.rrd:outoctets:AVERAGE \
 178           CDEF:sum=out1,out2,+ \
 179           XPORT:out1:&quot;if1 out bytes&quot; \
 180           XPORT:out2:&quot;if2 out bytes&quot; \
 181           XPORT:sum:&quot;output sum&quot;</pre>
 182 <p>
 183 </p>
 184 <hr />
 185 <h1><a name="author">AUTHOR</a></h1>
 186 <p>Tobias Oetiker &lt;<a href="mailto:tobi@oetiker.ch">tobi@oetiker.ch</a>&gt;</p>
 187
 188 </body>
 189
 190 </html>