Skip to content

docs: add incident duration calculation and custom date sections#218

Merged
shiini2 merged 2 commits intomainfrom
docs/incident-duration-calculation
Mar 17, 2026
Merged

docs: add incident duration calculation and custom date sections#218
shiini2 merged 2 commits intomainfrom
docs/incident-duration-calculation

Conversation

@shiini2
Copy link
Contributor

@shiini2 shiini2 commented Mar 17, 2026

Summary

  • Added "Incident duration" section explaining how duration is calculated (first update → first resolved update that closed the incident, with re-open/re-resolve logic)
  • Added "Adjusting incident duration with custom dates" subsection explaining how editing the public date on updates affects the duration
image

Related: https://github.com/checkly/monorepo/pull/950

Incident duration measures the actual downtime of your service. It is calculated based on the timestamps of your incident updates:

- **Resolved incidents**: Duration is measured from the first update to the first resolved update that closed the incident. If the incident was later re-opened and resolved again, the duration extends to the final resolved update.
- **Ongoing incidents**: Duration is measured from the first update to the current time.
Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Currently this will often be off by up to ~2 minutes because we get this from the backend then we cache it

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

not sure if we should specify this in the docs, I could probably eventually find a workaround for this

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Yeah I wouldn't mention it yet?

@shiini2 shiini2 merged commit 6def0a8 into main Mar 17, 2026
3 checks passed
@shiini2
Copy link
Contributor Author

shiini2 commented Mar 17, 2026

@thebiglabasky how does one go about deploying to docs? 🤔 not seeing any workflow getting triggered, and my changes didn't seem to make it to prod either

edit: took a while but it's on prod now

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants