1
.TH SADF 1 "JULY 2006" Linux "Linux User's Manual" -*- nroff -*-
3
sadf \- Display data collected by sar in multiple formats.
5
.B sadf [ -d | -D | -H | -p | -x ] [ -t ] [ -V ] [ -P {
23
command is used for displaying the contents of data files created by the
25
command. But unlike sar,
27
can write its data in many different formats.
28
The default format is one that can
29
easily be handled by pattern processing commands like awk (see option -p).
33
command extracts and writes to standard output records saved in the
35
file. This file must have been created by a version of
37
which is compatible with that of
43
uses the standard system activity file, the
45
file, where the dd parameter indicates the current day.
51
parameters are used to tell
57
second intervals. If the
59
parameter is not set, then all the records saved in the data file will be
62
All the activity flags of
64
may be entered on the command line to indicate which
65
activities are to be reported. Before specifying them, put a pair of
66
dashes (--) on the command line in order not to confuse the flags
69
Not specifying any flags selects only CPU activity.
73
This option is equivalent to option -d below, except that the timestamp
74
is always expressed in seconds since the epoch (00:00:00 UTC 01/01/1970).
76
Print the contents of the data file in a format that can easily
77
be ingested by a relational database system. The output consists
78
of fields separated by a semicolon. Each record contains
79
the hostname of the host where the file was created, the interval value
80
(or -1 if not applicable), the timestamp in a form easily acceptable by
81
most databases, and additional semicolon separated data fields as specified
85
Note that the timestamp is displayed in UTC (Coordinated Universal Time)
86
unless option -t is used. In this latter case, the timestamp is displayed
89
Set the ending time of the report, given in local time. The default ending
90
time is 18:00:00. Hours must be given in 24-hour format.
91
This option is ignored when option -x is used.
93
Display the header of the data file.
94
.IP "-P { cpu | ALL }"
97
that processor dependent statistics are to be reported only for the
98
specified processor or processors. Specifying the
100
keyword reports statistics for each individual processor, and globally for
101
all processors. Note that processor 0 is the first processor.
103
Print the contents of the data file in a format that can
104
easily be handled by pattern processing commands like awk.
105
The output consists of fields separated by a tab. Each record contains the
106
hostname of the host where the file was created, the interval value
107
(or -1 if not applicable), the timestamp (UTC value - Coordinated Universal
108
Time) in seconds from the epoch, the device name (or - if not applicable),
109
the field name and its value.
110
.IP "-s [ hh:mm:ss ]"
111
Set the starting time of the data (given in local time), causing the
113
command to extract records time-tagged at, or following, the time
114
specified. The default starting time is 08:00.
115
Hours must be given in 24-hour format. This option is ignored when
118
When this option is used together with options -d or -x, the timestamp
119
is displayed in local time instead of UTC (Coordinated Universal Time).
120
This option is ignored when options -p or -D are used.
122
Print version number then exit.
124
Print the contents of the data file in XML format. Every activity and the whole
125
file contents will be displayed.
126
Timestamps are displayed in UTC (Coordinated Universal Time)
127
unless option -t is used, in which case they are displayed
128
in local time. The corresponding
129
DTD (Document Type Definition) is included in the sysstat source package.
130
It is also available at
131
.I http://perso.orange.fr/sebastien.godard/sysstat.dtd
136
command takes into account the following environment variable:
139
If this variable exists and its value is
143
will use UTC time instead of local time to determine the current daily data
148
.B sadf -d /var/log/sa/sa21 -- -r -n DEV
150
Extract memory, swap space and network statistics from system activity
151
file 'sa21', and display them in a format that can be ingested by a
157
Extract CPU statistics for processor 1 (the second processor) from current
158
daily data file, and display them in a format that can easily be handled
159
by a pattern processing command.
163
.IR /var/log/sa/sa dd
165
Indicate the daily data file, where the
167
parameter is a number representing the day of the month.
171
Sebastien Godard (sysstat <at> wanadoo.fr)
182
.I http://perso.orange.fr/sebastien.godard/