IBM Support

ITM Agent Insights: UNIX OS monitoring agent on AIX and merged attributes from AIX Premium agent

Technical Blog Post


Abstract

ITM Agent Insights: UNIX OS monitoring agent on AIX and merged attributes from AIX Premium agent

Body

The UNIX OS agent - UX - has incorporated numerous attributes that were previously provided by the AIX Premium agent - PX - that was part of the System P package.  If experiencing problems with a "merged" metric, it is important to understand that different subsets of the "PX" metrics were incorporated at different levels of UNIX OS agent.  Depending on which attribute group is not able to be collected, the issue may be due to the version of the UX component on the endpoint (or the level of UX agent application support).

 

Starting with 6.23 Fixpack 1, the UNIX OS agent on AIX platforms added the following "PX" attributes:
http://www.ibm.com/support/knowledgecenter/SSTFXA_6.2.3.1/com.ibm.itm.doc_6.2.3fp1/unixosagent623fp1_user07.htm#wq6


New in this release
For version 6.2.3 Fixpack 1 of the Monitoring Agent for UNIX OS, the following enhancements have been made:
A variety of metrics have been ported from the AIX Premium agent to the Monitoring Agent for UNIX OS. New attribute groups include AIX AMS, AIX Defined Users, AIX Devices, AIX LPAR, AIX WPAR CPU, AIX WPAR File System, AIX WPAR Information, AIX WPAR Network, and AIX WPAR Physical Memory. Note that the data collection for the AIX Defined Users attribute group is by default disabled for performance reasons. You must set KUX_DEFINED_USERS=True in the ux.ini file to enable it. To view the variety of metrics from the AIX Premium agent, see Appendix B. AIX Premium agent attributes.

The minimum AIX requirements to collect the new metrics are
AIX53S = AIX 5.3 TL12
AIX61F = AIX 6.1 TL5
Note that the new metrics are not collected unless your environment meets these minimum AIX requirements.
A new attribute, Volume Group Name (AIX), has been added to the Disk attribute group.
New attributes, Average Service Queue Size (AIX), Parent (AIX), Service Queue Full per Sec (AIX), Transfers KB per Sec (AIX), and Type (AIX), have been added to the Disk Performance attribute group.
A new attribute, Bandwidth Utilization Percent (AIX), has been added to the Network attribute group.
New attributes, Page Space Used (AIX), Resident Data Size (AIX), Resident Text Size (AIX), WLM Name (AIX), and WPAR Name (AIX), have been added to the Process attribute group.
New attributes, Context Switches per Sec (AIX), Logical Context Switches (AIX), and Physical Consumption (AIX), have been added to the SMP CPU attribute group.
New attributes, Number of CPUs (AIX), Physical Consumption (AIX), Stolen Busy Cycles Pct (AIX), Stolen Idle Cycles Pct (AIX), System Software Version (AIX), Time Spent in Hypervisor Pct (AIX), have been added to the System attribute group.
New attributes, Computational Memory (AIX), Decay Rate (AIX), Net Memory Available (MB), Net Memory Available (Percent), Net Memory Used (MB), Net Memory Used (Percent), Non Computational Memory (AIX), Pages Read per Sec (AIX), Pages Written per Sec (AIX), Paging Space Free Pct (AIX), Paging Space Read per Sec (AIX), Paging Space Used Pct (AIX), Paging Space Written per Sec (AIX), Repaging Rate (AIX), and ZFS ARC Size (MB) have been added to the UNIX Memory attribute group.

 

Additional "PX" attributes were incorporated in the 6.3 release of the Monitoring Agent for UNIX OS.
http://www.ibm.com/support/knowledgecenter/SSTFXA_6.3.0/com.ibm.itm.doc_6.3/osunix/new_ux_ug.htm

New in this release
For version 6.3 of the Monitoring Agent for UNIX OS, the following enhancements have been made:
A variety of metrics have been ported from the AIX Premium agent to the Monitoring Agent for UNIX OS. New attribute groups include AIX Logical Volumes, AIX Physical Volumes, AIX Volume Groups, Top CPU Processes, Top Memory Processes, and UNIX Devices.

 

Further "enhancement" of the UNIX OS agent on AIX added additional "PX" metrics at 6.3 Fixpack 2.
Reference DCF 1677856 which cites DOC APAR IV61542 that details the additional metrics added starting at 6.3 FP2
http://www-01.ibm.com/support/docview.wss?uid=swg21677856

http://www-01.ibm.com/support/docview.wss?uid=swg1IV61542

From the details of APAR IV61542, the following additional "PX" metrics were merged into the UX agent:

AIX_Network_Adapters - AIXNETADPT
AIX_MPIO_Attributes - AIXMPIOATR
AIX_MPIO_Status - AIXMPIOSTS
AIX_System_IO - AIXSYSIO
AIX_Memory_Per_Page - AIXPAGMEM

 

Since the various "PX" attributes were added at different levels, it is important as a first step to verify the environment where any problem is reported with these merged metrics to understand if the UNIX OS agent level is sufficient to gather the attribute group.

It is also important to know whether the issue impacts ALL of the merged "PX" metrics, or only specific attribute groups.

Problems with only some metrics point to issues with the version of the UX agent or its application support, or a specific attribute collection issue.

Problems with ALL of the merged "PX" metrics point to general issues with prerequisite levels of AIX, or the aixdp_daemon not running.

 

Confirm the installed UX version / release by review of "cinfo -i" output on the AIX endpoint (or review cinfo.info file from the output from pdcollect utility).

Also confirm the level of UX application support on the ITM infrastructure (TEMS / TEPS / TEPD).

 

After confirming the version / release of the UX component, confirm that the AIX operating system meets the minimum system requirements to provide the metrics.

The minimum AIX requirements to collect the new metrics are
AIX53S = AIX 5.3 TL12
AIX61F = AIX 6.1 TL5
Note that the new metrics are not collected unless your environment meets these minimum AIX requirements.

A quick review of the UX agent's .LG0 file can confirm whether the system does not meet the OS requirement to provide the "PX" metrics:

Look for a "KUXMAA002" message in the <hostname>:KUX.LG0 file on the UX agent endpoint.

Example:

KUXMAA002 The AIX data provider requirements are not met. The aixdp_daemon process will not be started and all related AIX metrics will not be available

 

 

If there is no "KUXMAA002" message in the .LG0 file, confirm that the "aixdp_daemon" process is not disabled by review of the UX agent's .ini file.

 

If the ux.ini file contains KUX_AIXDP=false this will disable the data provider process that the merged "PX" metrics rely on.

 

If the aixdp_daemon is not intentionally disabled by UX configuration setting, check to confirm that the "aixdp_daemon" process is running by review of "ps -ef" at the OS, or by reviewing the contents of "tasklist.info" file from pdcollect ouptut.

 

If the "aixdp_daemon" process is not running, review the UX agent's <hostname>_ux_<decimal start time>.log file for any indication of UX agent processes terminating / crashing.

 

Review the RAS1 tracing in the "aixdp_daemon" RAS1 log.
 

Resolving the overall problem being experienced depends on the nature of the problem.

Since different metrics were incorporated into the UX agent at different levels, it is important to rule out the version of the UX component as being cause simply due to the metric not being available in that version / release.

If the issue is not related to the level of the UX agent including the specific attribute group, make sure the OS meets requirements and that the aixdp_daemon is not intentionally disabled in ux.ini configuration file.

Ruling out the above, if there are still problems, it may require increased diagnostics to gather additional details to RAS1 logs for the attribute collection performed by the aixdp_daemon, or review of traceback / core if the aixdp_daemon is terminating.  This usually requires involving Support through a problem ticket for troubleshooting assistance.

 

DCF 1644193 provides some useful information to understand if the aixdp_daemon data provider is having issues:
http://www-01.ibm.com/support/docview.wss?uid=swg21644193

 

 

Keywords:
drd401709
5724C040U

 

 

Additional ITM Agent Insights series of IBM Tivoli Monitoring Agent blogs are indexed under ITM Agent Insights: Introduction.

 

Tutorials Point

Subscribe and follow us for all the latest information directly on your social feeds:

 

imageimageimage

Check out all our other posts and updates:

Academy Blogs
Academy Videos
Academy Google+
Academy Twitter

image

 

[{"Business Unit":{"code":"BU004","label":"Hybrid Cloud"},"Product":{"code":"","label":""},"Component":"","Platform":[{"code":"","label":""}],"Version":"","Edition":""}]

UID

ibm11083105