Skip to technology filters Skip to main content
Dynatrace Hub

Extend the platform,
empower your team.

Popular searches:
Home hero bg
Filesystem monitoringFilesystem monitoring
Filesystem monitoring

Filesystem monitoring

Monitor your files and folders.

Extension
Free trial
  • Product information
  • Release notes

Overview

filesystem extension, monitor your files on Windows and Linux OneAgent installations.

Targeting can be done by host, host group, management zone or environment. Tags can be applied to segregate your configurations (100 configurations maximum).

For each path check, Dynatrace will create an entity and link it to the matching host. This way, extension filtering and tagging is possible to view your data. The same can be done with alerts.

Checks can be disabled for specific days and at specific times.

Metrics:

  • File count: Number of files matching a pattern

  • File age count: Number of files matching a pattern and an age

  • File age: Age of a specific file (oldest or newest when returning more than 1 file)

  • File size: Size of the files in bytes

  • Mount point: Is a mount point mounted on Unix NFS

Use cases

Path examples:

  • Count the number of log files inside /var/log/myapp
    Select check type = count
    Path = /var/log/myapp/*.log
  • Count the number of log files inside c:\temp
    Select check type = count
    Path = c:\temp*.log
  • Count the number of logs files inside /var/log/myapp and any subdirectories
    Select check type = count
    Path = /var/log/myapp/**/*.log
  • Does the directory mydir inside /tmp exist?
    Select check type = count
    Path /tmp/mydir
    Ensure that the count directories toggle is enabled
  • Count the number of files inside /tmp
    Select check type = count
    Path = /tmp/*
  • Return the total size of all files files inside /var/log/myapp
    Select check type = size
    Path = /var/log/myapp/*
  • Return the age of the oldest file in /tmp/test/
    Select check type = modification age
    Unselect user newest file
    Path = /tmp/test/*
  • Return the number of log files older than 1 hour in /tmp/test
    Select check type = modification age count
    Set Age comparison operator to Older than
    Set the threshold to 60
    Path = /tmp/test/*.log
  • Check if /data/mount-data is mounted
    Select check type = mount point
    Path = /data/mount-data
  • Check that today's log has been produced: /var/mylog20222211.log
    Select check type = count
    Path = /var/mylogYYYYMMDD.log
    Accepts DDMMYYYY, DD-MM-YYYY, DD_MM_YYYY, YYYYMMDD. YYYY-MM-DD, YYYY_MM_DD.
    The date will be the local date where the OneAgent/extension is running.

Schedules:

When schedule is not selected, the check will run 24/7.
If the check should not be performed on a Sunday, select schedule and untick Sunday.

Time windows can be added by entering the start time (use semi colon for multiple windows).
For each time, the schedule duration field will be added to determine the end. See example for only running from 10:00 and 12:00 for 1 hour.

Schedule

File system types

Local File Systems

  • On Linux the extension supports local file systems as long as the dtuser account can see the files. The file must be at least readable by the dtuser if not, it will be invisible to the extension. If you wish to use another account then use the run_as functionality to sudo -u <username> to switch to a user with permissions.

  • On Windows, The file must be at least readable by LOCAL SERVICE if not, it will be invisible to the extension.

NFS

  • On Linux ensure dtuser or the run_as user has permissions.
  • On Windows you are able to see NFS drives ** ONLY IF ** if you run_as another user and enter their information or choose the account from credential vault to run the checks as.
    • Only standard NFS drives connected via Windows Explorer are supported.

Azure Blob storage is supported. When selected, 2 new fields will appear. The azure account and the key.
Ensure that there is connectivity with azure from the oneAgent.

Run As additional information

Windows Run As

  • On Windows run as the user must be able to login locally.
    • Logon Type policy change to allow type 2
  • If you are using a local user for the domain enter prefix the username with ".\" example: .\username

Linux Run As

  • When no username is entered dtuser will run sudo on the checks to elevate privledges.
    • Ensure dtuser has sudo permissions and is setup passwordless in the sudoers file.
  • If you enter a username, it will run sudo -u <username> However, sudo requires the calling user to have permissions. dtuser must be setup passwordless as before above.

Get started

Deployment

Go to the Dynatrace Hub and select the filesystem extension

Create a new configuration.
For each check press the add check button.
Select the check type and enter the relevant details.

Configuration

Once done press next step.
Enter a description for your configuration and press Activate

Wait until the state of the deployment changes from pending to ok. This might take several minutes.

Details

Data

To view your data, go to the data explorer. In the metric box type filesystem and select the relevant metric. Metrics can be split by host, path dataexplorer

To drill down to the host or file check, hover on a data point and click on view path or view host list dataexplorer2

Troubleshooting

If you are not getting the expected results, typically a metric with the value 0 (file size or count for instance) or -1 (file age), it is because the extension doesn't have sufficient privileges to see the folder content. The files are invisible to the extension and it will report the value 0 or -1.
Grant access to all users first in the location and try again. The value should be correct. Once done, narrow down the access to the correct account/group.
Do NOT use the file size metric for calculating the size of big volumes/mount points recursively such as c:\** as it will scan each file and time out.
The same applies to the other metrics when using recursive search with a very large number of files or sub directories.

For more information on which user runs the oneAgent:
Windows
Linux

Alerts

To create alerts go to metric events for alerting

Compatibility information

This a OneAgent extension compatible with Windows and Linux.
Cluster version 1.254 and OneAgent 1.249 minimum.

Azure blob storage is supported

Dynatrace
By Dynatrace
Dynatrace support center
Subscribe to new releases
Copy to clipboard

Extension content

Content typeNumber of items included
metric metadata
5
generic type
1

Full version history

To have more information on how to install the downloaded package, please follow the instructions on this page.
ReleaseDate

Full version history

Bugfix

  • run_as Linux: dtuser correctly calls sudo when a username is omitted.

Full version history

New Feature

  • Run As functionality implemented in Linux.
    • This uses sudo when running checks. Which will call sudo as dtuser. But if the username field has a value it will run sudo -u <username>

Bug Fixes

  • Modification Age check has been fixed on glob patterns, now returns correct age.

Full version history

  • Improves feel of monitoring configuration screen by moving check descriptions to Check type field tooltip

Full version history

BugFix

  • Run_As functionality works as expected again

Full version history

New Features

  • Added ability to enrich metrics with up to 3 additional metadata fields

Full version history

New Feature

  • 3 new dynamic dates where the month is a 3 character identifier
    • DDMMMYYYY ex: 17MAR2025
    • DDMmmYYYY ex: 17Mar2025
    • DDmmmYYYY ex: 12mar2025

Bug Fixes

General

  • AzureFileCount works again.

Run_As bugfixes

  • Spaces in FileName will no longer break checks
  • Backslashes no longer disappear on the path dimension upon ingest to tenant
  • Logging Fix

Full version history

New feature

  • Now has the ability to run as another user on windows hosts.
  • Running as user with permission to access network drives on windows hosts you are now able to query those network drives with selected check.

Full version history

Fixed metric file age count when a file is modified during the check.

Full version history

Added detection of modification time on folders.
Use /tmp/myfolder as path (with no wildcard) to return the most recently modified file date inside the folder.
Useful when files are very transient (appear less than 60 seconds) or with a very large number of files (no scanning required).

Full version history

No release notes

Full version history

Bug fix for mounts points with insufficient privileges errors.

Full version history

No release notes

Dynatrace Hub
Get data into DynatraceBuild your own app
All (775)Log Management and AnalyticsKubernetesAI and LLM ObservabilityInfrastructure ObservabilitySoftware DeliveryApplication ObservabilityApplication SecurityDigital ExperienceBusiness Analytics
Filter
Type
Built and maintained by
Deployment model
SaaS
  • SaaS
  • Managed
Partner FinderBecome a partnerDynatrace Developer

Discover recent additions to Dynatrace

Problems logo

Problems

Analyze abnormal system behavior and performance problems detected by Davis AI.

Logs logo

Logs

Explore all your logs without writing a single query.

Security Investigator logo

Security Investigator

Fast and precise forensics for security and logs on Grail data with DQL queries.

Business Flow logo

Business Flow

Track, analyze, and optimize your critical business processes.

Cost & Carbon Optimization logo

Cost & Carbon Optimization

Track, analyze, and optimize your IT carbon footprint and public cloud costs.

Davis Anomaly Detection logo

Davis Anomaly Detection

Detect anomalies in timeseries using the Davis AI

Analyze your data

Understand your data better with deep insights and clear visualizations.

Notebooks logo

Notebooks

Create powerful, data-driven documents for custom analytics and collaboration.

Dashboards logo

Dashboards

Transform complex data into clear visualizations with custom dashboards.

Automate your processes

Turn data and answers into actions, securely, and at scale.

Workflows logo

Workflows

Automate tasks in your IT landscape, remediate problems, and visualize processes

Jira logo

Jira

Create, query, comment, transition, and resolve Jira tickets within workflows.

Slack logo

Slack

Automate Slack messaging for security incidents, attacks, remediation, and more.

Secure your cloud application

See vulnerabilities and attacks in your environment.

Security Overview logo

Security Overview

Get a comprehensive overview of the security of your applications.

Code-Level Vulnerabilities logo

Code-Level Vulnerabilities

Detect vulnerabilities in your code in real time.

Threats & Exploits logo

Threats & Exploits

Understand, triage, and investigate application security findings and alerts.

Are you looking for something different?

We have hundreds of apps, extensions, and other technologies to customize your environment

Leverage our newest innovations of Dynatrace Saas

Kick-start your app creation

Kick-start your app creation

Whether you’re a beginner or a pro, Dynatrace Developer has the tools and support you need to create incredible apps with minimal effort.
Go to Dynatrace Developer
Upgrading from Dynatrace Managed to SaaS

Upgrading from Dynatrace Managed to SaaS

Drive innovation, speed, and agility in your organization by seamlessly and securely upgrading.
Learn More
Log Management and Analytics

Log Management and Analytics

Innovate faster and more efficiently with unified log management and log analytics for actionable insights and automation.
Learn more