dsilog - a program that logs incoming data
dsilog logfile_set class [options]
dsilog is a program that logs incoming data. A separate logging
process must be used for each class you have defined. The dsilog pro‐
gram expects to receive data from stdin.
logfile_set is the name of the logfile set where the data is to be
stored. If it is not in the current directory, the name
must be fully qualified.
class is the name of the class to be logged.
-c char is the character to be used as a string delimiter/sepa‐
rator. You may not use the following as separators:
decimal, minus sign, ^d, \n. Since the default is
blanks, if there are embedded spaces in any text metric
names then you must specify a unique separator using
-s second is the number of seconds to summarize the data by. Zero
turns off summarization, which means that all incoming
data is logged. If this option is omitted, the summa‐
rization rate defaults to the RECORDS PER HOUR rate in
the class specification. Conversely, this option over‐
rides the value of RECORDS PER HOUR.
-i fifo indicates that the input should come from the fifo
named. If fifo is not used, input comes from stdin. If
you use this method, start dsilog before starting your
collection process. See man page mkfifo for more infor‐
mation about using a fifo.
-f format file names a file that describes the data that will be input
to the logging process. If this option is not specified,
dsilog derives the format of the input from the class
specification with the following assumptions. Each data
item in an input record corresponds to a metric that has
been defined in the class specification. The metrics
are defined in the class specification in the order in
which they appear as data items in the input record. If
there are more data items in an input record than there
are metric definitions, dsilog ignores all additional
data items. If the class specification lists more met‐
ric definitions than there are input data items, the
field will show "missing" data when the data is
exported, and no data will be available for that metric
when graphing data in the analysis software. There is a
limit of 100 fields in the format file.
-timestamp indicates that the logging process should not provide
the timestamp, but use the one already provided in the
input data. The timestamp in the incoming data must be
in UNIX timestamp format (seconds since 1/1/70 00:00:00)
and represents the local time (not Greenwich Mean Time).
-asyn specifies that the data will arrive asynchronously with
the RECORDS PER HOUR rate. If no data arrives during a
logging interval, the data for the last logging interval
is repeated. This causes a flat line to be drawn in a
graphical display of the data and causes data to be
repeated in each record if the data is exported.
-t prints everything that is logged to stdout in ASCII for‐
-vi filters the input through dsilog and writes errors to
stdout instead of the log file. It does not write the
actual data logged to stdout just the errors. This can
be used to check the validity of the input.
-vo filters the input through dsilog and writes the actual
data logged and errors to stdout instead of the log
file. This can be used to check the validity of the
dsilog -vers displays the version of this program.
dsilog -? displays options for this program. If your system
interprets ? as a wildcard character, use an invalid
option such as -xxx instead of -?.
SEE ALSOsdlcomp(1), sdlgendata(1), sdlutil(1).