名称
rrdxport - 1つもしくは複数の RRD から XML 形式でデータを出力します。
-------------------------------------------------------------------------------
書式
rrdtool xport
[ -s | --start 開始時刻 ]
[ -e | --end 終了時刻 ]
[ -m | --maxrows 最大データ数 ]
[ --step ステップ ]
[ DEF:仮想名=データベース名:データソース名:統合関数 ]
[ CDEF:仮想名=式 ]
[ XPORT:仮想名[:凡例] ]
-------------------------------------------------------------------------------
解説
xport 機能の主な目的は1つもしくは複数の RRD に格納されているデータを
XML 形式による表現で書き出すことです。数値的なレポートを行うこともできます。
XPORT オプションがないと何も出力されません。
-s | --start 開始時刻 (デフォルトは1日前)
出力するデータ範囲の始まりを指定します。この時刻は起源 (1970年1月1日)
からの経過秒数で指定します。負の値は現在時刻からの相対値となります。
デフォルトでは1日分のデータが出力されます。時刻の指定法に関しては
rrdfetch マニュアルの「AT形式時刻指定法」も参照してください。
-e | --end 終了時刻 (デフォルトは現在)
出力するデータ範囲の終わりを指定します。時刻の指定法に関しては rrdfetch
マニュアルの「AT形式時刻指定法」も参照してください。
-m | --maxrows 最大データ数 (デフォルトは400)
このオプションは rrdgraph の -w | --width オプションと似た挙動をします。
実際のところ全く同じですが、このモジュールでの役割を表すように名前が
変更されています。詳細は rrdgraph マニュアルを参照してください。
--step ステップ (デフォルトは自動設定)
rrdgraph マニュアルを参照してください。
DEF:仮想名=データベース名:データソース名:統合関数
rrdgraph マニュアルを参照してください。
CDEF:仮想名=式
rrdgraph マニュアルを参照してください。
XPORT:仮想名[:凡例]
最低でも1つの XPORT オプションが必要です。「仮想名」で指定される値を
出力します。オプションで「凡例」をつけることができます。
出力形式
出力は XPORT エレメントで囲まれた2つのブロックからなります。最初のブロックは
meta エレメントで囲まれたいくつかのメタデータです。2つめのブロックは data
エレメントで囲まれたデータ列です。
では以下の xport コマンドの出力結果を見ていきましょう:
rrdtool xport \
--start now-1h --end now \
DEF:xx=host-inout.lo.rrd:output:AVERAGE \
DEF:yy=host-inout.lo.rrd:input:AVERAGE \
CDEF:aa=xx,yy,+,8,* \
XPORT:xx:"out bytes" \
XPORT:aa:"in and out bits"
結果のメタデータセクションです (これらの値は RRD に依存しています):
1020611700
300
1020615600
14
2
結果のデータセクションです:
10206117003.4000000000e+005.4400000000e+01
10206120003.4000000000e+005.4400000000e+01
10206123003.4000000000e+005.4400000000e+01
10206126003.4113333333e+005.4581333333e+01
10206129003.4000000000e+005.4400000000e+01
10206132003.4000000000e+005.4400000000e+01
10206135003.4000000000e+005.4400000000e+01
10206138003.4000000000e+005.4400000000e+01
10206141003.4000000000e+005.4400000000e+01
10206144003.4000000000e+005.4400000000e+01
10206147003.7333333333e+005.9733333333e+01
10206150003.4000000000e+005.4400000000e+01
10206153003.4000000000e+005.4400000000e+01
1020615600NaNNaN
--------------------------------------------------------------------------------
例 1
rrdtool xport \
DEF:out=if1-inouts.rrd:outoctets:AVERAGE \
XPORT:out:"out bytes"
--------------------------------------------------------------------------------
例 2
rrdtool xport \
DEF:out1=if1-inouts.rrd:outoctets:AVERAGE \
DEF:out2=if2-inouts.rrd:outoctets:AVERAGE \
CDEF:sum=out1,out2,+ \
XPORT:out1:"if1 out bytes" \
XPORT:out2:"if2 out bytes" \
XPORT:sum:"output sum"
-------------------------------------------------------------------------------
著者
Tobias Oetiker