Logging is here!

Directory

Agent CheckAgent Check

Overview

Capture metrics from directories and files of your choosing. The Agent will collect:

  • number of files
  • file size
  • age of the last modification
  • age of the creation

Setup

Installation

The directory check is packaged with the Agent, so simply install the Agent anywhere you wish to use it.

If you need the newest version of the Directory check, install the dd-check-directory package; this package’s check overrides the one packaged with the Agent. See the integrations-core repository README.md for more details.

Configuration

  1. Edit your directory.yaml file in the Agent’s conf.d directory. See the sample directory.yaml for all available configuration options:
init_config:

instances:
  - directory: "/path/to/directory" # the only required option
    name: "my_monitored_dir"        # What the Agent will tag this directory's metrics with. Defaults to "directory"
    pattern: "*.log"                # defaults to "*" (all files)
    recursive: True                 # default False
    countonly: False                # set to True to only collect the number of files matching 'pattern'. Useful for very large directories.
    ignore_missing: False           # set to True to not raise exceptions on missing or inaccessible directories

Ensure that the user running the Agent process (usually dd-agent) has read access to the directories, subdirectories, and files you configure.

  1. Restart the Agent.

Validation

Run the Agent’s info subcommand and look for directory under the Checks section:

  Checks
  ======
    [...]

    directory
    -------
      - instance #0 [OK]
      - Collected 26 metrics, 0 events & 1 service check

    [...]

Compatibility

The directory check is compatible with all major platforms.

Data Collected

Metrics

system.disk.directory.file.bytes
(gauge)
Total size of the file
shown as byte
system.disk.directory.file.modified_sec_ago
(gauge)
Duration since last modification
shown as second
system.disk.directory.file.created_sec_ago
(gauge)
Duration since creation
shown as second
system.disk.directory.files
(gauge)
Number of files in the directory
shown as file
system.disk.directory.bytes
(gauge)
Total size of the directory
shown as byte

Events

The Directory check does not include any event at this time.

Service Checks

The Directory check does not include any service check at this time.

Troubleshooting

Need help? Contact Datadog Support.

Further Reading

Learn more about infrastructure monitoring and all our integrations on our blog