檢視 RRDtool 的原始碼

'''RRDtool'''是一套[[TSDB]]。

== 概念 ==

主要的兩個概念是DS與RRA。

=== DS ===

Data Sources（DS）比較好理解，定義資料，依照官方的說明是：

<pre>DS:ds-name:{GAUGE | COUNTER | DERIVE | DCOUNTER | DDERIVE | ABSOLUTE}:heartbeat:min:max</pre>

其中：

* <code>DS</code>表示這是DS。
* <code>ds-name</code>是自己定義的名稱。
* <code>GAUGE</code>這串挑一個用。
* <code>heartbeat</code>表示單一一個數字表示的有效時間，平常用不太到，但遇到前後有缺資料的時候會使用者個設定。
* <code>min</code>與<code>max</code>表示這個資料的範圍區間。

所以像是這樣的DS定義就是將<code>foo</code>定成uint32，有效區間五分鐘：

<pre>DS:foo:COUNTER:5m:0:4294967295</pre>

=== RRA ===

Round Robin Archive（RRA）是定義要存的資料量，最基礎的定義是：

<pre>RRA:{AVERAGE | MIN | MAX | LAST}:xff:steps:rows</pre>

其中：

* <code>RRA</code>表示這是一個RRA。
* <code>AVERAGE</code>這串挑一個用。
* <code>xff</code>需要設定為<math>[0,1)</math>的值（也就是「大於等於0但小於1」的值），常常用<code>0.5</code>（取中間）。
* <code>steps</code>表示取樣數量。
* <code>rows</code>表示產出數量（保留在RRD資料庫的數量）。

舉例來說，我想要有小時平均值的數據，然後保留一天：

<pre>RRA:AVERAGE:0.5:1h:1d</pre>

== 安裝 ==

一般透過系統的套件就可以直接安裝：

<syntaxhighlight lang="bash">
sudo apt install -y rrdtool; sudo apt clean
</syntaxhighlight>

== 範例 ==

先建立一個<code>test.rrd</code>：

<syntaxhighlight lang="bash">
rrdtool create test.rrd --start 19800101 --step 5m DS:foo:COUNTER:5m:0:4294967295 RRA:AVERAGE:0.5:1h:1d
</syntaxhighlight>

馬上就可以dump成XML：

<syntaxhighlight lang="bash">
rrdtool dump test.rrd
</syntaxhighlight>

加入資料：

<syntaxhighlight lang="bash">
rrdtool update test.rrd N:100
</syntaxhighlight>

== 外部連結 ==

* {{Official|https://rrdtool.org/}}

[[Category:軟體]]