fmstat(1M) System Administration Commands fmstat(1M)NAMEfmstat - report fault management module statistics
SYNOPSISfmstat [-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 back‐
ground on each Solaris system. It receives telemetry information relat‐
ing to problems 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 management. 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 mod‐
ule list can be obtained using fmadm config.
If the -m option is not present, fmstat reports the following statis‐
tics for each of its client modules:
module The name of the fault management module, as reported by
fmadm config.
ev_recv The number of telemetry events received by the module.
ev_acpt 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.
svc_t The average service time for telemetry events received
by the module, in milliseconds.
%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 pro‐
cessing telemetry events.
open The number of active cases (open problem investiga‐
tions) 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 allo‐
cated by this module.
The fmstat utility requires the user to posses the SYS_CONFIG privi‐
lege. Refer to the System Administration Guide: Security Services 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 arbi‐
trary set of statistics to help Sun service the fault
management software itself. The module statistics con‐
stitute a Private interface. See attributes(5) for
information on Sun's rules for Private interfaces.
Scripts should not be written that depend upon the val‐
ues of fault management module statistics as they can
change without notice.
-s Print a report on Soft Error Rate Discrimination (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 deter‐
mine 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 asso‐
ciated 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 speci‐
fied, fmstat prints reports every interval seconds indefinitely until
the command is interrupted.
EXIT STATUS
The following exit values are returned:
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.
ATTRIBUTES
See attributes(5) for descriptions of the following attributes:
┌─────────────────────────────┬─────────────────────────────┐
│ ATTRIBUTE TYPE │ ATTRIBUTE 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 ALSOfmadm(1M), fmd(1M), fmdump(1M), attributes(5)
System Administration Guide: Security Services
SunOS 5.10 23 Dec 2005 fmstat(1M)