Datahub Influx DB
InfluxDB / Time Series
Query historical time-series data from the Litmus Edge tsdata InfluxDB.
Tool | Description |
|---|---|
get_historical_data_from_influxdb ** | Query historical time-series data by measurement and time range. |
list_influxdb_measurements ** | List all measurement names in tsdata. Use for discovery before more specific queries. |
get_device_historical_data ** | Fuzzy-match device names to InfluxDB measurements and pull historical data per match. |
query_tag_data ** | Query historical data for a specific tag by resolving its output topic. Newest-first. |
get_tag_statistics ** | Aggregate stats for a tag: mean, min, max, stddev, count, plus baseline range (mean +/- 2 sigma). |
get_device_data_for_inference ** | Composite payload for AI inference: device metadata, all tags, per-tag stats, and recent samples. |
When to use which
- Discovery: list_influxdb_measurements to see what's actually being recorded before querying.
- By measurement (raw): get_historical_data_from_influxdb if you already know the measurement name and time range.
- By device (fuzzy): get_device_historical_data when you have a human-readable device name and want everything related.
- By tag: query_tag_data for the per-tag time series.
- Summary stats for a tag: get_tag_statistics. Includes a mean +/- 2 sigma baseline range that's handy for anomaly checks.
- AI inference input: get_device_data_for_inference returns a composite payload (device + tags + stats + recent samples) suitable for handing to a model in one shot.
Requirements
- INFLUX_HOST, INFLUX_PORT (default 8086), INFLUX_DB_NAME (default tsdata), INFLUX_USERNAME, INFLUX_PASSWORD.
- Litmus Edge must allow port 8086/TCP under System -> Network -> Firewall.
- For query_tag_data and similar tag-resolving tools, EDGE_* headers are also required to look up the tag's output topic from DeviceHub.
Setting up firewall access
- Navigate to Litmus Edge -> System -> Network -> Firewall.
- Add a firewall rule to allow port 8086 on TCP.
- Confirm InfluxDB is reachable from the MCP server host (curl http://<edge>:8086/ping).
Related
- DeviceHub, Tags - current value vs. historical.
- NATS Topics - live streams (no persistence).
- get_device_connection_status in DeviceHub, Devices - uses InfluxDB recency to infer connection health.