| blob | 9318d3d394301904afb751a03e5730921cf3edf1 |
1 '\" te
2 .\" Copyright (c) 2004, Sun Microsystems, Inc. All Rights Reserved
3 .\" Copyright 1989 AT&T
4 .\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License.
5 .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License.
6 .\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
7 .TH SAR 1 "May 13, 2017"
8 .SH NAME
9 sar \- system activity reporter
10 .SH SYNOPSIS
11 .LP
12 .nf
13 \fBsar\fR [\fB-aAbcdgkmpqruvwy\fR] [\fB-o\fR \fIfilename\fR] \fIt\fR [\fIn\fR]
14 .fi
16 .LP
17 .nf
18 \fBsar\fR [\fB-aAbcdgkmpqruvwy\fR] [\fB-e\fR \fItime\fR] [\fB-f\fR \fIfilename\fR] [\fB-i\fR \fIsec\fR]
19 [\fB-s\fR \fItime\fR]
20 .fi
22 .SH DESCRIPTION
23 .LP
24 In the first instance, the \fBsar\fR utility samples cumulative activity
25 counters in the operating system at \fIn\fR intervals of \fIt\fR seconds, where
26 \fIt\fR should be \fB5\fR or greater. If \fIt\fR is specified with more than
27 one option, all headers are printed together and the output can be difficult to
28 read. (If the sampling interval is less than \fB5\fR, the activity of \fBsar\fR
29 itself can affect the sample.) If the \fB-o\fR option is specified, it saves
30 the samples in \fIfilename\fR in binary format. The default value of \fIn\fR is
31 \fB1\fR.
32 .sp
33 .LP
34 In the second instance, no sampling interval is specified. \fBsar\fR extracts
35 data from a previously recorded \fIfilename\fR, either the one specified by the
36 \fB-f\fR option or, by default, the standard system activity daily data file
37 \fB/var/adm/sa/sa\fIdd\fR\fR for the current day \fIdd\fR. The starting and
38 ending times of the report can be bounded using the \fB-e\fR and \fB-s\fR
39 arguments with \fItime\fR specified in the form \fIhh\fR[:\fImm\fR[:\fIss\fR]].
40 The \fB-i\fR option selects records at \fIsec\fR second intervals. Otherwise,
41 all intervals found in the data file are reported.
42 .SH OPTIONS
43 .LP
44 The following options modify the subsets of information reported by \fBsar\fR.
45 .sp
46 .ne 2
47 .na
48 \fB\fB-a\fR\fR
49 .ad
50 .RS 15n
51 Reports use of file access system routines: iget/s, namei/s, dirblk/s
52 .RE
54 .sp
55 .ne 2
56 .na
57 \fB\fB-A\fR\fR
58 .ad
59 .RS 15n
60 Reports all data. Equivalent to \fB-abcdgkmpqruvwy\fR.
61 .RE
63 .sp
64 .ne 2
65 .na
66 \fB\fB-b\fR\fR
67 .ad
68 .RS 15n
69 Reports buffer activity:
70 .sp
71 .ne 2
72 .na
73 \fBbread/s, bwrit/s\fR
74 .ad
75 .RS 20n
76 transfers per second of data between system buffers and disk or other block
77 devices.
78 .RE
80 .sp
81 .ne 2
82 .na
83 \fBlread/s, lwrit/s\fR
84 .ad
85 .RS 20n
86 accesses of system buffers.
87 .RE
89 .sp
90 .ne 2
91 .na
92 \fB%rcache, %wcache\fR
93 .ad
94 .RS 20n
95 cache hit ratios, that is, (1\(mibread/lread) as a percentage.
96 .RE
98 .sp
99 .ne 2
100 .na
101 \fBpread/s, pwrit/s\fR
102 .ad
103 .RS 20n
104 transfers using raw (physical) device mechanism.
105 .RE
107 If run in a non-global zone and the pools facility is active, these values
108 reflect activity on the processors of the processor set of the pool to which
109 the zone is bound.
110 .RE
112 .sp
113 .ne 2
114 .na
115 \fB\fB-c\fR\fR
116 .ad
117 .RS 15n
118 Reports system calls:
119 .sp
120 .ne 2
121 .na
122 \fBscall/s\fR
123 .ad
124 .sp .6
125 .RS 4n
126 system calls of all types.
127 .RE
129 .sp
130 .ne 2
131 .na
132 \fBsread/s, swrit/s, fork/s, exec/s\fR
133 .ad
134 .sp .6
135 .RS 4n
136 specific system calls.
137 .RE
139 .sp
140 .ne 2
141 .na
142 \fBrchar/s, wchar/s\fR
143 .ad
144 .sp .6
145 .RS 4n
146 characters transferred by read and write system calls. No incoming or outgoing
147 \fBexec\fR(2) and \fBfork\fR(2) calls are reported.
148 .RE
150 If run in a non-global zone and the pools facility is active, these values
151 reflect activity on the processors of the processor set of the pool to which
152 the zone is bound.
153 .RE
155 .sp
156 .ne 2
157 .na
158 \fB\fB-d\fR\fR
159 .ad
160 .RS 15n
161 Reports activity for each block device (for example, disk or tape drive) with
162 the exception of \fBXDC\fR disks and tape drives. When data is displayed, the
163 device specification \fIdsk-\fR is generally used to represent a disk drive.
164 The device specification used to represent a tape drive is machine dependent.
165 The activity data reported is:
166 .sp
167 .ne 2
168 .na
169 \fB%busy, avque\fR
170 .ad
171 .RS 27n
172 portion of time device was busy servicing a transfer request, average number of
173 requests outstanding during that time.
174 .RE
176 .sp
177 .ne 2
178 .na
179 \fBread/s, write/s, blks/s\fR
180 .ad
181 .RS 27n
182 number of read/write transfers from or to device, number of bytes transferred
183 in 512-byte units.
184 .RE
186 .sp
187 .ne 2
188 .na
189 \fBavwait\fR
190 .ad
191 .RS 27n
192 average wait time in milliseconds.
193 .RE
195 .sp
196 .ne 2
197 .na
198 \fBavserv\fR
199 .ad
200 .RS 27n
201 average service time in milliseconds.
202 .RE
204 For more general system statistics, use \fBiostat\fR(1M), \fBsar\fR(1M), or
205 \fBvmstat\fR(1M).
206 .sp
207 See \fISystem Administration Guide: Advanced Administration\fR for naming
208 conventions for disks.
209 .RE
211 .sp
212 .ne 2
213 .na
214 \fB\fB-e\fR \fItime\fR\fR
215 .ad
216 .RS 15n
217 Selects data up to \fBtime\fR. Default is \fB18:00\fR.
218 .RE
220 .sp
221 .ne 2
222 .na
223 \fB\fB-f\fR \fIfilename\fR\fR
224 .ad
225 .RS 15n
226 Uses \fIfilename\fR as the data source for \fBsar\fR. Default is the current
227 daily data file \fB/var/adm/sa/sa\fR\fIdd.\fR
228 .RE
230 .sp
231 .ne 2
232 .na
233 \fB\fB-g\fR\fR
234 .ad
235 .RS 15n
236 Reports paging activities:
237 .sp
238 .ne 2
239 .na
240 \fBpgout/s\fR
241 .ad
242 .RS 12n
243 page-out requests per second.
244 .RE
246 .sp
247 .ne 2
248 .na
249 \fBppgout/s\fR
250 .ad
251 .RS 12n
252 pages paged-out per second.
253 .RE
255 .sp
256 .ne 2
257 .na
258 \fBpgfree/s\fR
259 .ad
260 .RS 12n
261 pages per second placed on the free list by the page stealing daemon.
262 .RE
264 .sp
265 .ne 2
266 .na
267 \fBpgscan/s\fR
268 .ad
269 .RS 12n
270 pages per second scanned by the page stealing daemon.
271 .RE
273 .sp
274 .ne 2
275 .na
276 \fB%ufs_ipf\fR
277 .ad
278 .RS 12n
279 the percentage of \fBUFS\fR inodes taken off the freelist by iget which had
280 reusable pages associated with them. These pages are flushed and cannot be
281 reclaimed by processes. Thus, this is the percentage of igets with page
282 flushes.
283 .RE
285 If run in a non-global zone and the pools facility is active, these values
286 reflect activity on the processors of the processor set of the pool to which
287 the zone is bound.
288 .RE
290 .sp
291 .ne 2
292 .na
293 \fB\fB-i\fR \fIsec\fR\fR
294 .ad
295 .RS 15n
296 Selects data at intervals as close as possible to \fIsec\fR seconds.
297 .RE
299 .sp
300 .ne 2
301 .na
302 \fB\fB-k\fR\fR
303 .ad
304 .RS 15n
305 Reports kernel memory allocation (KMA) activities:
306 .sp
307 .ne 2
308 .na
309 \fBsml_mem, alloc, fail\fR
310 .ad
311 .RS 24n
312 information about the memory pool reserving and allocating space for small
313 requests: the amount of memory in bytes \fBKMA\fR has for the small pool, the
314 number of bytes allocated to satisfy requests for small amounts of memory, and
315 the number of requests for small amounts of memory that were not satisfied
316 (failed).
317 .RE
319 .sp
320 .ne 2
321 .na
322 \fBlg_mem, alloc, fail\fR
323 .ad
324 .RS 24n
325 information for the large memory pool (analogous to the information for the
326 small memory pool).
327 .RE
329 .sp
330 .ne 2
331 .na
332 \fBovsz_alloc, fail\fR
333 .ad
334 .RS 24n
335 the amount of memory allocated for oversize requests and the number of oversize
336 requests which could not be satisfied (because oversized memory is allocated
337 dynamically, there is not a pool).
338 .RE
340 .RE
342 .sp
343 .ne 2
344 .na
345 \fB\fB-m\fR\fR
346 .ad
347 .RS 15n
348 Reports message and semaphore activities:
349 .sp
350 .ne 2
351 .na
352 \fBmsg/s, sema/s\fR
353 .ad
354 .RS 17n
355 primitives per second.
356 .RE
358 If run in a non-global zone and the pools facility is active, these values
359 reflect activity on the processors of the processor set of the pool to which
360 the zone is bound.
361 .RE
363 .sp
364 .ne 2
365 .na
366 \fB\fB-o\fR \fIfilename\fR\fR
367 .ad
368 .RS 15n
369 Saves samples in file, \fIfilename\fR, in binary format.
370 .RE
372 .sp
373 .ne 2
374 .na
375 \fB\fB-p\fR\fR
376 .ad
377 .RS 15n
378 Reports paging activities:
379 .sp
380 .ne 2
381 .na
382 \fBatch/s\fR
383 .ad
384 .RS 11n
385 page faults per second that are satisfied by reclaiming a page currently in
386 memory (attaches per second).
387 .RE
389 .sp
390 .ne 2
391 .na
392 \fBpgin/s\fR
393 .ad
394 .RS 11n
395 page-in requests per second.
396 .RE
398 .sp
399 .ne 2
400 .na
401 \fBppgin/s\fR
402 .ad
403 .RS 11n
404 pages paged-in per second.
405 .RE
407 .sp
408 .ne 2
409 .na
410 \fBpflt/s\fR
411 .ad
412 .RS 11n
413 page faults from protection errors per second (illegal access to page) or
414 "copy-on-writes".
415 .RE
417 .sp
418 .ne 2
419 .na
420 \fBvflt/s\fR
421 .ad
422 .RS 11n
423 address translation page faults per second (valid page not in memory).
424 .RE
426 .sp
427 .ne 2
428 .na
429 \fBslock/s\fR
430 .ad
431 .RS 11n
432 faults per second caused by software lock requests requiring physical
433 \fBI/O\fR.
434 .RE
436 If run in a non-global zone and the pools facility is active, these values
437 reflect activity on the processors of the processor set of the pool to which
438 the zone is bound.
439 .RE
441 .sp
442 .ne 2
443 .na
444 \fB\fB-q\fR\fR
445 .ad
446 .RS 15n
447 Reports average queue length while occupied, and percent of time occupied:
448 .sp
449 .ne 2
450 .na
451 \fBrunq-sz, %runocc\fR
452 .ad
453 .RS 20n
454 Run queue of kernel threads in memory and runnable
455 .RE
457 .sp
458 .ne 2
459 .na
460 \fBswpq-sz, %swpocc\fR
461 .ad
462 .RS 20n
463 Swap queue of processes
464 .RE
466 .RE
468 .sp
469 .ne 2
470 .na
471 \fB\fB-r\fR\fR
472 .ad
473 .RS 15n
474 Reports unused memory pages and disk blocks:
475 .sp
476 .ne 2
477 .na
478 \fBfreemem\fR
479 .ad
480 .RS 12n
481 average pages available to user processes.
482 .RE
484 .sp
485 .ne 2
486 .na
487 \fBfreeswap\fR
488 .ad
489 .RS 12n
490 disk blocks available for page swapping.
491 .RE
493 .RE
495 .sp
496 .ne 2
497 .na
498 \fB\fB-s\fR \fItime\fR\fR
499 .ad
500 .RS 15n
501 Selects data later than \fBtime\fR in the form \fIhh\fR[:\fImm\fR]. Default is
502 \fB08:00\fR.
503 .RE
505 .sp
506 .ne 2
507 .na
508 \fB\fB-u\fR\fR
509 .ad
510 .RS 15n
511 Reports \fBCPU\fR utilization (the default):
512 .sp
513 .ne 2
514 .na
515 \fB%usr, %sys, %wio, %idle\fR
516 .ad
517 .RS 27n
518 portion of time running in user mode, running in system mode, idle with some
519 process waiting for block \fBI/O\fR, and otherwise idle.
520 .RE
522 If run in a non-global zone and the pools facility is active, these values
523 reflect activity on the processors of the processor set of the pool to which
524 the zone is bound.
525 .RE
527 .sp
528 .ne 2
529 .na
530 \fB\fB-v\fR\fR
531 .ad
532 .RS 15n
533 Reports status of process, i-node, file tables:
534 .sp
535 .ne 2
536 .na
537 \fBproc-sz, inod-sz, file-sz, lock-sz\fR
538 .ad
539 .sp .6
540 .RS 4n
541 entries/size for each table, evaluated once at sampling point.
542 .RE
544 .sp
545 .ne 2
546 .na
547 \fBov\fR
548 .ad
549 .sp .6
550 .RS 4n
551 overflows that occur between sampling points for each table.
552 .RE
554 .RE
556 .sp
557 .ne 2
558 .na
559 \fB\fB-w\fR\fR
560 .ad
561 .RS 15n
562 Reports system swapping and switching activity:
563 .sp
564 .ne 2
565 .na
566 \fBswpin/s, swpot/s, bswin/s, bswot/s\fR
567 .ad
568 .sp .6
569 .RS 4n
570 number of transfers and number of 512-byte units transferred for swapins and
571 swapouts (including initial loading of some programs).
572 .RE
574 .sp
575 .ne 2
576 .na
577 \fBpswch/s\fR
578 .ad
579 .sp .6
580 .RS 4n
581 process switches.
582 .RE
584 If run in a non-global zone and the pools facility is active, these values
585 reflect activity on the processors of the processor set of the pool to which
586 the zone is bound.
587 .RE
589 .sp
590 .ne 2
591 .na
592 \fB\fB-y\fR\fR
593 .ad
594 .RS 15n
595 Reports TTY device activity:
596 .sp
597 .ne 2
598 .na
599 \fBrawch/s, canch/s, outch/s\fR
600 .ad
601 .RS 29n
602 input character rate, input character rate processed by canon, output character
603 rate.
604 .RE
606 .sp
607 .ne 2
608 .na
609 \fBrcvin/s, xmtin/s, mdmin/s\fR
610 .ad
611 .RS 29n
612 receive, transmit and modem interrupt rates.
613 .RE
615 If run in a non-global zone and the pools facility is active, these values
616 reflect activity on the processors of the processor set of the pool to which
617 the zone is bound.
618 .RE
620 .SH EXAMPLES
621 .LP
622 \fBExample 1 \fRViewing System Activity
623 .sp
624 .LP
625 The following example displays today's \fBCPU\fR activity so far:
627 .sp
628 .in +2
629 .nf
630 example% sar
631 .fi
632 .in -2
633 .sp
635 .LP
636 \fBExample 2 \fRWatching System Activity Evolve
637 .sp
638 .LP
639 To watch \fBCPU\fR activity evolve for 10 minutes and save data:
641 .sp
642 .in +2
643 .nf
644 example% sar -o temp 60 10
645 .fi
646 .in -2
647 .sp
649 .LP
650 \fBExample 3 \fRReviewing Disk and Tape Activity
651 .sp
652 .LP
653 To later review disk and tape activity from that period:
655 .sp
656 .in +2
657 .nf
658 example% sar -d -f temp
659 .fi
660 .in -2
661 .sp
663 .SH FILES
664 .ne 2
665 .na
666 \fB\fB/var/adm/sa/sa\fIdd\fR\fR\fR
667 .ad
668 .RS 20n
669 daily data file, where \fIdd\fR are digits representing the day of the month
670 .RE
672 .SH SEE ALSO
673 .LP
674 \fBiostat\fR(1M), \fBsar\fR(1M), \fBvmstat\fR(1M), \fBexec\fR(2),
675 \fBfork\fR(2), \fBattributes\fR(5)
676 .sp
677 .LP
678 \fISystem Administration Guide: Advanced Administration\fR
679 .SH NOTES
680 .LP
681 The sum of CPU utilization might vary slightly from 100 because of rounding
682 errors in the production of a percentage figure.