IBM Support

Exclude filesystem to monitor defined mount point with APM 8.1.4.x Linux OS Agent

Technical Blog Post


Abstract

Exclude filesystem to monitor defined mount point with APM 8.1.4.x Linux OS Agent

Body

Problem:

The APM Linux OS Agent by default monitors all filesystem (FS) types. There are options to exclude Network File System (NFS) and Common Internet File System (CIFS) types. It now also provides option to filter out other specific types (i.e. exclude).

In servers configurations where there is a huge number of filesystems the Disk data collection may become extremely slow. It would be useful to filter out the filesystem types that are not needed.

 

Description:

In /opt/ibm/apm/agent/config/ lz.environment  can be set additional settings:

KLZ_EXCLUDE_FSTYPE – stop checking defined FS (i.e. exclude)

KBB_SHOW_NFS (true, false)define if NFS is monitored

KBB_SHOW_CIFS (true, false) – define if CIFS is monitored

 

If lz.environment is not available, create lz.environment using provided .lz.environment file and add settings. Recycling the agent is required.

In case of conflict with KBB_SHOW_NFS or KBB_SHOW_CIFS settings, KLZ_EXCLUDE_FSTYPE takes priority.

 

1.example:

Introduced new environment variable that allows to exclude a list of filesystem types. 

KLZ_EXCLUDE_FSTYPE='autofs'  stop checking automount filesystems

KLZ_EXCLUDE_FSTYPE=<comma separated list of types> in lz.environment configuration file. 

Example: KLZ_EXCLUDE_FSTYPE=mvfs,ext3.  The names must match exactly those shown by command "mount -l".

Reference:

IJ14022: EXCLUDING FILESYSTEMS TYPES ON APM LINUX LINUX OS AGENT ENVIRONMENT (in ITM APAR IV84786)

http://www-01.ibm.com/support/docview.wss?crawler=1&uid=swg1IJ14022

APAR IJ14022 is included in APM 8.1.4.0.7 Linux agent image refresh (March 2019 ), see

https://www.ibm.com/support/knowledgecenter/SSHLNR_8.1.4/com.ibm.pm.doc/install/install_download_pm_part_no.htm

(in APM Private is 7 release *_agents_xlinux_8.1.4.0.7.tar,

in APM Cloud is 6 release *_agents_xlinux_8.1.4.0.6.tar)

 

2.example:

The Linux OS agent does not collect NFS filesystem by default. Users can enable the agent to collect NFS filesystems by editing the /config/lz.environment and change KBB_SHOW_NFS=true.

Please note that even with this variable set to enable NFS data collection, it will NOT show up in the default UI dashboard. Users can create a threshold event and view the KLZ_DISK information via the "Attribute Details" user interface.

Reference:

Unable to monitor NFS mount point on APM server

https://developer.ibm.com/answers/questions/391438/unable-to-monitor-nfs-mount-point-on-apm-server/

[{"Business Unit":{"code":"BU011","label":"Systems - zSystems software"},"Product":{"code":"SSVJUL","label":"IBM Application Performance Management"},"Component":"","Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"","Edition":""}]

UID

ibm11277416