fmstat man page on SunOS

Man page or keyword search:  
man Server   20652 pages
apropos Keyword Search (all sections)
Output format
SunOS logo
[printable version]

fmstat(1M)		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 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 ALSO
       fmadm(1M), fmd(1M), fmdump(1M), attributes(5)

       System Administration Guide: Security Services

SunOS 5.10			  23 Dec 2005			    fmstat(1M)
[top]

List of man pages available for SunOS

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net