SADF

Section: Linuxユーザーズマニュアル (1)
Updated: 2026年 8月
Index JM Home Page roff page
 

名前

sadf - sarによって収集されたデータを複数の形式で表示します。

 

書式

sadf [ -C ] [ -c | -d | -g | -j | -l | -p | -r | -x ] [ -H ] [ -h ] [ -T | -t | -U ] [ -V ] [ -O opts [,...] ] [ -P { cpu_list | ALL } ] [ -s [ start_time ] ] ] [ -e [ end_time ] ] ] [ --dev=dev_list ] [ --fs=fs_list ] [ --iface=iface_list] [ --int=int_list ] [ -- sar_options ] [ interval [ count ] ] [ datafile | -[0-9]+ ]

 

説明

sadfコマンドは、sar(1) コマンドによって作成されたデータファイルの内容を表示するために使用されます。sar とは異なり、sadf はデータをさまざまな形式 (CSV、XMLなど) で書き込むことができます。既定の形式は、awk (オプション -p を参照) のようなパターン処理コマンドで簡単に処理できる形式です。sadf コマンドを使用して、sar によって収集されたさまざまなアクティビティのグラフを描画し、それらをWebブラウザに SVG (Scalable Vector Graphics) グラフィックとして表示することもできます (オプション -g を参照)。

sadf コマンドは、datafile ファイルに保存されている標準出力レコードを抽出して書き込みます。このファイルは、sadf と互換性がある sar のバージョンで作成されている必要があります。datafile を省略すると、sadf は標準のシステムアクティビティ日次データファイルを使用します。sadf には引数として -1、-2 などを指定することもでき、その場合、過去のデータが表示できます。たとえば、-1 は昨日の標準システムアクティビティファイルを指します。

標準のシステムアクティビティの日次データファイルは、saDD または saYYYYMMDD です。ここで、YYYY は現在の年、MM は現在の月、DD は現在の日を表します。sadf は、saDD および saYYYYMMDD の最新のものを検索し、それを使用します。既定では、/var/log/sa ディレクトリにあります。ただし、別の場所を指定することもできます。datafile が (プレーンファイルではなく) ディレクトリである場合、標準のシステムアクティビティ日次データファイルが配置されているディレクトリと見なされます。

interval およびcount パラメータは、sadf に interval 秒間隔で count レコードを選択するよう指示するために使用されます。count パラメータが設定されていない場合、データファイルに保存されているすべてのレコードが表示されます。

sar のすべてのアクティビティフラグは、どのアクティビティが報告されるべきかを示すためにコマンド行に入力することができます。フラグを指定する前に、sadf のフラグと混同しないように、コマンド行にダッシュのペア (--) を付けます。フラグを指定しない場合は、CPUアクティビティのみが選択されます。

 

オプション

-C
sadf にファイルに存在するコメントを表示するように指示します。
-c
古いシステムアクティビティバイナリデータファイル (バージョン 9.1.6以降) を最新の形式に変換します。次の構文を使用します:

sadf -c old_datafile > new_datafile

変換は、オプション -O (下記参照) を使用して制御できます。

-d
リレーショナルデータベースシステムに簡単に取り込める形式で、データファイルの内容を出力します。出力は、セミコロンで区切られたフィールドで構成されます。各レコードには、ファイルが作成されたホストのホスト名、間隔の値 (得られない場合は -1)、ほとんどのデータベースで容易に受け入れられる形式のタイムスタンプ、および sar_options コマンド行オプションで指定されたセミコロンで区切られた追加のデータフィールドが含まれます。タイムスタンプ出力はオプション -T、-t および -U で制御できることに注意してください。
--dev=dev_list
そのデバイスの統計情報を sadf によって表示されるブロックデバイスを指定します。dev_list は、カンマで区切られたデバイス名のリストです。sar のオプション-d を使うのに便利です。.

-e [ hh:mm[:ss] ]
-e [ seconds_since_the_epoch ]

レポートの終了時間を設定します。終了時間の既定値は 18:00:00 です。時間は、24時間形式で指定するか、特定の時刻 (10桁の数字で指定) からの経過秒数で指定する必要があります。
--fs=fs_list
sadfで統計が表示されるファイルシステムを指定します。fs_list は、カンマで区切られたファイルシステムデバイス名やマウントポイントのリストです。どちらの形式もフィルタリングに受け入れられます。sar のオプション -F を使うのに便利です。
-g
データファイルの内容を SVG (Scalable Vector Graphics) 形式で出力します。このオプションを使用すると、Web ブラウザに高度なグラフを表示できます。次の構文を使用します:

sadf -g your_datafile [ -- sar_options ] > output.svg

生成された SVG ファイルを任意の Web ブラウザで開きます。出力は、オプション -O (下記参照) を使用して制御できます。

-H
レポートのヘッダーのみを表示します (該当する場合)。フォーマットが指定されていない場合は、データファイルのヘッダデータ (メタデータ) が表示されます。
-h
オプション -d と組み合わせて使用すると、すべてのアクティビティが 1行で水平に表示されます。
--iface=iface_list
sadfで統計情報が表示されるネットワークインタフェースを指定します。iface_list は、カンマで区切られたインターフェイス名のリストです。sar のオプション -n DEV および -n EDEV を使うのに便利です。
--int=int_list
sadf で統計情報を表示する割り込み名を指定します。int_list はカンマで区切られた値のリストまたは値の範囲です (例: 0-16,35,40-)。sar のオプション -I を使うのに便利です。
-j
データファイルの内容を JSON (JavaScript Object Notation) 形式で出力します。タイムスタンプは、オプション -T および -t で制御できます。
-l
データファイルの内容を PCP (Performance Co-Pilot) アーカイブに書き出します。アーカイブの名前は、キーワード pcparchive= と共にオプション -O を使って指定できます。
-O opts[,...]
指定されたオプションを使用して、sadf の出力を制御します。以下のオプションは、sadf -g によって表示される SVG 出力を制御するために使用されます:
autoscale
特定のビューのすべてのグラフを、現在のビューのスケールに基づいてできるだけ大きく描画します。これを行うには、係数 (10、100、1000...) を使用してグラフ図面を拡大します。このオプションは、同じビューに複数のグラフが描画されている場合に便利です。一部のグラフには非常に小さな値しか表示されず、他のグラフには大きな値が表示されます。後者の場合、前者はほとんど表示されません。
bwcol
白黒のパレットを使用してグラフを描画します。
customcol
グラフを描画する時、既定値のカラーパレットの代わりにカスタマイズ可能なカラーパレットを使用します。パレットをカスタマイズする方法については、以下の環境変数S_COLORS_PALETTE を参照してください。
debug
SVG 出力ファイルに有用なコメントを追加します。
height=value
SVGキャンバスの高さを value にします。
oneday
24 時間のグラフデータを表示します。時間は既定では UTC で表示されることに注意してください。現地時間で時間を表示し、真夜中から始まる時間枠を取得するためにはオプション -T を使用する必要があります。
packed
同じアクティビティ (および同じデバイス) からのすべてのビューを同じ行にグループ化します。
showidle
CPU 統計のグラフに %idle 状態を表示します。
showinfo
各ビューに追加情報 (日付やホスト名など) を表示します。
showtoc
SVG 出力の先頭に、各アクティビティの最初のグラフを指すリンクで構成される目次を追加します。
skipempty
すべてのグラフの値がゼロのビューを表示しません。
古いシステムアクティビティバイナリデータファイルを最新の形式に変換するには、次のオプションを使用します。
hz=value
古いデータファイルが作成されたマシンの 1秒当たりのティック数を指定します。
データを PCP アーカイブに書き出す場合、次のオプションが使用できます:
pcparchive=name
作成する PCP アーカイブの名前を指定します。
以下のオプションは、sadf -r によって表示される raw 出力を制御するために使用されます:
debug
主にデバッグに役立つ追加情報を表示します。
-P { cpu_list | ALL }
sadf に、指定された 1つまたは複数のプロセッサについてのみ、プロセッサ依存統計を報告するように通知します。cpu_list はカンマで区切られた値のリストまたは値の範囲です (例:0,2,4-7,12-)。プロセッサ 0が最初のプロセッサであり、プロセッサ all はすべてのプロセッサ間のグローバル平均であることに注意してください。ALL キーワードを指定すると、個々のプロセッサごとに統計情報を報告し、すべてのプロセッサに対してグローバルに報告します。
-p
データファイルの内容を、awk のようなパターン処理コマンドで簡単に処理できる形式で出力します。出力は、タブで区切られたフィールドで構成されます。各レコードには、ファイルが作成されたホストのホスト名、間隔の値 (得られない場合は -1)、タイムスタンプ、デバイス名 (得られない場合は -1)、フィールド名とその値が含まれます。タイムスタンプ出力はオプション -T、-t および -U で制御できることに注意してください。
-r
データファイルの内容をそのまま表示します。このフォーマットでは、すべてのカウンタの値がカーネルから読み込まれたとおりに表示されます。これは、たとえば、経過時間間隔にわたって平均値が計算されないことを意味します。出力は、オプション -O (上記参照)を使用して制御できます。

-s [ hh:mm[:ss] ]
-s [ seconds_since_the_epoch ]

レポートの開始時間を設定します。開始時刻の既定値は 08:00:00 です。時間は、24時間形式で指定するか、特定の時刻 (10桁の数字で指定) からの経過秒数で指定する必要があります。
-T
タイムスタンプを UTC (協定世界時) ではなく、現地時間で表示します。
-t
UTC (協定世界時) ではなく、データファイル作成者の元のローカル時間でタイムスタンプを表示します。
-U
エポックからのタイムスタンプ (UTC-Coordinated Universal Time) を秒単位で表示します。
-V
バージョン番号を出力して終了します。
-x
データファイルの内容を XML 形式で出力します。タイムスタンプは、オプション -T および -t で制御できます。対応する DTD (Document Type Definition) と XML スキーマは、sysstat ソースパッケージに含まれています。https://sysstat.github.io/ にもあります。

 

環境変数

sadf コマンドは、次の環境変数を参照します。
S_COLORS_PALETTE
sadf -g に、SVG 出力をレンダリングする時に使用する色を指定します。この環境変数は、オプション customcol でカスタムカラーパレットが選択されている場合にのみ考慮されます (オプション -O を参照)。値はコロンで区切られた機能のリストで、既定値先の色を表す 6桁 3バイトの 16進数 (16進トリプレット) に対応しています。

0=000000:1=1a1aff:2=1affb2:3=b21aff:
4=1ab2ff:5=ff1a1a:6=ffb31a:7=b2ff1a:
8=efefef:9=000000:A=1a1aff:B=1affb2:
C=b21aff:D=1ab2ff:E=ff1a1a:F=ffb31a:
G=bebebe:H=000000:I=000000:K=ffffff:
L=000000:T=000000:W=000000:X=000000

16進数字 0 ~F で構成される機能は、パレット内の最初の 16色を指定するために使用されます (これらの色はグラフの描画に使用されます)。たとえば、3=ffffff は、パレット内の 3番目の色が白 (0xffffff) であることを示します。
その他の機能は次のとおりです:

G=
グリッド線の描画に使用する色を指定します。
H=
レポートヘッダーの表示に使用する色を指定します。
I=
追加情報の表示に使用する色を指定します (日付、ホスト名など)。
K=
グラフの背景に使用する色を指定します。
L=
既定値の色を指定します (たとえば、目次の表示に使用します)。
T=
グラフタイトルの表示に使用する色を指定します。
W=
警告およびエラーメッセージの表示に使用する色を指定します。
X=
軸や目盛りの表示に使用する色を指定します。
S_TIME_DEF_TIME
この変数が存在し、その値が UTC である場合、sadf は、ディレクトリ /var/log/sa にある当日のデータファイルを特定するために、現地時間の代わりに UTC 時間を使用します。

 

使用例

sadf -d /var/log/sa/sa21 -- -r -n DEV
システムアクティビティファイル sa21 からメモリとネットワークの統計情報を抽出し、データベースが取り込むことができる形式で表示します。
sadf -p -P 1
現在の日次データファイルからプロセッサ 1(2番目のプロセッサ) の CPU 統計を抽出し、パターン処理コマンドで簡単に処理できる形式で表示します。

 

バグ

SVG 出力 (オプション -g で作成されたもの) は SVG 1.1 標準に完全に準拠します。グラフィックスは、Firefox、Chrome、Opera などのさまざまなウェブブラウザで正常に表示されています。しかし、Microsoft のブラウザ (Internet Explorer 11 および Edge 13.1 でテスト済み) では、SVG のレンダリングに問題がありますので、使用しないでください。

 

ファイル

/var/log/sa/saDD
/var/log/sa/saYYYYMMDD
標準的なシステムアクティビティの日次データファイルとその既定値の場所。YYYY は現在の年、MM は現在の月、DD は現在の日を表します。

 

著者

Sebastien Godard (sysstat <at> orange.fr)

 

関連項目

sar(1), sadc(8), sa1(8), sa2(8), sysstat(5)

https://github.com/sysstat/sysstat
https://sysstat.github.io/


 

Index

名前
書式
説明
オプション
環境変数
使用例
バグ
ファイル
著者
関連項目

This document was created by man2html, using the manual pages.