Overview
A clock enforces a service level agreement by tracking elapsed time on an item. Every item is on a clock automatically from the moment it is created. Clocks track elapsed time against a target and flag items that are approaching or past their deadline. Each process sets the expected time-to-close in hours using rules, and the clock calculates how much time remains. Different containers can use different clock configurations. A support container can run 24x7, while a development container runs during working hours only. This is how enterprise customers drive differing service level agreements across the business. Clocks are separate from time tracking. Time tracking records hours worked by people. Clocks track elapsed calendar time against SLA targets.Clock configuration
You manage clocks under Settings > Clock. Each clock configuration defines working times, days, and non-working days, and can be scoped to specific containers or applied globally.| Property | Description | Default |
|---|---|---|
| Name | Configuration name | ”Default” |
| Container | Which containers use this clock (select All for global) | All |
| Timezone | Timezone for all clock calculations | UTC |
| Start of day | When the working day begins (HH:MM, 24-hour) | 09:00 |
| End of day | When the working day ends (HH:MM, 24-hour) | 17:00 |
| Start of week | First working day | Monday |
| End of week | Last working day | Friday |
| Working clock | Whether the clock runs 24x7 or working hours only | Working hours only |
| Non-working days | Holidays and closures in YYYY-MM-DD format | — |
How clocks work
Every item carries four clock fields:| Field | Description |
|---|---|
| Clock start | When the clock started ticking (set automatically on item creation) |
| Clock finish | When the item should be completed by (calculated from start + hours + calendar) |
| Clock hours | The estimated time-to-close in hours (set via process rules) |
| Clock delta | Hours remaining until the deadline |
Start time
The clock starts automatically when an item is created. Start time can only be changed through rules — users cannot edit it directly. If an item is created outside of working hours, the clock aligns to the next working day start.Finish time
The finish time is calculated by projecting the clock hours forward from the start time, counting only working hours:Align to working hours
If the start time falls before the start of day, it moves forward to the start of day. If it falls after end of day, it moves to the next working day.
Count working hours
The system steps through each day, subtracting available working hours from the total. Non-working days and holidays are skipped entirely.
The finish time is always calculated. Users cannot edit it directly. To change the finish time, adjust the start time via a rule or change the clock hours.
Delta
The delta is the remaining hours until the deadline. Ekso calculates how many working hours have elapsed since the clock started, then subtracts from the total clock hours: Delta = Clock hours − Working hours elapsed A positive delta means time remains. A zero or negative delta means the SLA target has been reached or breached.Color coding
The clock status is based on the percentage of time consumed, not the absolute delta. Ekso calculates what percentage of the total clock hours have elapsed, then compares against configurable thresholds.| Status | Default threshold | Meaning |
|---|---|---|
| Green | 0–69% consumed | On time — most of the time budget remains |
| Amber | 70–94% consumed | Warning — approaching the deadline |
| Red | 95–100% consumed | Breach — the SLA target has been exceeded or nearly exceeded |
| Threshold | Default | Description |
|---|---|---|
| Green threshold | 0% | Percentage at which status becomes green (always starts at 0) |
| Amber threshold | 70% | Percentage at which status changes from green to amber |
| Red threshold | 95% | Percentage at which status changes from amber to red |
Clock processing
Clocks are recalculated automatically every 5 minutes by a background process. This process evaluates all open items across all tenants, applies the appropriate clock configuration, and updates the clock fields. Once an item is closed, its clock is frozen and no longer recalculated. All clock calculations respect the configured timezone. Clock start and finish times are stored in UTC internally but calculated in the clock’s local timezone to ensure working hours align correctly with the business calendar.Breach notifications
When a clock approaches or exceeds the SLA target, Ekso can send breach notification emails. These use conditional checks on the delta value, so you can configure different notifications at different thresholds — for example, send a warning when the clock turns amber and an escalation when it turns red.Clock and rules
Rules interact with clocks in two ways:- Rules can modify the clock start time — for example, to delay the SLA clock based on item priority or to reset it after a status change
- Each process sets the time-to-close (clock hours) using rules, which determines when the finish time falls