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

  1. Create the install_dir/config/lz.environment file if the file doesn't exist.
  2. 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.
  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. When KBB_SHOW_MTAB_FS=true, the agent monitors file systems that are listed in both /etc/fstab and /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 with KBB_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,ext3

    Note: In a conflict with KBB_SHOW_NFS or KBB_SHOW_CIFS settings, KLZ_EXCLUDE_FSTYPE takes priority.