Disk

Introduction Copied

The Geneos Disk plugin monitors disk partition usage.

Views Copied

The Disk plugin produces a single view as follows:

Solaris, Linux, AIX Copied

Headline Legend

Name Description
partitionName Name of the disk partition.
freeSpace Space available on the partition.
percentageUsed Percentage of the disk partition used.
fileSystem Name of the file system that the partition is mounted on.
freeInodes Number of free inodes. Displays 0 if inodes are not applicable on the partition. Inodes are considered applicable only if the corresponding filesystem is writable and uses disk blocks. Examples of filesystems that use inodes are ext3, ufs, tmpfs and lofs.
totalInodes Number of total inodes. Displays 0 if inodes are not applicable on the partition.
percentageFreeInodes Percentage of free inodes. Displays N/A if inodes are not applicable on the partition.
totalSpace Total space on the partition.
device Displays the underlying source of the mount point.
status See more information on status below.

Table Legend

Name Description
totalFreeSpace Total space available on the partition

Windows Copied

Headline Legend

Name Description
partitionName Name of the disk partition.
freeSpace Space available on the partition.
percentageUsed Percentage of the disk partition used.
fileSystem Type of file system e.g. FAT32 or NTFS.
totalSpace Total Space on the partition.
device Displays the underlying source of the mount point.
status See more information on status below.

Table Legend

Name Description
totalFreeSpace Total space available on the partition

Status Copied

The status field indicates whether a given partition is valid or invalid. Possible values are:

Value Description
OK The partition is valid.
Fail - Partition invalid The partition is invalid (e.g. you have configured a partition which does not exist). This status indicates that the said partition is stale (e.g. NFS share might have been changed or unshared on the NFS server).
Fail - Partition blocked The system has been unable to ascertain whether the partition is valid or not. This can happen, for example, if it is an NFS filesystem and the network interface on the box that hosts the filesystem has gone down. It may also indicate a leftover NFS mount on /etc/mnttab or /etc/mtab wherein mount information is already unknown.
Fail - Partition and Device invalid The combination of partition and expected device value does not exist in the system.

Monitor share drives on Windows Copied

You can monitor share drives with Disk plugin on Windows by specifying the full UNC path or the path to a folder that contains the server name.

Note

Ensure that the Auto detect option is disabled. Otherwise, it overrides the configured partitions.

Windows shared drives usually require specific user accounts for access. Since the Netprobe is often started as a Windows Service with Local System account, you should check if you have the appropriate user permissions.

If you encounter any user permissions issues, refer to the Toolkit script in the Windows batch file which tries to map the drive:

<sampler name="toolkit_disk_test">
 <sampleInterval>
  <data>3600</data>
 </sampleInterval>
 <plugin>
  <toolkit>
  <samplerScript>
   <data>.\toolkit_disk_test.bat</data>
  </samplerScript>
  <script>
   <contents>
   <data>@echo off
 set GENEOSLOG=c:\temp\geneos_disk_test.log
 echo INFO: Running as user %USERNAME% &gt; %GENEOSLOG% 2&gt;&amp;1
 net use &gt;&gt; %GENEOSLOG% 2&gt;&amp;1
 net use x: \\mywinserver\myshare /persistent:no &gt;&gt; %GENEOSLOG% 2&gt;&amp;1
 net use &gt;&gt; %GENEOSLOG% 2&gt;&amp;1
 net use x: /d &gt;&gt; %GENEOSLOG% 2&gt;&amp;1

 echo row,value
 echo 1,Please check log in %GENEOSLOG%</data>
   </contents>
   <filename>
    <data>.\toolkit_disk_test.bat</data>
   </filename>
  </script>
  </toolkit>
 </plugin>
</sampler>

Plugin Configuration Copied

partitions Copied

List of partitions to monitor.

Mandatory: No

partitions > partition > path Copied

Partition to monitor.

The value of this setting must match a single partition. Multiple partitions can be defined using multiple path settings, but a single path setting must match to a single partition.

Mandatory: No

partitions > partition > alias Copied

An alternative name that can be used to access the partition path.

Note

It is only possible to exclude on partition names.

Mandatory: No

partitions > partition > device Copied

Device to monitor.

The value of this setting should match the device. Multiple devices can be defined using multiple device settings, but a single device setting should match a single device.

Mandatory: No

autoDetect Copied

In locations where different disks are mounted on various machines the overhead of administration can be complex. The autodetect parameter makes it possible to automatically monitor all local file systems without additional configuration.

If set to true this parameter will detect file systems as follows:

Mandatory: No

Default: False

checkNFSPartitions Copied

Set to FALSE to disable checking NFS partitions.

Linux only.

Mandatory: No

Default: true

excludePartitions Copied

List of partitions to exclude.

Mandatory: No

excludePartitions > excludePartition Copied

A combination of path and filesystem to exclude. If either path or file system are not set i.e. the setting is greyed out in the gateway setup editor, they will match everything e.g. if path is set to /export and file system is not set, file system will match everything, so nfs, ext3 etc.

If either path or file system have been set but are empty i.e. nothing has been typed in, the plugin will raise a warning and set it to match everything.

It is only possible to exclude on partition names, not on alias names.

Mandatory: No

excludePartitions > excludePartition > path Copied

The path to be excluded from the partition list. This setting will accept a PCRE regular expression e.g. to exclude only /export and not /export/nas use:

^/export$

A full reference to PCRE can be found here.

Note

The experimental features of PCRE are not currently supported.

Mandatory: No

excludePartitions > excludePartition > fileSystem Copied

The file system to be excluded from the partition list. This setting will accept a PCRE regular expression

A full reference to PCRE can be found here

Note

The experimental features of PCRE are not currently supported.

Mandatory: No

excludePartitions > excludePartition > device Copied

The device to be excluded from the partition list. This setting will accept a PCRE regular expression.

A full reference to PCRE can be found here.

Note

The experimental features of PCRE are not currently supported.

Mandatory: No

matchExactPartitions Copied

Causes partitions to fail if they do not specify the mount point of a file system.

By default, a partition can be any accessible file or directory, and metrics for the parent file-system will be displayed. This is useful when the user is only interested in values such as free space and does not necessarily know or care what the filesystem is or where it is mounted. For example, when monitoring the free space of a directory such as /home/vendor/application the file system could be mounted at /, and /home, or at /home/vendor and possibly even at different places on different servers, in any case the plugin will report the values statistics that apply to that application.

However, this can be a problem when monitoring known mount points on Unix systems because the mount point will still exist as a directory on the parent filesystem and will always report as ‘OK’ whether or not the partition is actually mounted. When using autoDetect this problem can be solved with the expectRows setting. When manually specifying partitions it is necessary to set this flag to true, in which case the partition is only considered OK if it exactly specifies a mount point, as determined by the methods described for autoDetect.

This flag has no effect on Windows netprobes.

Mandatory: No

Default: FALSE

maximumPartitions Copied

Allow configuration of the maximum number of partitions that can be monitored.

If not configured, the maximum number of partitions that can be monitored is limited to 100.

Take care not to increase the maximum number of partitions to be monitored to an unreasonably and unnecessarily high number.

Mandatory: No

Appendix Copied

Windows Default Local Groups Copied

This section shows the tested Windows Default Local Groups across supported Windows platforms using the GENEOS UNIVERSAL Disk Plugin.

disk3

Sampling Time Recommendation for Disk Monitoring Sampler with NFS partition(s) Copied

For NFS partitions, querying status of NFS shared files/directories takes time depending on network speed/topology. The recommended sampling period for the sampler must be as much the same as the time it takes for “df” command to process the query for all parititions, including NFS share(s).

["Geneos"] ["Geneos > Netprobe"] ["Technical Reference"]

Was this topic helpful?