Configuring local environment variables
You can configure the local environment to change behavior of the Monitoring Agent for Linux® OS.
About this task
Complete these steps to configure the Monitoring Agent for Linux OS.
Procedure
- Create the install_dir/config/lz.environment file if the file doesn't exist.
- Edit the install_dir/config/lz.environment file and enter values for the environment variables. For more information about the environment variables that you can configure, see Local Environment Variables following step 3.
- Restart the Monitoring Agent for Linux OS. Note: Do not modify the .lz.environment file since it contains the default settings that are provided by IBM and changes to this file are not preserved when the agent is updated.
- Local Environment Variables:
- KBB_SHOW_MTAB_FS
- This variable controls the Monitoring Agent for Linux OS data
collection for file system. When
KBB_SHOW_MTAB_FS=false, the agent monitors only the file systems that are listed in /etc/fstab. WhenKBB_SHOW_MTAB_FS=true, the agent monitors file systems that are listed in both/etc/fstaband/etc/mtab.Starting with APM 8.1.4.013 (LZ agent version 06.35.14.17), the default value is true.
- KBB_SHOW_CIFS
- Specifies whether CIFS monitoring is enabled. The default value is false. Possible values are 'true' and 'false'.
- KBB_SHOW_NFS
- Specifies whether NFS monitoring is enabled. The default value is false. Possible values are
'true' and 'false'.Note: Even if the value is set to 'true', the UI is configured to not displayed NFS file system information.
- KLZ_EXCLUDE_DOCKER_FS_STR
- Exclude Docker mounts that contain the string defined. This variable is a comma-separated list
of substring part of a mount point to exclude. The default value is set as follows:
KLZ_EXCLUDE_DOCKER_FS_STR=/docker/,/var/lib/kubelet/,/var/lib/docker/,/pods/Note: This variable works together withKBB_SHOW_MTAB_FS=true. - KLZ_EXCLUDE_FSTYPE
- Exclude file system to monitor defined mount point. This variable is a comma-separated list of
file system type. The names must match those names that are shown by the command
"mount -l".Example:
KLZ_EXCLUDE_FSTYPE=mvfs,ext3Note: In a conflict withKBB_SHOW_NFSorKBB_SHOW_CIFSsettings,KLZ_EXCLUDE_FSTYPEtakes priority.