camera-uptime-tool
Analyze camera uptime and reliability over a time period. Compute uptime percentages, outage counts, and longest outage durations for one camera or your entire fleet.
Instructions
This tool analyzes camera uptime and reliability over a time period. It computes uptime percentages, outage counts, and longest outage durations.
It has the following modes of operation, determined by the "requestType" parameter:
get-camera-uptime: Get uptime statistics for a single camera. Requires cameraUuid, startTimeSec, and endTimeSec.
get-fleet-uptime: Get uptime statistics for ALL cameras in the organization, sorted by worst uptime first. Includes a fleet-wide summary with averages. Requires startTimeSec and endTimeSec.
startTimeSec and endTimeSec are UNIX timestamps in seconds.
Output filtering (all tools):
includeFields(string[]): Dot-notation paths to keep in the response (e.g."vehicleEvents.vehicleLicensePlate"). Omit to return all fields.filterBy(array): Predicates to filter array items. Each entry:{field, op, value}where op is one of= != > >= < <= contains. All conditions are ANDed. Example:[{field:"vehicleLicensePlate", op:"=", value:"ABC123"}]WARNING: some tool responses exceed 400k characters — use these params to request only the data you need.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| requestType | Yes | The type of uptime request to make. | |
| cameraUuid | Yes | Camera UUID. Required for 'get-camera-uptime'. | |
| startTimeSec | Yes | Start time as UNIX timestamp in seconds. Required for all requests. | |
| endTimeSec | Yes | End time as UNIX timestamp in seconds. Required for all requests. | |
| includeFields | Yes | Dot-notation field paths to include in the response (e.g. "vehicleEvents.vehicleLicensePlate"). Pass null to return all fields. WARNING: some responses can exceed 400k characters — use includeFields to request only the data you need. For high-volume tools this may be required to get a complete answer. | |
| filterBy | Yes | Filter array items in the response by field values. All conditions are ANDed. Example: [{field: "vehicleLicensePlate", op: "=", value: "ABC123"}, {field: "confidence", op: ">", value: 0.8}] Use alongside includeFields to get only the specific records and fields you need. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cameraUptime | No | Uptime stats for a single camera | |
| fleetUptime | No | Uptime stats for all cameras in the fleet, sorted by worst uptime first | |
| fleetSummary | No | Fleet-wide uptime summary | |
| error | No | An error message if the request failed. |