Page MenuHomePhabricator

Add a section to the SLO template that explains SLO windows, and Pyrra's dashboards and alerts
Closed, ResolvedPublic

Description

I created https://wikitech.wikimedia.org/wiki/SLO/Template_instructions/Dashboards_and_alerts to track all the last discussions/decisions about the integration between rolling and fixed/calendar time windows in the SLO error budget calculations.

We should:

  1. Review and expand the document, reaching a final draft.
  2. Add it to the links in the SLO Template.
  3. Review the current SLOs and make sure they follow the latest guidelines (especially Citoid and EditCheck).

Event Timeline

@Vgutierrez @herron I added more stuff to https://wikitech.wikimedia.org/wiki/SLO/Template_instructions/Dashboards_and_alerts, especially related to alerting. I am planning to have multiple people reviewing it, but lemme know if you like it and if it is close to what we discussed over meetings.

@Vgutierrez @herron I added more stuff to https://wikitech.wikimedia.org/wiki/SLO/Template_instructions/Dashboards_and_alerts, especially related to alerting. I am planning to have multiple people reviewing it, but lemme know if you like it and if it is close to what we discussed over meetings.

Thank you! I made a handfull of updates to try and help break the doc up into sections with emphasis on the slo window types/use cases/tooling

Thanks for this! I 've also landed a round of updates today in https://wikitech.wikimedia.org/w/index.php?title=SLO/Template_instructions/Dashboards_and_alerts&diff=prev&oldid=2309464.

No major changes, just clarifications, rewordings and reformatings. Let me know if I messed some context/content up of course.

herron renamed this task from Add a section to the SLO template that explains Pyrra's dashboards and alerts to Add a section to the SLO template that explains SLO windows, and Pyrra's dashboards and alerts.Jun 10 2025, 7:00 PM
elukey claimed this task.

The page got to its last version and it is now part of the official template, thanks all for the inputs and comments. I've also followed up with the Editing team to show them the last changes, and so far it seems they were well received.