Knit IoT - Metrics & KPI Documentation

A complete guide to understanding every card, chart, and metric across the system, including underlying formulas and calculation logic.

1. General Dashboard index.html

Today Count

Formula: IoT Sensor Revolution Counter (Reset daily at 08:00 AM)
The total cumulative production units (rotations) achieved by the machine for the current shift.

Live RPM

Formula: (Rotations in last 5 seconds) × 12
The instantaneous rotations per minute (speed) of the machine right now.

Target Count

Formula: Target RPM × 60 minutes × 24 hours
The theoretical maximum number of units the machine is expected to produce by the end of the full 24-hour shift, based on the optimal Target RPM.

Run Time

Formula: Sum of all seconds where machine was in "Running" state
The total accumulated hours and minutes the machine has been actively running and producing during the current shift.

Total Stop Time

Formula: Shift Elapsed Time - Run Time
The total accumulated time the machine has spent in any stopped state (Idle, Fault, Offline, or Stopped) during the current shift.

Last Stop Duration

Formula: Current Time - Time of last state change to "Stopped"
The exact length of time the machine was inactive during its most recent stoppage.

Last Synchronization

Formula: Current Time - Device last_update_time
The timestamp of the most recent data pulse received from the IoT sensor on the machine. Indicates if the machine is Offline.
2. Live Machine Monitor live_machine_monitor.html

Target Status

Formula: Pacing = (Today Count / Expected Till Now) × 100

Expected Till Now = Target RPM × Shift Elapsed Time (in minutes)
A direct comparison of what the machine *should* have produced by this exact time of day versus what it has *actually* produced.
Threshold Ranges:On Track (Green): ≥ 95% of expected output
Warning (Yellow): 85% to 94.9% of expected output
Behind (Red): < 85% of expected output

Product Performance

Formula: (Today Count / Total Target Count) × 100
The percentage of the total daily Target Count that has been achieved so far today.

Time Utilization

Formula: (Run Time / Total Shift Time of 24h) × 100
The percentage of the shift time that the machine has spent actively running.

Production Efficiency

Formula: (Today Count / (Target RPM × Shift Elapsed Time in minutes)) × 100
A true indicator combining both downtime and speed losses. How efficient the machine was during the time elapsed so far.

Production Rate (Live UPH)

Formula: Today Count / (Run Time in Seconds / 3600)
Units Per Hour (UPH). The actual production speed averaged over the time the machine was actively running.

Average Stop Time

Formula: (Total Stop Time in minutes) / Total Number of Stop Events
Also known as Mean Time To Recover (MTTR). The average length of time a stop lasts.
3. Executive Dashboard downtime_dashboard.html

Total Counter

Formula: Sum of Today Count for all machines
The sum of all production units achieved by all machines combined for the current shift.

Target Counter

Formula: Sum of Target Count for all machines
The sum of all individual machine target quotas combined.

Production Performance

Formula: (Total Counter / Target Counter) × 100
Overall fleet efficiency percentage. Indicates how close the factory is to hitting its absolute maximum potential today.

Time Utilization

Formula: (Total Run Time across all machines / Total Shift Elapsed Time across all machines) × 100
The average machine runtime percentage across the entire factory fleet.

Average Stop Time

Formula: Total Stop Time for all machines / Total Stop Events for all machines
The average duration of a machine stop event, averaged across the entire fleet.

Actual Counter / Hour

Formula: Total Counter / Shift Elapsed Time in Hours
The average number of units being produced factory-wide every hour today.

Target Counter / Hour

Formula: Target Counter / 24 Hours
The expected number of units that *should* be produced factory-wide every hour to stay on track.

Opportunity Cost

Formula: Sum of (Machine Stop Time in Minutes × (Machine Target RPM))
An estimate of how many total units the factory lost due to machine downtime.

Machine Performance Distribution

Formula: Categorize each machine by (Today Count / Expected Till Now) × 100
Breaks down machines into performance tiers based on their current pacing.
Threshold Ranges:On Track (>95%): Machine is meeting expectations.
Warning (85% - 95%): Machine is slightly behind.
Critical (<85%): Machine is severely underperforming.

End of Documentation