Monitoring Directories

Configure the Server Density agent to monitor directories and:

• Collect important metrics, such as number of files & file sizes
• View creation/modified time for files

Monitored metrics

  • Bytes
  • Bytes (percentile 95%)
  • Bytes (average)
  • Bytes (count)
  • Bytes (max)
  • Bytes (median)
  • Created Seconds Ago (percentile 95%)
  • Created Seconds Ago (average)
  • Created Seconds Ago (count)
  • Created Seconds Ago (max)
  • Created Seconds Ago (median)
  • Files
  • Modified Seconds Ago (percentile 95%)
  • Modified Seconds Ago (average)
  • Modified Seconds Ago (count)
  • Modified Seconds Ago (max)
  • Modified Seconds Ago (median)

Installing the Directory plugin package

Install the Directory plugin on Debian/Ubuntu:

sudo apt-get install sd-agent-directory

Install the Directory plugin on RHEL/CentOS:

sudo yum install sd-agent-directory

Read more about agent plugins.

Configuring the agent to monitor directories

1. Configure /etc/sd-agent/conf.d/directory.yaml


- directory: "/path/to/directory"

- directory: "/path/to/another/directory"
  • Important: the sd-agent user must be able to read the given directory
  • If you wish to specify other details such as recursion, patterns and gauges by amending the rest of the config file as necessary 
  • If you want to monitor two or more directories you need to ensure you have agent and plugin version 2.03 or above installed.

2. Restart the agent

sudo /etc/init.d/sd-agent restart

Verifying the configuration
Execute info to verify the configuration with the following:

sudo /etc/init.d/sd-agent info 

If the agent has been configured correctly you’ll see an output such as:

  - instance #0 [OK]
  - Collected 1 metrics & 3 service checks

You can also view the metrics returned with the following command:

sudo -u sd-agent /usr/share/python/sd-agent/ check directory

Configuring graphs

Click the name of your server from the Devices list in your Server Density account then go to the Metrics tab. Click the + Graph button on the right then choose the Disk metrics to display the graphs. The metrics will also be available to select when building dashboard graphs.

Was this article helpful?
0 out of 0 found this helpful
Have more questions? Submit a request


Monday  —  Friday.

10am  —  6pm UK.

Dedicated Support.