Skip to content

ROX-33197: implement periodic scanning of host paths#329

Open
Molter73 wants to merge 1 commit intomainfrom
mauro/ROX-33197/periodic-inode-scan
Open

ROX-33197: implement periodic scanning of host paths#329
Molter73 wants to merge 1 commit intomainfrom
mauro/ROX-33197/periodic-inode-scan

Conversation

@Molter73
Copy link
Contributor

@Molter73 Molter73 commented Feb 25, 2026

Description

The purpose of this scan is to mitigate any inconsistencies in the inode tracking we might get from missed events on the kernel and will also update the maps on a configuration change. The existing scan method is extended to first cleanup any items that are no longer monitored or don't exist anymore on the host, then directories that are to be monitored are scanned and the inode maps are populated from the files found.

The scan interval is set to 30 seconds by default, but can be modified through the regular configuration methods (file, env var, CLI arg). Unit tests for parsing of this new configuration value have been added.

Some basic metrics have been added to the host_scanner module, these will keep track of:

  • Events coming through that get their host path filled in.
  • Elements being updated/removed during a scan.

Finally, some integration tests that changed the monitored path are fixed. With these changes, the scanning of new monitored paths are causing the host path on those tests to be populated correctly, showing the scan works as expected.

Checklist

  • Investigated and inspected CI test results
  • Updated documentation accordingly

Automated testing

  • Added unit tests
  • Added integration tests
  • Added regression tests

If any of these don't apply, please comment below.

Testing Performed

Manually tested locally.

@Molter73 Molter73 requested a review from a team as a code owner February 25, 2026 11:43
The purpose of this scan is to mitigate any inconsistencies in the inode
tracking we might get from missed events on the kernel and will also
update the maps on a configuration change. The existing scan method is
extended to first cleanup any items that are no longer monitored or
don't exist anymore on the host, then directories that are to be
monitored are scanned and the inode maps are populated from the files
found.

The scan interval is set to 30 seconds by default, but can be modified
through the regular configuration methods (file, env var, CLI arg). Unit
tests for parsing of this new configuration value have been added.

Some basic metrics have been added to the host_scanner module, these
will keep track of:
- Events coming through that get their host path filled in.
- Elements being updated/removed during a scan.

Finally, some integration tests that changed the monitored path are
fixed. With these changes, the scanning of new monitored paths are
causing the host path on those tests to be populated correctly, showing
the scan works as expected.
@Molter73 Molter73 force-pushed the mauro/ROX-33197/periodic-inode-scan branch from 0bc9f14 to 44d6f8f Compare February 25, 2026 15:28
@Molter73 Molter73 enabled auto-merge (squash) February 25, 2026 15:28
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant