---
title: "Disk"
description: ""
url: "https://docs.itrsgroup.com/docs/geneos/current/collection/disk/index.html"
---
## Introduction

The Geneos Disk plug-in monitors disk partition usage.

## Views

The Disk plug-in produces a single view as follows:

Solaris, Linux, AIX

![](https://docscdn.itrsgroup.com/geneos/images/plug-ins/disk-linux-dataview.png)

**Headline Legend**

<div class="table-container">
<table class="legacy-table"   style="margin-left: 0;margin-right: auto;width: 100%;mc-table-style: url('../Resources/TableStyles/ref_2_col_table.css');" cellspacing="0">
                        <col style="width: 50%;" class="TableStyle-ref_2_col_table-Column-Column1"/>
                        <col style="width: 50%;" class="TableStyle-ref_2_col_table-Column-Column1"/>
                        <thead>
                            <tr class="TableStyle-ref_2_col_table-Head-Header1">
                                <th class="TableStyle-ref_2_col_table-HeadE-Column1-Header1">Value</th>
                                <th class="TableStyle-ref_2_col_table-HeadD-Column1-Header1">Description</th>
                            </tr>
                        </thead>
                        <tbody valign="top">
                            <tr class="TableStyle-ref_2_col_table-Body-Body1">
                                <td class="TableStyle-ref_2_col_table-BodyE-Column1-Body1">OK</td>
                                <td class="TableStyle-ref_2_col_table-BodyD-Column1-Body1">The partition is valid.</td>
                            </tr>
                            <tr class="TableStyle-ref_2_col_table-Body-Body1">
                                <td class="TableStyle-ref_2_col_table-BodyE-Column1-Body1">Fail - Partition invalid</td>
                                <td class="TableStyle-ref_2_col_table-BodyD-Column1-Body1">The partition is invalid (e.g. you have
 configured a partition which does not exist).
 For an NFS mount, this status indicates that
 the said partition is stale (e.g. NFS share
 might have been changed or unshared on the NFS
 server)</td>
                            </tr>
                            <tr class="TableStyle-ref_2_col_table-Body-Body1">
                                <td class="TableStyle-ref_2_col_table-BodyB-Column1-Body1">Fail - Partition blocked</td>
                                <td class="TableStyle-ref_2_col_table-BodyA-Column1-Body1">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</td>
                            </tr>
                        </tbody>
                    </table>
                
</div>

**Table Legend**

<div class="table-container">
<table class="legacy-table"   style="margin-left: 0;margin-right: auto;width: 100%;mc-table-style: url('../Resources/TableStyles/ref_2_col_table.css');" cellspacing="0">
                    <col style="width: 50%;" class="TableStyle-ref_2_col_table-Column-Column1"/>
                    <col style="width: 50%;" class="TableStyle-ref_2_col_table-Column-Column1"/>
                    <thead>
                        <tr class="TableStyle-ref_2_col_table-Head-Header1">
                            <th class="TableStyle-ref_2_col_table-HeadE-Column1-Header1">Name</th>
                            <th class="TableStyle-ref_2_col_table-HeadD-Column1-Header1">Description</th>
                        </tr>
                    </thead>
                    <tbody valign="top">
                        <tr class="TableStyle-ref_2_col_table-Body-Body1">
                            <td class="TableStyle-ref_2_col_table-BodyB-Column1-Body1">totalFreeSpace</td>
                            <td class="TableStyle-ref_2_col_table-BodyA-Column1-Body1">Total space available on the partition</td>
                        </tr>
                    </tbody>
                </table>
                
</div>

Windows

![](https://docscdn.itrsgroup.com/geneos/images/plug-ins/disk-windows-dataview.png)

**Headline Legend**

<div class="table-container">
<table class="legacy-table"   style="margin-left: 0;margin-right: auto;width: 100%;mc-table-style: url('../Resources/TableStyles/ref_2_col_table.css');" cellspacing="0">
                    <col style="width: 50%;" class="TableStyle-ref_2_col_table-Column-Column1"/>
                    <col style="width: 50%;" class="TableStyle-ref_2_col_table-Column-Column1"/>
                    <thead>
                        <tr class="TableStyle-ref_2_col_table-Head-Header1">
                            <th class="TableStyle-ref_2_col_table-HeadE-Column1-Header1">Name</th>
                            <th class="TableStyle-ref_2_col_table-HeadD-Column1-Header1">Description</th>
                        </tr>
                    </thead>
                    <tbody valign="top">
                        <tr class="TableStyle-ref_2_col_table-Body-Body1">
                            <td class="TableStyle-ref_2_col_table-BodyE-Column1-Body1">partitionName</td>
                            <td class="TableStyle-ref_2_col_table-BodyD-Column1-Body1">Name of the disk partition.</td>
                        </tr>
                        <tr class="TableStyle-ref_2_col_table-Body-Body1">
                            <td class="TableStyle-ref_2_col_table-BodyE-Column1-Body1">freeSpace</td>
                            <td class="TableStyle-ref_2_col_table-BodyD-Column1-Body1">Space available on the partition.</td>
                        </tr>
                        <tr class="TableStyle-ref_2_col_table-Body-Body1">
                            <td class="TableStyle-ref_2_col_table-BodyE-Column1-Body1">percentageUsed</td>
                            <td class="TableStyle-ref_2_col_table-BodyD-Column1-Body1">Percentage of the disk partition used.</td>
                        </tr>
                        <tr class="TableStyle-ref_2_col_table-Body-Body1">
                            <td class="TableStyle-ref_2_col_table-BodyE-Column1-Body1">fileSystem</td>
                            <td class="TableStyle-ref_2_col_table-BodyD-Column1-Body1">Name of the file system that the partition is
 mounted on.</td>
                        </tr>
                        <tr class="TableStyle-ref_2_col_table-Body-Body1">
                            <td class="TableStyle-ref_2_col_table-BodyE-Column1-Body1">freeInodes</td>
                            <td class="TableStyle-ref_2_col_table-BodyD-Column1-Body1">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.</td>
                        </tr>
                        <tr class="TableStyle-ref_2_col_table-Body-Body1">
                            <td class="TableStyle-ref_2_col_table-BodyE-Column1-Body1">totalInodes</td>
                            <td class="TableStyle-ref_2_col_table-BodyD-Column1-Body1">Number of total inodes. Displays 0 if inodes
 are not applicable on the partition.</td>
                        </tr>
                        <tr class="TableStyle-ref_2_col_table-Body-Body1">
                            <td class="TableStyle-ref_2_col_table-BodyE-Column1-Body1">percentageFreeInodes</td>
                            <td class="TableStyle-ref_2_col_table-BodyD-Column1-Body1">Percentage of free inodes. Displays N/A if
 inodes are not applicable on the partition.</td>
                        </tr>
                        <tr class="TableStyle-ref_2_col_table-Body-Body1">
                            <td class="TableStyle-ref_2_col_table-BodyE-Column1-Body1">totalSpace</td>
                            <td class="TableStyle-ref_2_col_table-BodyD-Column1-Body1">Total space on the partition.</td>
                        </tr>
                        <tr class="TableStyle-ref_2_col_table-Body-Body1">
                            <td class="TableStyle-ref_2_col_table-BodyE-Column1-Body1">status</td>
                            <td class="TableStyle-ref_2_col_table-BodyD-Column1-Body1">
                        See more information on <a class="reference internal" href="#status"><em>status</em></a> below.
                      </td>
                        </tr>
                        <tr class="TableStyle-ref_2_col_table-Body-Body1">
                            <td class="TableStyle-ref_2_col_table-BodyB-Column1-Body1"> </td>
                            <td class="TableStyle-ref_2_col_table-BodyA-Column1-Body1"> </td>
                        </tr>
                    </tbody>
                </table>
                
</div>

**Table Legend**

<div class="table-container">
<table class="legacy-table"   style="margin-left: 0;margin-right: auto;width: 100%;mc-table-style: url('../Resources/TableStyles/ref_2_col_table.css');" cellspacing="0">
                    <col style="width: 50%;" class="TableStyle-ref_2_col_table-Column-Column1"/>
                    <col style="width: 50%;" class="TableStyle-ref_2_col_table-Column-Column1"/>
                    <thead>
                        <tr class="TableStyle-ref_2_col_table-Head-Header1">
                            <th class="TableStyle-ref_2_col_table-HeadE-Column1-Header1">Name</th>
                            <th class="TableStyle-ref_2_col_table-HeadD-Column1-Header1">Description</th>
                        </tr>
                    </thead>
                    <tbody valign="top">
                        <tr class="TableStyle-ref_2_col_table-Body-Body1">
                            <td class="TableStyle-ref_2_col_table-BodyB-Column1-Body1">totalFreeSpace</td>
                            <td class="TableStyle-ref_2_col_table-BodyA-Column1-Body1">Total space available on the partition</td>
                        </tr>
                    </tbody>
                </table>
                
</div>

### Status

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

<div class="table-container">
<table class="legacy-table"   style="margin-left: 0;margin-right: auto;width: 100%;mc-table-style: url('../Resources/TableStyles/ref_2_col_table.css');" cellspacing="0">
                    <col style="width: 50%;" class="TableStyle-ref_2_col_table-Column-Column1"/>
                    <col style="width: 50%;" class="TableStyle-ref_2_col_table-Column-Column1"/>
                    <thead>
                        <tr class="TableStyle-ref_2_col_table-Head-Header1">
                            <th class="TableStyle-ref_2_col_table-HeadE-Column1-Header1">Name</th>
                            <th class="TableStyle-ref_2_col_table-HeadD-Column1-Header1">Description</th>
                        </tr>
                    </thead>
                    <tbody valign="top">
                        <tr class="TableStyle-ref_2_col_table-Body-Body1">
                            <td class="TableStyle-ref_2_col_table-BodyE-Column1-Body1">partitionName</td>
                            <td class="TableStyle-ref_2_col_table-BodyD-Column1-Body1">Name of the disk partition.</td>
                        </tr>
                        <tr class="TableStyle-ref_2_col_table-Body-Body1">
                            <td class="TableStyle-ref_2_col_table-BodyE-Column1-Body1">freeSpace</td>
                            <td class="TableStyle-ref_2_col_table-BodyD-Column1-Body1">Space available on the partition.</td>
                        </tr>
                        <tr class="TableStyle-ref_2_col_table-Body-Body1">
                            <td class="TableStyle-ref_2_col_table-BodyE-Column1-Body1">percentageUsed</td>
                            <td class="TableStyle-ref_2_col_table-BodyD-Column1-Body1">Percentage of the disk partition used.</td>
                        </tr>
                        <tr class="TableStyle-ref_2_col_table-Body-Body1">
                            <td class="TableStyle-ref_2_col_table-BodyE-Column1-Body1">fileSystem</td>
                            <td class="TableStyle-ref_2_col_table-BodyD-Column1-Body1">Type of file system e.g. FAT32 or NTFS.</td>
                        </tr>
                        <tr class="TableStyle-ref_2_col_table-Body-Body1">
                            <td class="TableStyle-ref_2_col_table-BodyE-Column1-Body1">totalSpace</td>
                            <td class="TableStyle-ref_2_col_table-BodyD-Column1-Body1">Total Space on the partition.</td>
                        </tr>
                        <tr class="TableStyle-ref_2_col_table-Body-Body1">
                            <td class="TableStyle-ref_2_col_table-BodyB-Column1-Body1">status</td>
                            <td class="TableStyle-ref_2_col_table-BodyA-Column1-Body1">
                        See more information on <a class="reference internal" href="#status"><em>status</em></a> below.
                      </td>
                        </tr>
                    </tbody>
                </table>
                
</div>

## Monitor share drives on Windows

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. 


![](https://docscdn.itrsgroup.com/geneos/images/plug-ins/disk-monitor-share-drives.png)

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>

```

## Plug-in Configuration

### partitions

List of partitions to monitor.

Mandatory: No

### partitions > path

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 > alias

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


**Note**

  It is only possible to exclude on partition names. 


Mandatory: No

### autoDetect

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:

- Windows
— all file systems mapped to a drive will be detected.
- Linux and HP — each mounted file system listed in /etc/mtab will be monitored.
- Solaris
— each mounted file system listed in /etc/mnttab will be monitored.
- AIX
— each mounted file system listed by the mount command will be monitored.

 Mandatory: No

Default: False

### checkNFSPartitions

Set to FALSE to disable checking NFS partitions.

Linux only.

 Mandatory: No

Default: true

### excludePartitions

List of partitions to exclude.

Mandatory: No

### excludePartitions > excludePartition

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 plug-in 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

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](http://search.cpan.org/dist/perl/pod/perlre.pod).


**Note**

  The experimental features of PCRE are not currently supported.


Mandatory: No

### excludePartitions > excludePartition > fileSystem

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](http://search.cpan.org/dist/perl/pod/perlre.pod)


**Note**

  The experimental features of PCRE  are not currently supported.


Mandatory: No

### matchExactPartitions

Causes [*partitions*](#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 plug-in 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*](#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*](#autodetect).

This flag has no effect on Windows netprobes.

 Mandatory: No

Default: FALSE

### maximumPartitions

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

### Windows Default Local Groups

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

![disk3](https://docscdn.itrsgroup.com/geneos/images/netprobe/system-images/image3_geneos_-_universal_disk_plug-in.jpg)

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

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).

