opcua_read_history
Read-only
Read historical OPC-UA node values over a specified time window, returning raw data with timestamps and status codes, and notes if the node is not historized.
Instructions
[READ][risk=low] OPC-UA Historical Access (HDA): raw historical values over a window.
Reads stored history for a node via the server's HistoryRead service, bounded
by ``max_points``. Returns a clear 'unsupported' note when the server does not
historize the node (no crash).
Args:
node_id: The OPC-UA node id to read history for (e.g. ns=2;i=5).
endpoint: Endpoint name from config.
start: ISO-8601 window start (default: 1 hour before end).
end: ISO-8601 window end (default: now).
max_points: Max points to return (capped server-side at 2000).
Returns dict: {node_id, supported (bool), start, end, count,
values:[{value, source_timestamp, status_code}]}.
Example: opcua_read_history(node_id="ns=2;i=5", start="2026-06-28T08:00:00Z").
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| end | No | ||
| start | No | ||
| node_id | Yes | ||
| endpoint | No | ||
| max_points | No |