Recurring maintenance mode for services

Follow

If you perform regularly scheduled maintenance that results in notifications being sent from your monitoring system to PagerDuty, you can use our API to create recurring maintenance windows in PagerDuty to prevent incidents from being triggered during these maintenance periods.

We've created a few different tools to help make this process easy for users who prefer a web UI, as well as those who would rather work in the command line:

(Note: You will need to use a v1 API key.) 

(Note: You will need to use a v1 API key.) 

(Note: You will need a v2 API key.) 

(Note: You will need a v2 API key.) 

Please note the Ruby scripts will not run as is, but require you to substitute your own values for the variables at the points indicated in the source code. Once the substitutions have been made, the script will allow you to create maintenance windows programmatically.

Other values as set in the script you may want to change also. For instance, the maintenance start and end time are 2 hours apart; please change this to adjust the length of time for the maintenance window. The script as written will also create 20 maintenance windows, separated from each other by a week's time; please adjust these values to either adjust the number of windows or the length of time between windows.

Have more questions? Submit a request

Comments

  • Avatar
    Sean McElroy

    This would be a great feature to put in the UI so we don't have to handle this only through the API with a home-grown solution.  Any plans for that?

  • Avatar
    Ryan Hoskin

    Hi Sean,

    We do have recurring maintenance windows as a feature request, although I don't have an ETA on it yet.  I'll add you to the list of users that requested it so that when we do roll it out you will be notified. 

  • Avatar
    Alastair Firth

    +1 on the UI request. 

  • Avatar
    HJ Meulekamp

    And for the rest of the world on windows, a powershell version:

    https://gist.github.com/henkmeulekamp/e1f288716cc055e0e46e

     

  • Avatar
    Jim Dolinski

    +1 on the UI request...Any update? It has been 2+ years.

  • Avatar
    Kat Gaines

    Hi Jim,

    Unfortunately a way to create recurring maintenance windows hasn't made it into our UI yet, and I don't have an ETA to provide at this time. However, we'll make sure to pass your +1 and comment on to our product team! Please feel free to drop us a line at support@pagerduty.com if you have additional feature requests or questions about maintenance windows.

  • Avatar
    Jeff Hailer

    This is a very annoying issue for me right now. Seems like a pretty trivial change to be mulling over for years.

  • Avatar
    Kat Gaines

    Hi Jeff,

    Thanks for sharing your feedback! I've added your +1 to this request and am sharing your comments with our product team.

  • Avatar
    Jim Dolinski

    Python script to schedule via AWS Lambda

    https://bitbucket.org/snippets/jdolinski/nrMAK

  • Avatar
    Jeremy Lenkowski

    This feature has been requested for several year. Our organization now has a need to add a re-occurring maintenance window.

    Why has this not been implemented and let me know the plans you have to add it, Please no excuses.

  • Avatar
    Shaina Vu

    Hi Jeremy, I've just reached out to you via email to continue the discussion.

  • Avatar
    Wally Hass

    Hello - Any update on this being in the UI? This is starting to be become a pain point.

  • Avatar
    Shaina Vu

    Hi Wally. Just sent you an email to get some more information!

  • Avatar
    Jay Tischler

    Is this UI feature being developed, if not, when? We have weekly maintenance windows and all feel this should be achieved through the website.

  • Avatar
    Lisa Thompson

    Hi Jay. I just sent you an email to get additional information about your use case.

  • Avatar
    Jonathan Curry

    If you would like to create multiple maintenance windows with a web UI, we now have one via this JSFiddle: https://jsfiddle.net/webdemo/sjhkdztt/

    Also, although the Ruby script mentioned in this article works with Ruby 2.x, it always required a slight change when using 2.x due to a dependency having changed its name in newer versions. We've gone ahead and updated the dependency name so the script works with Ruby 2.x out the gate, and we even updated it to use the new API v2 preview, which you can find out more about here: https://v2.developer.pagerduty.com/

    Stay tuned for more updates coming soon!

  • Avatar
    Kevin_VDS

    +1 on the UI request, a petty that such a basic feature so many people needs such a complex workaround.