KPIs
Yield, contamination, cycle time and financial metrics for your operation, with a confidence rating on each.
KPIs
The KPI Dashboard shows your operation’s key performance indicators, calculated from your blocks, batches, recipes and harvests. Open it from Analytics > KPIs in the sidebar.
Choosing What to Measure
Two controls sit at the top right of the page:
- Substrate or Grain Spawn: which block type to measure. Substrate is selected when the page opens.
- 7d, 30d or 90d: the period. 30 days is selected when the page opens.
Some metrics use only the selected period and others use all of your blocks. The tables below say which.
Core Metrics
| Metric | How it’s calculated |
|---|---|
| Total Yield | Total weight of harvests recorded in the period, in kilograms |
| Active Blocks | Blocks that aren’t Completed, Contaminated or Discarded, right now |
| Contamination Rate | The share of blocks created in the period that are now Contaminated |
| Avg Cycle Time | Average days from a block’s creation to its last update, across all Completed blocks |
Total Yield can also show the change against the previous period of the same length, for example the 30 days before the current 30. It’s left off when neither period has any harvests. Below the metric cards, the Yield Trend chart plots harvest weight across the period in seven steps.
With Grain Spawn selected, two more core metrics appear:
| Metric | How it’s calculated |
|---|---|
| Colonization Success Rate | The share of grain spawn blocks now at Spawn Ready or Completed |
| Avg Colonization Time | Average days from creation to last update for those blocks |
Derived and Strategic Metrics
These sections appear only when a metric has a value above zero.
| Metric | Section | How it’s calculated |
|---|---|---|
| Yield per Block | Derived | Average total yield of all blocks that have been harvested, in grams per block |
| Revenue per Block | Derived | Revenue from harvests in the period, divided by the number of blocks that earned it |
| Gross Margin | Derived | Harvest revenue for the period compared with your recorded batch costs: (revenue − costs) ÷ revenue |
| Projected Monthly Revenue | Strategic | Revenue from harvests in the last 30 days, projected over a month |
| Contamination Cost | Strategic | The per-block cost of every Contaminated block, added up |
Revenue, Gross Margin, Projected Monthly Revenue and Contamination Cost are financial metrics. Only users with the Manager role or above see them.
Where Revenue and Costs Come From
- Revenue is harvest weight times the harvest’s market price per kilogram. Harvests without a market price don’t count toward revenue.
- Batch costs add up the recipe’s ingredient costs plus any labor, substrate, overhead and additional costs recorded on the batch. If the batch has no overhead cost, the recipe’s overhead estimate is used instead. The per-block cost is the batch cost divided by its block count.
Ingredient costs and the overhead estimate are part of each recipe. Harvest market prices and batch labor, substrate and overhead costs aren’t on the web forms. You can send them through the API: market_price_per_kg when you record a harvest, and labor_cost, substrate_cost and overhead_cost when you create a batch. See the API Reference.
Confidence
Each metric card carries a High confidence, Medium confidence or Low confidence badge. Confidence reflects how much data sits behind the number. For example, Avg Cycle Time reaches full confidence once five blocks have completed, and a metric with no data at all shows Low.
To raise confidence, fill the gaps that Data Health points out. The View data health link at the bottom of the page takes you there.
Related Pages
- Data Health: find the missing data that lowers confidence
- Reports: yield, contamination and revenue reports with date ranges
- Harvest Workflow: recording harvests