doc/rrdresize.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>rrdresize</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="#notes">NOTES</a></li>
  24         <li><a href="#author">AUTHOR</a></li>
  25 </ul>
  26
  27 -->
  28
  29
  30 </div>
  31 <!-- INDEX END -->
  32
  33 <p>
  34 </p>
  35 <h1><a name="name">NAME</a></h1>
  36 <p>rrdresize - alters the size of an RRA and creates a new .rrd file</p>
  37 <p>
  38 </p>
  39 <hr />
  40 <h1><a name="synopsis">SYNOPSIS</a></h1>
  41 <p><strong>rrdtool</strong> <strong>resize</strong> <em>filename</em> <em>rra-num</em>  <strong>GROW</strong><em>|</em><strong>SHRINK</strong> <em>rows</em></p>
  42 <p>
  43 </p>
  44 <hr />
  45 <h1><a name="description">DESCRIPTION</a></h1>
  46 <p>The <strong>resize</strong> function is used to modify the number of rows in
  47 an <strong>RRA</strong>.</p>
  48 <dl>
  49 <dt><strong><a name="filename" class="item"><em>filename</em></a></strong></dt>
  50
  51 <dd>
  52 <p>the name of the <strong>RRD</strong> you want to alter.</p>
  53 </dd>
  54 <dt><strong><a name="rra_num" class="item"><em>rra-num</em></a></strong></dt>
  55
  56 <dd>
  57 <p>the <strong>RRA</strong> you want to alter. You can find the number using <strong>rrdtool info</strong>.</p>
  58 </dd>
  59 <dt><strong><a name="grow" class="item"><strong>GROW</strong></a></strong></dt>
  60
  61 <dd>
  62 <p>used if you want to add extra rows to an RRA. The extra rows will be inserted
  63 as the rows that are oldest.</p>
  64 </dd>
  65 <dt><strong><a name="shrink" class="item"><strong>SHRINK</strong></a></strong></dt>
  66
  67 <dd>
  68 <p>used if you want to remove rows from an RRA. The rows that will be removed
  69 are the oldest rows.</p>
  70 </dd>
  71 <dt><strong><a name="rows" class="item"><em>rows</em></a></strong></dt>
  72
  73 <dd>
  74 <p>the number of rows you want to add or remove.</p>
  75 </dd>
  76 </dl>
  77 <p>
  78 </p>
  79 <hr />
  80 <h1><a name="notes">NOTES</a></h1>
  81 <p>The new .rrd file, with the modified RRAs, is written to the file
  82 <strong>resize.rrd</strong> in the current directory.  <strong>The original .rrd file is not
  83 modified</strong>.</p>
  84 <p>It is possible to abuse this tool and get strange results
  85 by first removing some rows and then reinserting the same amount (effectively
  86 clearing them to be Unknown). You may thus end up with unknown data in one
  87 RRA while at the same timestamp this data is available in another RRA.</p>
  88 <p>
  89 </p>
  90 <hr />
  91 <h1><a name="author">AUTHOR</a></h1>
  92 <p>Alex van den Bogaerdt &lt;<a href="mailto:alex@vandenbogaerdt.nl">alex@vandenbogaerdt.nl</a>&gt;</p>
  93
  94 </body>
  95
  96 </html>