Product / Mirador Core

Mirador Core

API-first observability intelligence engine that converts telemetry into explainable incident understanding. Mirador Core unifies KPI management, failure detection, statistical correlation, and 5-WHY root cause analysis into one production-grade workflow.

Read Documentation View on GitHub
Open Source API First KPI to RCA Workflow 5-WHY Explainability Docker + Helm + Kubernetes
market.positioning

From Telemetry Signals to Explainable Root Cause

Mirador Core is designed for operations teams that need more than dashboards. It links business-impact KPIs and infrastructure-cause KPIs to produce evidence-backed incident narratives that teams can act on quickly.

The core workflow is connected by design: KPI registry and context feeds failure detection, correlation computes candidate causes, and RCA returns human-readable 5-WHY chains with confidence and timing evidence.

workflow.components

1) KPI Management

  • Define impact and cause KPIs with formulas or query objects
  • Bulk import KPI definitions with JSON or CSV pipelines
  • Use semantic KPI search for faster incident investigation setup
  • Establish a registry-driven foundation for correlation and RCA

2) Failure Detection

  • Detect failures from metrics, logs, and traces in a selected time window
  • Group by service and component with deterministic identifiers
  • Correlate transaction-level failures across distributed services
  • Store and retrieve incidents for postmortem and trend analysis

3) Correlation Analysis

  • Identify red-anchor impact KPIs and ranked cause candidates
  • Score relationships with Pearson, Spearman, partial, and lag evidence
  • Apply temporal ring logic for ordering and causal confidence
  • Constrain analysis windows for predictable operational performance

4) Root Cause Analysis (RCA)

  • Generate structured 5-WHY chains from correlation outputs
  • Return impact summary, chain evidence, and confidence scores
  • Enable explainable narratives for incident reviews and governance
  • Support continuous RCA workflows in proactive operations
feature.matrix

Mirador Core Capability Matrix

This matrix aligns with Mirador Core documentation flow and deployment references across KPI, failures, correlation, RCA, and production operations.

Capability Component API Surface Primary Output Operational Value
KPI Registry and Lifecycle KPI Management /api/v1/kpi/defs Impact and cause KPI definitions Creates a stable monitoring and RCA foundation
Bulk KPI Import KPI Management /api/v1/kpi/defs/bulk-json, /bulk-csv Batch KPI onboarding Accelerates onboarding for large environments
Semantic KPI Search KPI Management /api/v1/kpi/search Ranked KPI candidates Speeds triage during incident response
Multi-Signal Failure Detection Failures /api/v1/unified/failures/detect Incident records with confidence Turns noisy telemetry into actionable failures
Transaction Failure Correlation Failures /api/v1/unified/failures/correlate Cascade and sequence context Improves blast-radius understanding
Statistical Cause Ranking Correlation /api/v1/unified/correlation Suspicion-ranked cause candidates Prioritizes root-cause investigation path
Temporal Ring Analysis Correlation /api/v1/unified/correlation R1 to R4 timing evidence Improves causal ordering and confidence
5-WHY RCA Chains RCA /api/v1/unified/rca Human-readable root-cause narrative Reduces MTTR with explainable outcomes
Health and Metrics Endpoints Operations /health, /ready, /metrics Service health and telemetry Supports production reliability and observability
Deployment and Integration Options Operations Docker, Helm, Kubernetes Environment-specific deployment path Fits both local dev and enterprise clusters
deployment.and.integration

Built for Real Production Constraints

Deployment and Scale

  • Local development with Docker Compose and seeded workflows
  • Helm and Kubernetes deployment for production operations
  • Autoscaling, resource controls, and health-check patterns
  • Monitoring, backup, and rollback procedures in docs

Integration and Governance

  • OpenAPI and Swagger for integration-first implementation
  • CORS, rate limiting, logging, and feature flag controls
  • Authentication options including LDAP and OAuth2
  • Optional tenant-data integration via MariaDB patterns
go.to.production

Investigate Faster with Explainable Evidence

Mirador Core helps teams move from alert noise to clear, evidence-backed root cause decisions. Start with KPI modeling, operationalize failure and correlation workflows, and embed 5-WHY RCA into everyday incident response.

Start with the User Guide Back to Products