Technical Blog Post
Exclude filesystem to monitor defined mount point with APM 8.1.4.x Linux OS Agent
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.
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.
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".
IJ14022: EXCLUDING FILESYSTEMS TYPES ON APM LINUX LINUX OS AGENT ENVIRONMENT (in ITM APAR IV84786)
APAR IJ14022 is included in APM 188.8.131.52.7 Linux agent image refresh (March 2019 ), see
(in APM Private is 7 release *_agents_xlinux_184.108.40.206.7.tar,
in APM Cloud is 6 release *_agents_xlinux_220.127.116.11.6.tar)
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.
Unable to monitor NFS mount point on APM server