UNIX OS monitoring agent

IBM Tivoli Monitoring > Version 6.3 Fix Pack 2 > Installation Guides > Installation Guide > Agent configuration and environment variables > Environment variables > Operating system agent environment variables
IBM Tivoli Monitoring, Version 6.3 Fix Pack 2

UNIX OS monitoring agent

The table in this section lists the UNIX OS monitoring agent environment variables.

UNIX OS monitoring agent environment variables

Variable Description Possible values Default value
AGENT_TIMING To enable agent internal timers. Y Y

EXCLUDE_LEGACY_
DISKS
To exclude monitoring of disks that follow the HPUX legacy naming convention. [TRUE|true|True] or false, not case-sensitive. false, not case-sensitive

KBB_EXCLUDE_SLOW_
ISATTY
To check the response time of the isatty() system call and eventually skip it to avoid agent hangs. 0 or 1. 0
KBB_SHOW_CUSTOMFS To enable monitoring of a specific filesystem type. Between 0 and 30. blank
KBB_SHOW_NFS Specifies whether NFS monitoring is enabled. The default value is false on Linux and false on UNIX. [true|false], not case-sensitive. false, not case-sensitive

KUX_PROCESS_CMD_
SAMPLE_SECS
An internal caching mechanism improves agent performance, in terms of response time and CPU consumption while collecting process information. The agent updates process information in the cache, related to process PID, command, and arguments, every 120 seconds by default. You can specify a different cache refresh value in the KUX_PROCESS_CMD_ SAMPLE_SECS environment variable. Greater than or equal to 30. 120

KUX_CPUSTAT_
SAMPLE_SECS
To customize attribute values for the total CPU metrics. See the UNIX OS Agent User's Guide. 0, or greater than or equal to 5. 30 seconds

KUX_PROCESS_
SAMPLE_SECS
To customize attribute values for the CPU metrics per process. See the UNIX OS Agent User's Guide. 0, or greater than or equal to 5. 60 seconds

KUX_MAP_SAMPLING_
INTERVAL
To customize the sampling interval for AIX_System_IO metrics. If this variable is set to 0, the samples are taken when the requests come to the agent. See the UNIX OS Agent User's Guide. 0, or greater than or equal to 5. 60 seconds
KUX_AIXDP To disable the AIX data provider metrics collection (new attributes inherited from the AIX Premium Agent).
The minimum AIX requirements to collect metrics from UNIX OS monitoring agent and Premium Monitoring Agent for AIX convergence are:

AIX61F = AIX 6.1 TL5

[true|false], not case-sensitive. true, not case-sensitive
KUX_DEFINED_USERS To enable the Defined Users group on AIX systems. True or false, not case-sensitive. false, not case-sensitive
KUX_GETARGS_DELAY To adjust the interval between subsequent attempts to get Processes command-line arguments (milliseconds - AIX systems only). Between 0 and 1000. 10
KUX_GETPROCS_DELAY To adjust the sampling interval for Process CPU percent utilization (milliseconds - AIX only). 0, or greater than or equal to 1. 2000
KUX_PINGHOSTLIST To set the full qualified path of the file containing the list of servers for the UNIX Ping attribute group. A valid UNIX pathname. blank
KUX_PRCTL_OFF To disable collecting CPUSHARES and SHAREPCT to avoid crashes in the prctl command due to a Solaris Zones bug. [TRUE|true|True] or false, not case-sensitive. false, not case-sensitive

KUX_SKIP_DISABLED_
DISKS
To avoid the OS agent reporting on SAN Physical Disks that are not actually available to the system. [TRUE|true|True] or false, not case-sensitive. false, not case-sensitive
KUX_SKIP_HP_UTMPX To skip counting the number of user sessions for the All Users group on HPUX. True or false, not case-sensitive. false, not case-sensitive
KUX_SKIP_TTY To improve process monitoring performances by skipping TTY names resolution. [TRUE|true|True] or false, not case-sensitive. false, not case-sensitive

KUX_SKIP_UTF8CONV_
PROCESS
To reduce OS agent high CPU consumption when converting strings to UTF8 for large number of Processes. [TRUE|true|True] or false, not case-sensitive. false, not case-sensitive

KUX_TCPSTAT_SAMPLE_
SECS
To tune the sampling interval for the TCP Statistics attribute group (in seconds). Greater than or equal to 5. 30
KBB_NFS_TIMEOUT To tune the timeout on NFS filesystems monitoring (in seconds). Between 1 and 30. 2

KDEBE_FIPS_MODE_
ENABLED
To request GSKit compliance to FIPS 140-2 standards when computing checksums for files in the File Information attribute group. [yes|no], not case-sensitive. no, not case-sensitive

MAX_NUMBER_OF_
DISKS_HPUX
To define an upper limit on the number of disks that the agent can monitor (HP-UX only). Between 0 and 30000. 3500

NETWORK_INTERFACE_
REFRESH_TIME_
HPUX
To tune the frequency of full refresh of network interfaces data (in hours - HPUX only). Between 1 and 168. 0
TTY_REFRESH_TIME To tune the refresh interval of tty<->ttyname mapping table (in minutes). Greater than or equal to 1. 60

UID_USERNAME_
REFRESH_TIME
To tune the refresh interval of uid<->username and gid<->groupname mapping tables (in minutes). Greater than or equal to 1. 60

Parent topic:
Operating system agent environment variables

+
Search Tips | Advanced Search

Variable	Description	Possible values	Default value
AGENT_TIMING	To enable agent internal timers.	Y	Y
EXCLUDE_LEGACY_ DISKS	To exclude monitoring of disks that follow the HPUX legacy naming convention.	[TRUE\|true\|True] or false, not case-sensitive.	false, not case-sensitive
KBB_EXCLUDE_SLOW_ ISATTY	To check the response time of the isatty() system call and eventually skip it to avoid agent hangs.	0 or 1.	0
KBB_SHOW_CUSTOMFS	To enable monitoring of a specific filesystem type.	Between 0 and 30.	blank
KBB_SHOW_NFS	Specifies whether NFS monitoring is enabled. The default value is false on Linux and false on UNIX.	[true\|false], not case-sensitive.	false, not case-sensitive
KUX_PROCESS_CMD_ SAMPLE_SECS	An internal caching mechanism improves agent performance, in terms of response time and CPU consumption while collecting process information. The agent updates process information in the cache, related to process PID, command, and arguments, every 120 seconds by default. You can specify a different cache refresh value in the KUX_PROCESS_CMD_ SAMPLE_SECS environment variable.	Greater than or equal to 30.	120
KUX_CPUSTAT_ SAMPLE_SECS	To customize attribute values for the total CPU metrics. See the UNIX OS Agent User's Guide.	0, or greater than or equal to 5.	30 seconds
KUX_PROCESS_ SAMPLE_SECS	To customize attribute values for the CPU metrics per process. See the UNIX OS Agent User's Guide.	0, or greater than or equal to 5.	60 seconds
KUX_MAP_SAMPLING_ INTERVAL	To customize the sampling interval for AIX_System_IO metrics. If this variable is set to 0, the samples are taken when the requests come to the agent. See the UNIX OS Agent User's Guide.	0, or greater than or equal to 5.	60 seconds
KUX_AIXDP	To disable the AIX data provider metrics collection (new attributes inherited from the AIX Premium Agent). The minimum AIX requirements to collect metrics from UNIX OS monitoring agent and Premium Monitoring Agent for AIX convergence are: AIX61F = AIX 6.1 TL5	[true\|false], not case-sensitive.	true, not case-sensitive
KUX_DEFINED_USERS	To enable the Defined Users group on AIX systems.	True or false, not case-sensitive.	false, not case-sensitive
KUX_GETARGS_DELAY	To adjust the interval between subsequent attempts to get Processes command-line arguments (milliseconds - AIX systems only).	Between 0 and 1000.	10
KUX_GETPROCS_DELAY	To adjust the sampling interval for Process CPU percent utilization (milliseconds - AIX only).	0, or greater than or equal to 1.	2000
KUX_PINGHOSTLIST	To set the full qualified path of the file containing the list of servers for the UNIX Ping attribute group.	A valid UNIX pathname.	blank
KUX_PRCTL_OFF	To disable collecting CPUSHARES and SHAREPCT to avoid crashes in the prctl command due to a Solaris Zones bug.	[TRUE\|true\|True] or false, not case-sensitive.	false, not case-sensitive
KUX_SKIP_DISABLED_ DISKS	To avoid the OS agent reporting on SAN Physical Disks that are not actually available to the system.	[TRUE\|true\|True] or false, not case-sensitive.	false, not case-sensitive
KUX_SKIP_HP_UTMPX	To skip counting the number of user sessions for the All Users group on HPUX.	True or false, not case-sensitive.	false, not case-sensitive
KUX_SKIP_TTY	To improve process monitoring performances by skipping TTY names resolution.	[TRUE\|true\|True] or false, not case-sensitive.	false, not case-sensitive
KUX_SKIP_UTF8CONV_ PROCESS	To reduce OS agent high CPU consumption when converting strings to UTF8 for large number of Processes.	[TRUE\|true\|True] or false, not case-sensitive.	false, not case-sensitive
KUX_TCPSTAT_SAMPLE_ SECS	To tune the sampling interval for the TCP Statistics attribute group (in seconds).	Greater than or equal to 5.	30
KBB_NFS_TIMEOUT	To tune the timeout on NFS filesystems monitoring (in seconds).	Between 1 and 30.	2
KDEBE_FIPS_MODE_ ENABLED	To request GSKit compliance to FIPS 140-2 standards when computing checksums for files in the File Information attribute group.	[yes\|no], not case-sensitive.	no, not case-sensitive
MAX_NUMBER_OF_ DISKS_HPUX	To define an upper limit on the number of disks that the agent can monitor (HP-UX only).	Between 0 and 30000.	3500
NETWORK_INTERFACE_ REFRESH_TIME_ HPUX	To tune the frequency of full refresh of network interfaces data (in hours - HPUX only).	Between 1 and 168.	0
TTY_REFRESH_TIME	To tune the refresh interval of tty<->ttyname mapping table (in minutes).	Greater than or equal to 1.	60
UID_USERNAME_ REFRESH_TIME	To tune the refresh interval of uid<->username and gid<->groupname mapping tables (in minutes).	Greater than or equal to 1.	60