Monitoring Directories

This article will help you get the Directory plugin for sd-agent configured and returning metrics

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

init_config:

instances:
 - 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 counts, you can do so 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

or

sudo systemctl restart sd-agent

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

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

or

/usr/share/python/sd-agent/agent.py info

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

directory
-----
  - instance #0 [OK]
  - Collected * metrics

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

sudo -u sd-agent /usr/share/python/sd-agent/agent.py 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 directory metrics to display the graphs. The metrics will also be available to select when building dashboard graphs.

Monitored metrics

Metric	Values
system.disk.directory.bytes	/ Type: int
system.disk.directory.file.bytes Total size of the file	byte / None Type: float
system.disk.directory.file.bytes.95percentile	/ Type: int
system.disk.directory.file.bytes.avg	/ Type: int
system.disk.directory.file.bytes.count	/ Type: int
system.disk.directory.file.bytes.max	/ Type: int
system.disk.directory.file.bytes.median	/ Type: int
system.disk.directory.file.created_sec_ago Duration since creation	second / None Type: float
system.disk.directory.file.created_sec_ago.95percentile	/ Type: float
system.disk.directory.file.created_sec_ago.avg	/ Type: float
system.disk.directory.file.created_sec_ago.count	/ Type: int
system.disk.directory.file.created_sec_ago.max	/ Type: float
system.disk.directory.file.created_sec_ago.median	/ Type: float
system.disk.directory.file.modified_sec_ago Duration since last modification	second / None Type: float
system.disk.directory.file.modified_sec_ago.95percentile	/ Type: float
system.disk.directory.file.modified_sec_ago.avg	/ Type: float
system.disk.directory.file.modified_sec_ago.count	/ Type: int
system.disk.directory.file.modified_sec_ago.max	/ Type: float
system.disk.directory.file.modified_sec_ago.median	/ Type: float
system.disk.directory.files	/ Type: int

Metrics Conversion

Please refer to the metrics conversion document to map old metrics names to the new metric names.