Equipment utilization over time
caddis_get_equipment_utilizationRetrieve grouped equipment utilization metrics—running and down seconds bucketed into intervals over a specified time window.
Instructions
Grouped utilization metrics for a piece of equipment. Buckets the running/down seconds into intervals (default '1d') over the requested window in the given timezone (default 'UTC').
Responses are TOON-encoded (toonformat.dev) — a token-efficient JSON dialect mixing YAML-style indentation with CSV-style tables. Example:
name: Caddis Co timezone: America/Denver equipment[3]{id,name,tags,current_status.status,current_status.reason_id}: 1,Mill A,"["cnc","critical"]",running,null 2,"Press, Big",null,down,3 3,Lathe C,null,null,null
Object fields:
key: value; nested objects indent their children.Uniform arrays of objects:
field[N]{cols}:followed by N indented comma-separated rows in column order.Nested objects inside table rows are recursively flattened to dotted columns (e.g.
current_status.status,input_setup.cycle.logic); a null parent yieldsnullacross all its dotted columns (see row 3 above).Primitive arrays at object level:
field[N]: a,b,cinline.Arrays inside table cells are JSON-stringified into a single cell value (
JSON.parse()to recover); empty arrays render asnull(see rows 1–3tagscolumn).Strings with commas/colons/quotes/leading whitespace are double-quoted (escapes:
\\,\"); other strings, numbers, booleans, andnullare bare.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| tz | No | IANA timezone, e.g. 'America/Denver' (default 'UTC') | |
| end | No | ISO 8601 window end (defaults to now) | |
| start | Yes | ISO 8601 window start (required) | |
| equipId | Yes | Numeric identifier (accepts either string or number form) | |
| interval | No | Bucket interval, e.g. '1h', '1d', '1w' (default '1d') |