Opening the shared document…
Diagram playground
Write a diagram as text and it renders here as you type. Canvas editing for six of ten notations. Nothing leaves your browser. Syntax reference ·
1
archlab 1.0 timeline
2
title "The checkout outage"
3
description "What happened on 3 March, in the order it happened"
4
5
@timeline
6
period "Before anyone noticed"
7
event "A routine index migration started on the orders table"
8
desc "Reviewed, approved, and run at the quietest hour of the week. Nothing about it was unusual."
9
event "Write latency began climbing, slowly enough that no alert fired"
10
desc "The alert threshold was an absolute number rather than a rate of change, which is why forty minutes of steady degradation looked like nothing at all."
11
period "The first hour"
12
event "Checkout error rate crossed the page threshold"
13
event "The on-call engineer rolled back the most recent deploy, which was unrelated, and then rolled back the two before it when the error rate did not move"
14
desc "The migration had run outside the deploy pipeline, so the timeline everyone was reading did not contain the thing that mattered."
15
event "A second engineer joined and found the running migration"
16
period "The fix"
17
event "The migration was cancelled and the table recovered on its own"
18
event "Checkout drained its queue over the following twenty minutes" #recovery
19
period "Afterwards"
20
event "Long-running schema migrations were moved onto the same deploy timeline as everything else, so the one view everybody opens during an incident contains every change"
21
desc "Nobody argued for it before the outage. The argument was that migrations are not deploys, which was true and beside the point."
22
event "Latency alerting gained a rate-of-change rule"
23
event "This document"
24
desc "Written the same week, while people still disagreed about the order, which is the only time a timeline is worth writing."
Tab indents · Esc then Tab leaves the editor · syntax reference
Drawn from the text