← Back to branch summary

~ubuntu-branches/ubuntu/maverick/rrdtool/maverick

« back to all changes in this revision

Viewing changes to doc/rrdcreate.html

  • Committer: Bazaar Package Importer
  • Author(s): Clint Byrum
  • Date: 2010-07-22 08:07:01 UTC
  • mfrom: (1.2.8 upstream) (3.1.6 sid)
  • Revision ID: james.westby@ubuntu.com-20100722080701-k46mgdfz6euxwqsm
Tags: 1.4.3-1ubuntu1
* Merge from debian unstable, Remaining changes:
  - debian/control: Don't build against ruby1.9 as we don't want
    it in main.
* require libdbi >= 0.8.3 to prevent aborts when using dbi datasources

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/rrdcreate.html
25
25
                <li><a href="#filename"><em>filename</em></a></li>
26
26
                <li><a href="#__start__b_start_time__default__now___10s_"><strong>-start</strong>|<strong>-b</strong> <em>start time</em> (default: now - 10s)</a></li>
27
27
                <li><a href="#__step__s_step__default__300_seconds_"><strong>-step</strong>|<strong>-s</strong> <em>step</em> (default: 300 seconds)</a></li>
 
28
                <li><a href="#__no_overwrite"><strong>-no-overwrite</strong></a></li>
28
29
                <li><a href="#ds_ds_name_dst_dst_arguments"><strong>DS:</strong><em>ds-name</em><strong>:</strong><em>DST</em><strong>:</strong><em>dst arguments</em></a></li>
29
30
                <li><a href="#rra_cf_cf_arguments"><strong>RRA:</strong><em>CF</em><strong>:</strong><em>cf arguments</em></a></li>
30
31
        </ul>
55
56
<p><strong>rrdtool</strong> <strong>create</strong> <em>filename</em>
56
57
[<strong>--start</strong>|<strong>-b</strong>&nbsp;<em>start&nbsp;time</em>]
57
58
[<strong>--step</strong>|<strong>-s</strong>&nbsp;<em>step</em>]
 
59
[<strong>--no-overwrite</strong>]
58
60
[<strong>DS:</strong><em>ds-name</em><strong>:</strong><em>DST</em><strong>:</strong><em>dst&nbsp;arguments</em>]
59
61
[<strong>RRA:</strong><em>CF</em><strong>:</strong><em>cf&nbsp;arguments</em>]</p>
60
62
<p>
85
87
into the <strong>RRD</strong>.</p>
86
88
<p>
87
89
</p>
 
90
<h2><a name="__no_overwrite"><strong>--no-overwrite</strong></a></h2>
 
91
<p>Do not clobber an existing file of the same name.</p>
 
92
<p>
 
93
</p>
88
94
<h2><a name="ds_ds_name_dst_dst_arguments"><strong>DS:</strong><em>ds-name</em><strong>:</strong><em>DST</em><strong>:</strong><em>dst arguments</em></a></h2>
89
95
<p>A single <strong>RRD</strong> can accept input from several data sources (<strong>DS</strong>),
90
96
for example incoming and outgoing traffic on a specific communication
406
412
more than <strong>half</strong> the &quot;step&quot;, the entire PDP is marked
407
413
as &quot;unknown&quot;. This means that a mixture of known and &quot;unknown&quot; sample
408
414
times in a single PDP &quot;step&quot; may or may not add up to enough &quot;known&quot;
409
 
time to warrent for a known PDP.</p>
 
415
time to warrant a known PDP.</p>
410
416
<p>The &quot;heartbeat&quot; can be short (unusual) or long (typical) relative to
411
417
the &quot;step&quot; interval between PDPs. A short &quot;heartbeat&quot; means you
412
418
require multiple samples per PDP, and if you don't get them mark the
472
478
 
473
479
<dd>
474
480
<p>Assume you have a method to count the number of messages transported by
475
 
your mailserver in a certain amount of time, giving you data like '5
 
481
your mail server in a certain amount of time, giving you data like '5
476
482
messages in the last 65 seconds'. If you look at the count of 5 like an
477
483
<strong>ABSOLUTE</strong> data type you can simply update the RRD with the number 5 and the
478
484
end time of your monitoring period. RRDtool will then record the number of