Garmingo Docs

Create an Incident

Open a new incident, assign affected monitors, and begin structured updates.

Creating an incident lets you communicate unexpected downtime or degradation in a structured timeline.

When to Open an Incident

  • User-visible impact (latency, errors, partial outage)
  • Degradation expected to persist beyond recovery threshold
  • Security or compliance events (with limited disclosure as needed)

Form Fields

FieldDescriptionGuidance
TitleShort external summaryAvoid blame; focus on symptom
DescriptionInitial context / impact statementUpdate as investigation evolves
Affected MonitorsList of impacted componentsSelect only those directly affected
Impact StatusSeverity classification (degraded/outage)Keep consistent taxonomy
Start TimeWhen impact beganUse earliest known time (estimates okay)
End TimeWhen resolvedLeave empty until confirmed

Workflow Tips

  1. Open early with limited detail (transparency > silence).
  2. Update regularly (15–30 min cadence) even if still investigating.
  3. Mark resolved only after all monitors stable & mitigation verified.
  4. Post‑resolution: add final RCA summary (what happened, user impact, actions).

Avoid Noise

  • Do NOT open incidents for planned maintenance (use Maintenance feature).
  • Combine only tightly related symptoms; separate unrelated failures.

Aftercare

  • Review mean time to detect (MTTD) & mean time to resolve (MTTR) metrics.
  • Feed lessons into runbooks and monitor coverage improvements.