1fmstat(1M) System Administration Commands fmstat(1M)
2
3
4
6 fmstat - report fault management module statistics
7
9 fmstat [-astTz] [-d u | d ] [-m module] [interval [count]]
10
11
13 The fmstat utility can be used by administrators and service personnel
14 to report statistics associated with the Solaris Fault Manager, fmd(1M)
15 and its associated set of modules. The Fault Manager runs in the back‐
16 ground on each Solaris system. It receives telemetry information relat‐
17 ing to problems detected by the system software, diagnoses these prob‐
18 lems, and initiates proactive self-healing activities such as disabling
19 faulty components.
20
21
22 You can use fmstat to view statistics for diagnosis engines and agents
23 that are currently participating in fault management. The documentation
24 for fmd(1M), fmadm(1M), and fmdump(1M) describes more about tools to
25 observe fault management activities.
26
27
28 If the -m option is present or the -t option is present, fmstat reports
29 any statistics kept by the specified fault management module. The mod‐
30 ule list can be obtained using fmadm config.
31
32
33 If the -m option is not present, fmstat reports the following statis‐
34 tics for each of its client modules:
35
36 module The name of the fault management module, as reported by
37 fmadm config.
38
39
40 ev_recv The number of telemetry events received by the module.
41
42
43 ev_acpt The number of events accepted by the module as relevant to a
44 diagnosis.
45
46
47 wait The average number of telemetry events waiting to be exam‐
48 ined by the module.
49
50
51 svc_t The average service time for telemetry events received by
52 the module, in milliseconds.
53
54
55 %w The percentage of time that there were telemetry events
56 waiting to be examined by the module.
57
58
59 %b The percentage of time that the module was busy processing
60 telemetry events.
61
62
63 open The number of active cases (open problem investigations)
64 owned by the module.
65
66
67 solve The total number of cases solved by this module since it was
68 loaded.
69
70
71 memsz The amount of dynamic memory currently allocated by this
72 module.
73
74
75 bufsz The amount of persistent buffer space currently allocated by
76 this module.
77
78
79
80 The fmstat utility requires the user to posses the SYS_CONFIG privi‐
81 lege. Refer to the for more information about how to configure Solaris
82 privileges.
83
85 The following options are supported:
86
87 -a Print all statistics for a module, including those kept on
88 its behalf by fmd. If the -a option is not present, only
89 those statistics kept by the module are reported. If the
90 -a option is used without the -m module, a set of global
91 statistics associated with fmd are displayed.
92
93
94 -d u | d Display a time stamp.
95
96 Specify u for a printed representation of the internal
97 representation of time. See time(2). Specify d for stan‐
98 dard date format. See date(1).
99
100
101 -m module Print a report on the statistics associated with the spec‐
102 ified fault management module, instead of the default sta‐
103 tistics report. Modules can publish an arbitrary set of
104 statistics to help Sun service the fault management soft‐
105 ware itself. The module statistics constitute a Private
106 interface. See attributes(5) for information on Sun's
107 rules for Private interfaces. Scripts should not be writ‐
108 ten that depend upon the values of fault management module
109 statistics as they can change without notice.
110
111
112 -s Print a report on Soft Error Rate Discrimination (SERD)
113 engines associated with the module instead of the default
114 module statistics report. A SERD engine is a construct
115 used by fault management software to determine if a sta‐
116 tistical threshold measured as N events in some time T has
117 been exceeded. The -s option can only be used in combina‐
118 tion with the -m option.
119
120
121 -t Print a report on the statistics associated with each
122 fault management event transport. Each fault management
123 module can provide the implementation of one or more event
124 transports.
125
126
127 -T Print a table of the authority information associated with
128 each fault management event transport. If the -m option is
129 present, only transports associated with the specified
130 module are displayed.
131
132
133 -z Omit statistics with a zero value from the report associ‐
134 ated with the specified fault management module. The -z
135 option can only be used in combination with the -m option.
136
137
139 The following operands are supported:
140
141 count Print only count reports, and then exit.
142
143
144 interval Print a new report every interval seconds.
145
146
147
148 If no interval and no count are specified, a single report is printed
149 and fmstat exits. If an interval is specified but no count is speci‐
150 fied, fmstat prints reports every interval seconds indefinitely until
151 the command is interrupted.
152
154 The following exit values are returned:
155
156 0 Successful completion.
157
158
159 1 A fatal error occurred. A fatal error could be the failure to com‐
160 municate with fmd(1M). It could also be that insufficient privi‐
161 leges were available to perform the requested operation.
162
163
164 2 Invalid command-line options were specified.
165
166
168 See attributes(5) for descriptions of the following attributes:
169
170
171
172
173 ┌─────────────────────────────┬─────────────────────────────┐
174 │ ATTRIBUTE TYPE │ ATTRIBUTE VALUE │
175 ├─────────────────────────────┼─────────────────────────────┤
176 │Availability │SUNWfmd │
177 ├─────────────────────────────┼─────────────────────────────┤
178 │Interface Stability │See below. │
179 └─────────────────────────────┴─────────────────────────────┘
180
181
182 The command-line options are Evolving. The human-readable default
183 report is Unstable. The human-readable module report is Private.
184
186 fmadm(1M), fmd(1M), fmdump(1M), attributes(5)
187
188
189
190
191
192
193SunOS 5.11 16 Jun 2009 fmstat(1M)