Home • Explore • Blog • CI
☰



man-pages
7th chunk of `iostat.man`
0c6d7329d298f46125c1684d848543607fbfcf6f06eda8060000000100000c52
 default statistics are displayed in color when the output is connected to a terminal.  Use this variable to change the settings. Possible values for this variable are never, always or  auto  (the  latter  is
              equivalent to the default settings).
              Please note that the color (being red, yellow, or some other color) used to display a value is not indicative of any kind of issue simply because of the color. It only indicates different ranges of values.

       S_COLORS_SGR
              Specify  the  colors and other attributes used to display statistics on the terminal.  Its value is a colon-separated list of capabilities that defaults to H=31;1:I=32;22:M=35;1:N=34;1:Z=34;22.  Supported capa‐
              bilities are:

              H=     SGR (Select Graphic Rendition) substring for percentage values greater than or equal to 75%.

              I=     SGR substring for device names.

              M=     SGR substring for percentage values in the range from 50% to 75%.

              N=     SGR substring for non-zero statistics values.

              Z=     SGR substring for zero values.

       S_TIME_FORMAT
              If this variable exists and its value is ISO then the current locale will be ignored when printing the date in the report header. The iostat command will use the ISO 8601 format (YYYY-MM-DD) instead.  The time‐
              stamp displayed with option -t will also be compliant with ISO 8601 format.

EXAMPLES
       iostat Display a single history since boot report for all CPU and Devices.

       iostat -d 2
              Display a continuous device report at two second intervals.

       iostat -d 2 6
              Display six reports at two second intervals for all devices.

       iostat -x sda sdb 2 6
              Display six reports of extended statistics at two second intervals for devices sda and sdb.

       iostat -p sda 2 6
              Display six reports at two second intervals for device sda and all its partitions (sda1, etc.)

BUGS
       /proc filesystem must be mounted for iostat to work.

       Kernels older than 2.6.x are no longer supported.

       Although iostat speaks of kilobytes (kB), megabytes (MB)..., it actually uses kibibytes (kiB), mebibytes (MiB)...  A kibibyte is equal to 1024 bytes, and a mebibyte is equal to 1024 kibibytes.

FILES
       /proc/stat contains system statistics.
       /proc/uptime contains system uptime.
       /proc/diskstats contains disks statistics.
       /sys contains statistics for block devices.
       /proc/self/mountstats contains statistics for network filesystems.
       /dev/disk contains persistent device names.

AUTHOR
       Sebastien Godard (sysstat <at> orange.fr)

SEE ALSO
       sar(1), pidstat(1), mpstat(1), vmstat(8), tapestat(1), nfsiostat(1), cifsiostat(1)

       https://github.com/sysstat/sysstat
       http://pagesperso-orange.fr/sebastien.godard/

Linux                                                                                                    SEPTEMBER 2021                                                                                                IOSTAT(1)
Title: iostat: Color Configuration, Time Formatting, Examples, Bugs, and File Locations
Summary
This section details the `S_COLORS` and `S_COLORS_SGR` environment variables for customizing color output in `iostat`. It explains how `S_TIME_FORMAT` can be used to display dates in ISO 8601 format. It provides usage examples, notes known bugs (such as the /proc filesystem requirement and the distinction between kilobytes and kibibytes), lists relevant files, credits the author, and provides references to related tools and web resources.