Historian¶
The Historian gives you a scrollable, time-navigable view of all recorded CNC data for a machine. Unlike the Live Dashboard — which always shows the current moment — the Historian lets you go back in time, review a past shift, investigate an alarm event, or track tool wear trends over days or weeks.
Opening the Historian¶
From the machine detail page, click the History button in the top-right corner of the header. You will be taken to the Historian for that machine.
To return to the live view, click the back arrow at the top left.
Time range controls¶
At the top of the Historian you will find controls for selecting the time window you want to view.
Quick presets¶
| Button | Window |
|---|---|
| 1h | Last 1 hour |
| 4h | Last 4 hours |
| 8h | Last 8 hours (default — one shift) |
| 24h | Last 24 hours |
| 7d | Last 7 days |
Custom range¶
Use the two date-time fields to set an exact start and end time. Changes take effect immediately.
Resolution¶
Controls how the time-series data is bucketed:
| Setting | Behaviour |
|---|---|
| Auto (default) | Uses 1-minute buckets for ranges ≤ 4 hours; 1-hour buckets for longer ranges |
| 1-min | Always uses 1-minute granularity — best for short windows and detailed analysis |
| 1-hr | Always uses 1-hour granularity — best for multi-day trend views |
The active resolution is shown in brackets next to the toggle, e.g. (1hr).
Note: Axis position data is only available at 1-minute resolution. The Axes panel is hidden when 1-hour resolution is active.
Panels¶
Each panel covers a different aspect of the machine. Panels are collapsible — click the panel title to expand or collapse it. All panels load together when you change the time range.
Machine State¶
Shows how long the machine spent in each state during each time bucket.
| Colour | State | Meaning |
|---|---|---|
| Green | Running | Machine was actively executing a program |
| Amber | Idle | Machine was powered on but not running |
| Red | Alarm | An alarm condition was active |
Each bar represents one time bucket (1 minute or 1 hour). The height of each colour segment shows the number of seconds spent in that state within the bucket. A full green bar means the machine ran for the entire bucket with no idle or alarm time.
Use this panel to quickly spot downtime periods, recurring alarms, or shift patterns.
Performance¶
Shows feed rate and production output over time.
| Line / Bar | What it shows |
|---|---|
| Blue line | Average feed rate (mm/min) during the bucket |
| Purple dashed line | Average spindle speed (RPM) during the bucket |
| Green bar | Number of parts produced during the bucket |
Use this panel to see if feed rates dropped during a shift, or to correlate part output with spindle speed changes.
Spindles¶
One chart per spindle on the machine. Each chart shows three signals:
| Signal | Meaning |
|---|---|
| Speed avg (RPM) | Average spindle speed during the bucket |
| Load avg (%) | Average spindle motor load as a percentage of rated capacity |
| Motor temp (°C) | Temperature of the spindle motor at the end of the bucket |
Watch the load % and motor temperature trends for early signs of spindle wear or bearing issues.
Cycle Time Trend¶
Shows the duration of each completed machining cycle as a bar chart, with a detailed table below.
The bar chart gives a quick visual of whether cycle times are consistent or drifting. Click a column header in the table to sort by that field.
| Column | Meaning |
|---|---|
| Start / End | When the cycle began and completed |
| Duration | How long the cycle took |
| Program | The O-number of the program that ran |
| Parts | The cumulative part count at cycle end |
A gradually increasing cycle time often indicates tool wear or an upstream material issue.
Tool Wear¶
Shows tool offset changes recorded during the selected window. Each point represents a moment when an operator (or automatic compensation) adjusted a tool offset.
- Each coloured series is one tool + offset type combination (e.g. T1 geometry_length, T3 wear_radius)
- Points are connected by lines to show the progression of the value over time
- Up to 8 tool/type combinations are plotted simultaneously
The table below the chart lists every recorded change in detail:
| Column | Meaning |
|---|---|
| Changed At | When the offset was adjusted |
| Tool | Tool number (T1, T2, …) |
| Type | The offset type (geometry_length, wear_radius, etc.) |
| Old / New | The value before and after the change (mm) |
| Δ | The difference — positive means the value increased, negative means it decreased |
A gradual positive drift in wear offsets over time is normal tool wear compensation. A sudden large change typically indicates a tool replacement.
Alarms¶
A sortable table of all alarm events within the selected time range.
| Column | Meaning |
|---|---|
| Code | The alarm code from the CNC controller |
| Message | The alarm description |
| Severity | Error (red), Warning (amber), or Info (blue) |
| Started | When the alarm was triggered |
| Ended | When the alarm was cleared. Active means it is still unresolved |
| Duration | How long the alarm was active |
Click any column header to sort by that field. Click again to reverse the sort order.
Use this panel to find recurring alarm codes, measure how long alarms are taking to resolve, and cross-reference alarm timing with the Machine State panel.