share/man/man1/sar.1

   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
  15
  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
  21
  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
  53
  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
  62
  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
  79
  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
  88
  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
  97
  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
 106
 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
 111
 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
 128
 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
 138
 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
 149
 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
 154
 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
 175
 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
 185
 186 .sp
 187 .ne 2
 188 .na
 189 \fBavwait\fR
 190 .ad
 191 .RS 27n
 192 average wait time in milliseconds.
 193 .RE
 194
 195 .sp
 196 .ne 2
 197 .na
 198 \fBavserv\fR
 199 .ad
 200 .RS 27n
 201 average service time in milliseconds.
 202 .RE
 203
 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
 210
 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
 219
 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
 229
 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
 245
 246 .sp
 247 .ne 2
 248 .na
 249 \fBppgout/s\fR
 250 .ad
 251 .RS 12n
 252 pages paged-out per second.
 253 .RE
 254
 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
 263
 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
 272
 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
 284
 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
 289
 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
 298
 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
 318
 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
 328
 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
 339
 340 .RE
 341
 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
 357
 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
 362
 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
 371
 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
 388
 389 .sp
 390 .ne 2
 391 .na
 392 \fBpgin/s\fR
 393 .ad
 394 .RS 11n
 395 page-in requests per second.
 396 .RE
 397
 398 .sp
 399 .ne 2
 400 .na
 401 \fBppgin/s\fR
 402 .ad
 403 .RS 11n
 404 pages paged-in per second.
 405 .RE
 406
 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
 416
 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
 425
 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
 435
 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
 440
 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
 456
 457 .sp
 458 .ne 2
 459 .na
 460 \fBswpq-sz, %swpocc\fR
 461 .ad
 462 .RS 20n
 463 Swap queue of processes
 464 .RE
 465
 466 .RE
 467
 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
 483
 484 .sp
 485 .ne 2
 486 .na
 487 \fBfreeswap\fR
 488 .ad
 489 .RS 12n
 490 disk blocks available for page swapping.
 491 .RE
 492
 493 .RE
 494
 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
 504
 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
 521
 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
 526
 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
 543
 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
 553
 554 .RE
 555
 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
 573
 574 .sp
 575 .ne 2
 576 .na
 577 \fBpswch/s\fR
 578 .ad
 579 .sp .6
 580 .RS 4n
 581 process switches.
 582 .RE
 583
 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
 588
 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
 605
 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
 614
 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
 619
 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:
 626
 627 .sp
 628 .in +2
 629 .nf
 630 example% sar
 631 .fi
 632 .in -2
 633 .sp
 634
 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:
 640
 641 .sp
 642 .in +2
 643 .nf
 644 example% sar -o temp 60 10
 645 .fi
 646 .in -2
 647 .sp
 648
 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:
 654
 655 .sp
 656 .in +2
 657 .nf
 658 example% sar -d -f temp
 659 .fi
 660 .in -2
 661 .sp
 662
 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
 671
 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.