Skip to main content

Core concepts

Incident A production issue that needs investigation. Incidents are created automatically when a monitoring alert arrives via webhook, or manually by an operator from the dashboard. Investigation The core process. CauseFlow’s AI analyzes different data sources — logs, metrics, infrastructure state, recent code changes, and database health — then synthesizes findings into a root cause analysis. Root cause analysis The synthesized conclusion from the investigation. It explains why the incident occurred, cites the supporting evidence, and includes a confidence score. Remediation A proposed action to resolve the incident. Examples: restart a service, rollback a deployment to a previous version, scale a resource, or create a pull request with a targeted code fix. Remediations require human approval before executing. Pattern A learned root cause pattern extracted from past resolved incidents. Patterns are matched against incoming incidents to accelerate analysis and surface known solutions. Patterns improve over time as your team resolves more incidents. Usage Each plan includes a monthly allowance of investigations and events. One investigation is consumed per full investigation cycle. One event is consumed per incoming alert. See Plans and pricing for limits by plan.

Incident lifecycle

StatusDescription
openIncident created, awaiting analysis
triagingAI classifying severity
investigatingAI analyzing data sources
awaiting_approvalRemediation proposed, waiting for human approval
remediatingApproved remediation being executed
resolvedIncident resolved successfully
closedIncident closed — either resolved or dismissed without remediation

Severity levels

LevelDescription
criticalService outage or data loss affecting all users
highMajor feature degraded with significant user impact
mediumPartial degradation with limited user impact
lowMinor issue with a workaround available
infoInformational alert — no immediate action needed
Severity is set when an incident is created and may be reclassified by CauseFlow based on its analysis of the alert payload and supporting data.

Roles

RolePermissions
adminFull access to all features and settings across all tenants
ownerFull access within their own tenant
operatorTriage, investigate, and approve or reject remediations
viewerRead-only access to incidents and investigations
Role assignment is managed by an owner or admin from Dashboard > Team Management. See RBAC for a detailed permissions breakdown.