Open source · IoT & Edge

Time Series Gap Detector

Find missing or late windows in time-series telemetry exports.

v0.1.0 · Node.js 22+ · MIT

Browse the public repository · View releases

Offline, read-only analysis of timestamped telemetry exports. It detects missing, duplicate, late, and out-of-order intervals per configured device; it does not contact devices or a time-series database. Node.js 22+, zero dependencies. src/index.mjs exports detectGaps(recordsDoc, policy, {now, deadline}) and TOOLID.

This walkthrough uses the tool's public README and checked-in example files. Run the command from a repository checkout with Node.js 22+; inspect the source before using it on your own files.

Run the checked-in example

node bin/time-series-gap-detector.mjs --root examples --policy policy.json --records passing-records.json
node bin/time-series-gap-detector.mjs --root examples --policy policy.json --records failing-records.json

Read the result

The synthetic examples exit 0 and 1. --help prints usage to stderr; normal runs print a bounded human summary to stderr. Stdout contains only the v1 JSON report.

Where this check stops

This local walkthrough does not establish the state of a live production system or replace the limits documented in the repository.

Before adapting the command to your own workflow, review the accepted inputs, exit codes and safety boundaries in the README.

Compiled with AI assistance from checked-in public documentation and example scripts. Run the example and review the repository's current documentation before relying on its result.