System Administration Commands fmstat(1M)
NAME
fmstat - report fault management module statistics
SYNOPSIS
fmstat [-astTz] [-m module] [interval [count]
DESCRIPTION
The fmstat utility can be used by administrators and service
personnel to report statistics associated with the Solaris
Fault Manager, fmd(1M) and its associated set of modules.
The Fault Manager runs in the background on each Solaris
system. It receives telemetry information relating to prob-
lems detected by the system software, diagnoses these prob-
lems, and initiates proactive self-healing activities such
as disabling faulty components.
You can use fmstat to view statistics for diagnosis engines
and agents that are currently participating in fault manage-
ment. The documentation for fmd(1M), fmadm(1M), and
fmdump(1M) describes more about tools to observe fault
management activities.
If the -m option is present or the -t option is present,
fmstat reports any statistics kept by the specified fault
management module. The module list can be obtained using
fmadm config.
If the -m option is not present, fmstat reports the follow-
ing statistics for each of its client modules:
module The name of the fault management module, as
reported by fmadm config.
evrecv The number of telemetry events received by the
module.
evacpt The number of events accepted by the module as
relevant to a diagnosis.
wait The average number of telemetry events waiting to
be examined by the module.
svct The average service time for telemetry events
received by the module, in milliseconds.
SunOS 5.11 Last change: 23 Dec 2005 1
System Administration Commands fmstat(1M)
%w The percentage of time that there were telemetry
events waiting to be examined by the module.
%b The percentage of time that the module was busy
processing telemetry events.
open The number of active cases (open problem investi-
gations) owned by the module.
solve The total number of cases solved by this module
since it was loaded.
memsz The amount of dynamic memory currently allocated
by this module.
bufsz The amount of persistent buffer space currently
allocated by this module.
The fmstat utility requires the user to posses the
SYSCONFIG privilege. Refer to the for more information
about how to configure Solaris privileges.
OPTIONS
The following options are supported:
-a Print all statistics for a module, including
those kept on its behalf by fmd. If the -a
option is not present, only those statistics
kept by the module are reported. If the -a
option is used without the -m module, a set of
global statistics associated with fmd are
displayed.
-m module Print a report on the statistics associated
with the specified fault management module,
instead of the default statistics report.
Modules can publish an arbitrary set of statis-
tics to help Sun service the fault management
software itself. The module statistics consti-
tute a Private interface. See attributes(5) for
information on Sun's rules for Private inter-
faces. Scripts should not be written that
depend upon the values of fault management
module statistics as they can change without
SunOS 5.11 Last change: 23 Dec 2005 2
System Administration Commands fmstat(1M)
notice.
-s Print a report on Soft Error Rate Discrimina-
tion (SERD) engines associated with the module
instead of the default module statistics
report. A SERD engine is a construct used by
fault management software to determine if a
statistical threshold measured as N events in
some time T has been exceeded. The -s option
can only be used in combination with the -m
option.
-t Print a report on the statistics associated
with each fault management event transport.
Each fault management module can provide the
implementation of one or more event transports.
-T Print a table of the authority information
associated with each fault management event
transport. If the -m option is present, only
transports associated with the specified module
are displayed.
-z Omit statistics with a zero value from the
report associated with the specified fault
management module. The -z option can only be
used in combination with the -m option.
OPERANDS
The following operands are supported:
count Print only count reports, and then exit.
interval Print a new report every interval seconds.
If no interval and no count are specified, a single report
is printed and fmstat exits. If an interval is specified but
no count is specified, fmstat prints reports every interval
seconds indefinitely until the command is interrupted.
EXIT STATUS
The following exit values are returned:
SunOS 5.11 Last change: 23 Dec 2005 3
System Administration Commands fmstat(1M)
0 Successful completion.
1 A fatal error occurred. A fatal error could be the
failure to communicate with fmd(1M). It could also be
that insufficient privileges were available to perform
the requested operation.
2 Invalid command-line options were specified.
ATRIBUTES
See attributes(5) for descriptions of the following attri-
butes:
ATRIBUTE TYPE ATRIBUTE VALUE
Availability SUNWfmd
Interface Stability See below.
The command-line options are Evolving. The human-readable
default report is Unstable. The human-readable module report
is Private.
SEE ALSO
fmadm(1M), fmd(1M), fmdump(1M), attributes(5)
SunOS 5.11 Last change: 23 Dec 2005 4
|
