The -attention option can be used to set the threshold value for all but the Server column in the display region. Any threshold that you set applies to all of the entries in a column; you cannot set thresholds on a per-machine basis.
You can use more than one argument with the -attention option; each argument is a combination of a statistic and a threshold. Legal values for statistic/threshold pairs are as follows:
· The conn connections argument sets the threshold for the maximum number of connections that principals can have open to the File Exporter before the value is highlighted. The highlighting is removed when the value goes below the threshold.
· The fetch number_of_fetches argument sets the threshold for the maximum number of fetches the File Exporter can service before the value is highlighted. The highlighting is removed when the File Exporter is restarted.
· The store number_of_stores argument sets the threshold for the maximum number of stores the File Exporter can accept before the value is highlighted. The highlighting is removed when the File Exporter is restarted.
· The ws active_client_machines argument sets the threshold for the maximum number of active client machines that the File Exporter can serve before the value is highlighted; active indicates those machines that communicated with the File Exporter in the past 15 minutes. The highlighting is removed when the value goes below the threshold.
· The disk percent_full% argument sets the threshold for the maximum percentage of an aggregate that can contain data before the value is highlighted. This threshold is applied to each exported aggregate or partition on a File Server machine being monitored. Legal thresholds are integers from 0 (zero) to 99; the default is 95% used. You must enter the % (percent sign) with this threshold; if the % (percent sign) is absent, scout interprets the number as a number of kilobyte blocks.
or
The disk minimum_blocks_free argument sets the threshold that determines the minimum number of kilobyte blocks to be available on the aggregate before the value is highlighted. This threshold is applied to each exported aggregate or partition on a File Server machine being monitored.
To change these attention settings, you must stop and restart scout. In addition, scout does not store the settings from previous instances; you must specify the desired settings each time you start the program.
You cannot set a threshold or control the highlighting in the Server column. If the File Exporter on a machine does not respond to scout's probes, the name is automatically highlighted and the values for that machine in the other columns are removed. A lack of response can indicate that a File Server machine or the network is unavailable.
When a machine resumes responding to scout's probes, its name is displayed without highlighting with the other values on its line of the display. If all of the machine names are highlighted simultaneously, a network outage has possibly disrupted the connections between the File Server machines and the client machine running scout.
The following examples demonstrate the different types of -attention settings. The first example causes scout to highlight entries in the Conn column that exceed 100, entries in the Ws column that exceed 20, and entries in the Disk attn column that reflect aggregate fullness usage of 75% or more on the machines named /.../abc.com/hosts/fs1 and /.../abc.com/hosts/fs2:
$ scout -server /.../abc.com/hosts/fs1 /.../abc.com/hosts/fs2 -attention conn 100 ws 20 disk 75%
The second example is identical to the previous example, except that scout highlights entries in the Disk attn column that fall below 5000 free blocks:
$ scout -server /.../abc.com/hosts/fs1 /.../abc.com/hosts/fs2 -attention disk 5000 ws 20 conn 100
The third example causes scout to highlight entries in the Fetch column that equal or exceed 20,000 fetches:
$ scout -server /.../abc.com/hosts/fs1 /.../abc.com/hosts/fs2 -attention fetch 20000