名称 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 out bytes in and out bits 結果のデータセクションです: 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