web-dev-qa-db-ja.com

rrddump XML形式のドキュメントはどこにありますか？

サーバーのメトリックを格納するためにrrdtoolを使用しており、rrddumpコマンドを使用してこのrrdをXMLにダンプしたいと考えています。したがって、このXML形式のドキュメントが必要です。これはどこにありますか？

rrdtool
5
shreyas

RRDファイルのXML形式に特化したドキュメントはありませんが、バイナリRRD形式のドキュメントから次のように導き出すことができます。

このガイドは、次のサイトの情報からまとめられています。

RrdtoolWebサイトのドキュメントも参照してください。

RRDXMLファイルの基本構造は次のとおりです。

<rrd> <version /> <step /> <lastupdate />
  <ds> <name /> <type /> <step /> <minimal_heartbeat /> <min /> <max /> <last_ds /> <value /> <unknown_sec /> </ds> ...
  <rra> <cf /> <pdp_per_row /> <xff />
    <cdp_prep> <ds> <value /> <unknown_datapoints /> </ds> ... <cdp_prep>
    <database> <row> <v /> ... </row> ... </database>
  </rra>... 
</rrd>

このアドホック構文定義では、要素のカーディナリティが1以上であることを示すために省略記号（...）を使用しました。

この構造は次のように説明できます。各ラウンドロビンデータベース（<rrd>）には、1つ以上のデータソース（<ds>）と1つ以上のラウンドロビンアーカイブ（<rra>）があります。各<rra>には、複数の行（<row>）を持つデータベース（<database>）が含まれています。各<行>には複数の値（<v>）があり、その数は<rrd>に定義されたデータソースの数（<ds>）に対応します。

データソース要素（<ds>）は、監視される各データソース（DS）のデータ特性を定義します。

  • <名前>：DSのフリーテキスト名
  • <ステップ>：データ収集のサンプルレート（秒単位）。各プライマリデータポイント（PDP）は、最後のPDPから正確に数秒後の時点でデータを格納すると想定されます。指定されていない場合、デフォルト値300が使用されます。
  • <タイプ>：キャプチャされた測定のタイプ-{COUNTER |派生|絶対| GAUGE} A DS COUNTERとして宣言すると、ステップ期間中の値の変化率が保存されます。これは、値が常に増加していることを前提としています（現在の値と前の値の差が大きい）。ルーターのトラフィックカウンターは、COUNTERをDSTとして使用するための理想的な候補です。DERIVEはCOUNTERと同じですが、負の値も許可されます。サーバーの空きディスク容量の変化率を確認する場合、次に、DERIVEデータタイプを使用することをお勧めします。ABSOLUTEも変更率を保存しますが、前の値が0に設定されていることを前提としています。現在の値と前の値の差は常に現在の値と等しくなります。GAUGE変化率を保存しません。実際の値自体を保存します。除算や計算はありません。サーバーのメモリ消費量は、ゲージの典型的な例です。
  • <minimal_heartbeat>：更新なしで実行できる最大時間（秒単位）。たとえば、minimal_heartbeat = 120で、値が聞こえずに120秒を超えると、この間隔のプライマリデータポイントはUNKNOWNに設定されます。
  • <min>：データソースの記録可能な最小値
  • <max>：データソースの記録可能な最大値
  • <last_ds>：??
  • <値>：??

ラウンドロビンアーカイブ要素（<rra>）は、RRD内の各アーカイブの測定特性を定義します。

アーカイブは、定義された各データソース（DS）の多数のデータ値または統計で構成されます。 <rra>の要素は次のとおりです。

  • <cf>：アーカイブの統合機能-{AVERAGE | MIN | MAX |最後の}。 PDPは、統合機能に基づいて集約またはフィルタリングされます。
  • <pdp_per_row>：記録された値を構成するPDPの数。 pdp_per_rowが1より大きい場合、PDPは<cf>に基づいて集約またはフィルタリングされます。 <pdp_per_row>とDS <step>の積は、<rra>の各レコードのサンプルレートを秒単位で示します。たとえば、DS <step> = 300および<pdp_per_row> = 6 <rra> = 1800秒のサンプルレート。
  • <xff>：「XFilesFactor（XFF）」。記録された値を不明にすることなく不明になる可能性があるPDPのパーセンテージ。
  • <cdp-prep>：??
  • <データベース>：<rra>によって保存されたデータ。 <データベース>は複数の<行>要素で構成され、各要素には<rrd>に対して定義されたデータソース要素（<ds>）の数に等しい数の<v>要素があります。 <v>要素は、rrdupdate関数呼び出しによってRRDファイルに書き込まれるサンプルデータを格納します。つまり、RRDがインターフェイスしている監視ツールによって生成されたデータです。

説明が見つからなかった要素がいくつかあります。それらは??とマークされています。

7
Richard Scrivener

Rrddumpによって生成されたXMLを調べ、rrdtoolがどのように機能するかについての基本的な知識がある場合、その形式は非常に自己記述的です。私はドキュメントを知りません。

2
womble

実際のソースコードコメントを見てください：

https://github.com/oetiker/rrdtool-1.x/blob/42a4e5bd50898968596d201972b78daef18b855f/src/rrd_format.h#L48

0
sjas