Page tree

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Agent monitors are service monitors that require an agent to be installed on the monitored system. An agent is software that collects performance information from the system and transmits that information to the Monitoring Station. Using the information gathered by an agent, Uptime Infrastructure Monitor can alert users to changes in an environment based on defined thresholds.

File and Directory

The File and Directory monitor can report the following Directory information:

  • Number of files matching a certain regular expression
  • Largest file size that matches that expression
  • Age (in minutes) of the most recent file
  • Most recent date of the latest file
  • More recent time of the latest file
  • File name that was most recently modified

 

Info

Beginning with Uptime Infrastructure Monitor 7.7, this plugin is included within the product by default.

Configuring File Directory Monitor

Windows

  1. Download the agent ZIP files.
  2. Place the filedircheck-win-agent.vbs file in the Uptime agent directory in a subdirectory called "scripts". (

    C:\Program Files\Uptime Software\Uptime agent\scripts). Create the scripts directory, if needed.

  3. Run as administrator, the Uptime Agent Console (Start > Uptime Agent Console).
  4. Click Advanced > Custom Scripts.
  5. Set up a command like this:
    Command Name: filedircheck
    Path to Script: cscript //nologo "C:\Program Files\Uptime Software\Uptime agent\scripts\filedircheck-win-agent.vbs"

POSIX

  1. Place the needed filedircheck-nix-agent.pl file in the directory /opt/uptime-agent/scripts. Create the scripts directory, if needed.
  2. Create/edit the following password file: /opt/uptime-agent/bin/.uptmpasswd and add the following line to it: filedircheck /opt/uptime-agent/scripts/filedircheck-nix-agent.pl
  3. Run the following commands to change ownership and permission on /opt/uptime-agent/scripts/filedircheck-nix-agent.pl
    chown uptimeagent:uptimeagent /opt/uptime-agent/scripts/filedircheck-nix-agent.plchmod 770 /opt/uptime-agent/sctips/filedircheck-nix-agent.pl

File System Capacity

The File System Capacity monitor checks the amount of available space on a host's file system, and then compares the data to configured warning and critical thresholds. Thresholds can be based on percent free or used, or space free or used (in Megabytes, Gigabytes, or Terabytes).

By default, the service monitor uses global thresholds, which it applies to all local drives on Windows systems, or all local file systems on UNIX and Linux systems (for example, /var, /export, /usr). However, you can fine-tune how file systems are monitored using the following options:

  • Use regular expressions to exclude one or more file systems from the list of default file systems.
  • Use regular expressions to create special cases where the global thresholds are replaced with custom thresholds on one or more mount points.
  • Exclude all file systems from capacity monitoring except for those locations listed as special cases.
  • Disable global thresholds and alert on those defined for each special case.
  • Use a combination of exclusions and special cases to augment the list of default file systems.

When using combinations to fine-tune file system monitoring, note that exclusions override the default file systems, and special cases override the default file systems and exclusions: if the same file system is added as a special case, and also matches a pattern to be excluded, it is still monitored for capacity.

Info

You can monitor Windows Volume Mount Points when the host Element is monitored through WMI and not not the Uptime Infrastructure Monitor agent. for more information about this setup, see Working with Systems.

Configuring File System Capacity Monitor

Whether you want to set up a basic capacity monitor or create specific usage thresholds for 100 file systems, use the following common steps:

  1. Complete the monitor information fields.
    To learn how to configure monitor information fields, see Monitor Identification.
  2. Specify values for the Warning and Critical Response Time thresholds.
    For more information, see Response Time.
    To save the data from the thresholds for graphing or reporting, click the Save for Graphing checkbox.
  3. Complete the following settings:
  4. Configure the options in the File System Capacity Settings section. Refer to the section that applies.

To set a common file system capacity check on local file systems, do the following:

  1. In the Global Settings section, complete the following fields:
    • Global Warning Threshold
      Create a threshold that generates a warning. This threshold can be an actual amount (in MB, GB, or TB), or percentage of disk space that is used or is free.
    • Global Critical Threshold
      Create a threshold that generates a critical alert, whether it is an actual amount, or percentage of disk space used or free.
  2. Ensure the Exclude None option is selected.
    Using this option ensures global thresholds are used in conjunction with special cases.
  3. Click Finish.

To create one or more exclusions from a common capacity check on local file systems, do the following:

  1. In the Global Settings section, complete the following fields:
    • Global Warning Threshold
      Create a threshold that generates a warning. This threshold can be an actual amount (in MB, GB, or TB), or percentage of disk space that is used or is free.
    • Global Critical Threshold
      Create a threshold that generates a critical alert, whether it is an actual amount, or percentage of disk space used or free.
  2. Select the Exclude File Systems Matching these Patterns option.
  3. In the New Pattern box, use a regular expression to exclude specific mount points on the disk from the capacity calculations.
    For example, enter D: (for Windows) or /usr (for Linux or UNIX) to ignore that drive or directory. Enter ^/u.* to ignore all mount points that begin with /u.
  4. Click the (plus) icon to add the regular expression to the Selected Patterns list.
  5. Optionally continue to add patterns until all file system exclusions are accounted for.
  6. Click Finish.

To create custom threshold special cases for a common capacity check on local file systems, do the following:

  1. In the Global Settings section, complete the following fields:
    • Global Warning Threshold
      Create a threshold that generates a warning. This threshold can be an actual amount (in MB, GB, or TB), or percentage of disk space that is used or is free.
    • Global Critical Threshold
      Create a threshold that generates a critical alert, whether it is an actual amount, or percentage of disk space used or free.
  2. Ensure the Exclude None option is selected.
    Using this option ensures global thresholds are used in conjunction with special cases.
  3. For Special Case File Systems, indicate mount points among the local file systems, then create custom thresholds for them:
    • Use a regular expression to indicate the Mount Point among the local file systems. 
    • Create a Warning Level threshold for a Warning Type: a percentage or amount of space used or free on the mount point that, when exceeded, generates a warning.
    • Create a Critical Level threshold for a Critical Type: a percentage or actual amount of space used or free on the mount point that, when exceeded, generates a critical alert.
    Any thresholds defined as special cases replace any Global Settings thresholds, should they apply.
  4. Optionally click the (plus) icon to add mount points until all file systems you wish to add are accounted for.
  5. Click Finish.

To monitor only specific file systems for capacity, do the following:

  1. Select the Exclude All Except Special Cases option.
    Using this option ignores the default list of local file systems from capacity monitoring.
  2. For Special Case File Systems, include specific mount points you would like to monitor:
    • Use a regular expression to indicate the Mount Point among the local file systems.
    • Create a Warning Level threshold for a Warning Type: a percentage or amount of space used or free on the mount point that, when exceeded, generates a warning.
    • Create a Critical Level threshold for a Critical Type: a percentage or actual amount of space used or free on the mount point that, when exceeded, generates a critical alert.
  3. Optionally click the (plus) icon to add mount points until all file systems you wish to add are accounted for.
  4. Click Finish.

To monitor local file systems for capacity with some exceptions and special cases, do the following:

  1. In the Global Settings section, complete the following fields:
    • Global Warning Threshold
      Create a threshold that generates a warning. This threshold can be an actual amount (in MB, GB, or TB), or percentage of disk space that is used or is free.
    • Global Critical Threshold
      Create a threshold that generates a critical alert, whether it is an actual amount, or percentage of disk space used or free.
  2. Select the Exclude File Systems Matching these Patterns option.
  3. In the New Pattern box, use a regular expression to exclude specific mount points on the disk from the capacity calculations.
    For example, enter D: (for Windows) or /usr (for Linux or UNIX) to ignore that drive or directory. Enter ^/u.* to ignore all mount points that begin with /u.
  4. Click the (plus) icon to add the regular expression to the Selected Patterns list.
  5. Optionally continue to add patterns until all file system exclusions are accounted for.
  6. For Special Case File Systems, indicate mount points among the local file systems, then create custom thresholds for them:
    • Use a regular expression to indicate the Mount Point among the local file systems. 
    • Create a Warning Level threshold for a Warning Type: a percentage or amount of space used or free on the mount point that, when exceeded, generates a warning.
    • Create a Critical Level threshold for a Critical Type: a percentage or actual amount of space used or free on the mount point that, when exceeded, generates a critical alert.
    Any thresholds defined as special cases replace any Global Settings thresholds, should they apply.
  7. Optionally click the (plus) icon to add mount points until all file systems you wish to add are accounted for.
  8. Click Finish.

...