Sun N1 System Manager 1.1 Administration Guide

Managing Default Threshold Values

Factory-configured default threshold values are provided in the N1 System Manager software for some OS resource utilization thresholds. These values are stated as percentages. Table 5–1 lists default values for these OS resource utilization attributes.


Note –

Setting or modifying threshold values for hardware health attributes is not supported in this version of the Sun N1 System Manager.


Table 5–1 Factory-Configured Default Threshold Values for OS Resource Utilization Attributes

Attribute Name 

Description 

Default Threshold 

Default Threshold 

cpustats.pctusage

Percentage of overall CPU usage 

warninghigh 80%

criticalhigh 90%

cpustats.pctidle

Percentage of CPU idle 

warninglow 20%

criticallow 10%

memusage.pctmemused

Percentage of memory in use 

warninghigh 80%

criticalhigh 90%

memusage.pctmemfree

Percentage of memory free 

warninglow 20%

criticallow 10%

memusage.pctswapused

Percentage of swap space in use 

warninghigh 80%

criticalhigh 90%

fsusage.pctused

Percentage of file system space in use 

warninghigh 80%

criticalhigh 90%

Table 5–2 provides the complete list of OS resource utilization attributes and their default values. Where factory-configured default values exist for attributes, these are shown in parentheses.

Table 5–2 All OS Resource Utilization Attributes

Attribute Name 

Description 

Supported Threshold (Default) 

Supported Threshold (Default) 

cpustats.loadavg1min

System load expressed as average number of queued processes over 1 minute 

warninghigh

criticalhigh

cpustats.loadavg5min

System load expressed as average number of queued processes over 5 minutes 

warninghigh

criticalhigh

cpustats.loadavg15min

System load expressed as average number of queued processes over 15 minutes 

warninghigh

criticalhigh

cpustats.pctusage

Percentage of overall CPU usage 

warninghigh (80%)

criticalhigh (90%)

cpustats.pctidle

Percentage of CPU idle 

warninglow (20%)

criticallow (10%)

memusage.pctmemused

Percentage of memory in use 

warninghigh (80%)

criticalhigh (90%)

memusage.pctmemfree

Percentage of memory free 

warninglow (20%)

criticallow (10%)

memusage.mbmemused

Memory in use in MB 

warninghigh

criticalhigh

memusage.mbmemfree

Memory free in MB 

warninglow

criticallow

memusage.pctswapused

Percentage of swap space in use 

warninghigh (80%)

criticalhigh (90%)

memusage.mbswapfree

Free swap space in MB 

warninglow

criticallow

fsusage.pctused

Percentage of file system space in use 

warninghigh (80%)

criticalhigh (90%)

Changing Threshold Values With the Monitoring Configuration File

You can modify default values for thresholds by editing the monitoring.properties configuration file.

If the monitoring.properties configuration file is not present, create and save it in /etc/opt/sun/n1gc/. The monitoring.properties configuration file is not created by default at installation.

Any entries that you make in the monitoring.properties configuration file for the threshold values of the attributes listed in Table 5–1 overwrite the factory-configured defaults for the corresponding threshold values.

The monitoring.properties configuration file should be stored only on the management server and not on provisionable servers.

Modifying or adding new entries to the monitoring.properties configuration file affects all the provisionable servers managed by the N1 System Manager.

Specific threshold values can be set at the command line by following the procedures described in Setting Threshold Values.

Once a default value for a monitored item has been modified by manually adding it in the monitoring.properties configuration file, that modified default value applies to all provisionable servers except those servers for which specific values for the monitored attribute have been set at the command line.


Note –

You do not need to reboot the management server or the monitored provisionable server for changes to the monitoring.properties file to take effect.


Monitored attributes for hardware health that are declared as percentages cannot be changed either at the command line or in the monitoring.properties file.

ProcedureTo Modify Default Threshold Values for a Server

To modify default threshold values, edit the /etc/opt/sun/n1gc/monitoring.properties file. Only those default threshold values that relate to OS resource utilization attributes can be modified. Hardware health attribute default threshold values cannot be modified for servers.

Before You Begin

To enable the management agent IP and security credentials on a server named server, add the management features on the server as explained in Adding Base and OS Management Features.

Steps
  1. Open the /etc/opt/sun/n1gc/monitoring.properties file.

    If the file does not exist, create it.

  2. Modify or add lines in the monitoring.properties file that describe default threshold values.

    threshold.attribute.threshold value

    The syntax requires the threshold keyword to be followed by the attribute for which you are setting a threshold. The attribute is an OS resource utilization attribute. OS resource utilization attributes are described in OS Resource Utilization Monitoring.

    The threshold is either criticallow, warninglow, warninghigh, or criticalhigh.

    The value is a numeric figure and usually represents a percentage value.

  3. Save the file.

    You do not need to reboot the management server or the provisionable server for the changes to take effect. The modified default threshold values now apply to all servers managed by the N1 System Manager.


Example 5–1 Modifying the Default Threshold Value for File System Usage

This example shows how to modify the default criticalhigh threshold value for file system usage to 75 percent of maximum file system usage capacity. The following line is added to or amended in the /etc/opt/sun/n1gc/monitoring.properties file:


threshold.fsusage.pctused.criticalhigh=75

This value applies to all provisionable servers, unless you have set specific values for the threshold value at the command line, by using the set command as described in Setting Threshold Values.

Threshold values can be disabled. This process is shown in Example 5–4.