Engineering Insights
Engineering Insights provides data-driven metrics about your engineering organization, including DORA metrics, bus factor analysis, and code freshness tracking.
DORA Metrics
Section titled “DORA Metrics”Shoehorn tracks the four key DORA (DevOps Research and Assessment) metrics:
| Metric | Description | How It’s Measured |
|---|---|---|
| Deployment Frequency | How often code is deployed to production | Count of deployments per time period |
| Lead Time for Changes | Time from commit to production deployment | Merge timestamp to deploy timestamp |
| Change Failure Rate | Percentage of deployments causing failures | Failed deploys / total deploys |
| Time to Restore Service | Time to recover from a failure | Incident start to resolution |
Viewing DORA Metrics
Section titled “Viewing DORA Metrics”Navigate to Insights > DORA to see metrics across your organization.
Filter by:
- Time period (7d, 30d, 90d)
- Team
- Entity
- Environment
Bus Factor Analysis
Section titled “Bus Factor Analysis”Bus factor identifies knowledge concentration risks: how many people would need to leave before a project stalls.
What’s Measured
Section titled “What’s Measured”- Commit distribution: How evenly code changes are spread across contributors
- Knowledge silos: Files or modules touched by only one person
- Risk entities: Services with a bus factor of 1 (single contributor)
Viewing Bus Factor
Section titled “Viewing Bus Factor”Navigate to Insights > Bus Factor to see:
- Organization-wide bus factor summary
- Per-entity risk scores
- Team-level knowledge distribution
- Recommendations for knowledge sharing
Code Freshness
Section titled “Code Freshness”Track repository activity and identify stale services.
Freshness Categories
Section titled “Freshness Categories”| Category | Criteria | Meaning |
|---|---|---|
| Fresh | Updated within 30 days | Actively maintained |
| Aging | Updated 30-90 days ago | May need attention |
| Stale | Not updated in 90+ days | Potentially abandoned |
Viewing Freshness
Section titled “Viewing Freshness”Navigate to Insights > Code Freshness or check the governance documentation health dashboard.
Data Sources
Section titled “Data Sources”Engineering insights are aggregated from:
- GitHub: Commit history, PR activity, contributor data
- Kubernetes: Deployment events, rollout history
- Shoehorn events: Entity changes, governance actions