Use the Maintenance Windows UI to schedule and manage planned downtime exclusions for one or more service levels.
Before you begin
To use maintenance windows, you need an existing service level or the ability to create one.
Access maintenance windows
To access maintenance windows:
- Go to one.newrelic.com.
- Navigate to Service Levels.
- You can access maintenance windows from two locations:
- For all maintenance windows in the account: From the Service Levels page, open the Maintenance Windows tab.
- For maintenance windows of a specific service level: From the Service Levels page, select an individual service level, then go to the Maintenance Windows page in the left navigation menu.
Schedule a maintenance window
To schedule a maintenance window for one or multiple service levels within the same account, from the Service Levels page or a specific service level's Maintenance Windows page:
Click Schedule maintenance window in the top right corner.
Enter a name for your maintenance window.
From the Account dropdown, select your account (if not already pre-selected). All service levels you select must belong to this account.
From the Frequency dropdown, select:
- Once: For a single maintenance event.
- Daily: Repeats every day.
- Weekly: Repeats on specific days of the week.
- Monthly: Repeats on specific dates or days of the month.
Set the Start date and time and End date and time for the maintenance window.
If you selected a recurring frequency, set the Active from and Active until dates to specify when the recurring maintenance window pattern should begin and end. Select Never ends if the maintenance window should continue indefinitely.
From the Timezone dropdown, select your timezone to ensure the maintenance window runs at the correct local time.
(Optional) In the Description field, add context about the maintenance window.
Select one or more service levels for the maintenance window. You can search by service level names or add filters.
To create the maintenance window, click Schedule.
중요
After scheduling, the maintenance window may take up to a minute to appear. If you don't see it immediately, refresh the page.
View and manage maintenance windows
The Maintenance Windows tab displays maintenance windows with details such as name, service levels, time period, frequency, active period, creator, and description. Each maintenance window also shows a status:
- Scheduled: The maintenance window is configured to run in the future but hasn't started yet.
- Active: The maintenance window is currently running and excluding data from SLO calculations.
- Inactive: The maintenance window has ended and is no longer excluding data.
Edit a maintenance window
To edit an existing maintenance window:
- From the Maintenance Windows page, find the maintenance window you want to edit.
- Click ... > Edit.
- Make your changes and click Schedule.
중요
Editing restrictions apply based on frequency type:
- One-time windows: Can't be edited once the window has started.
- Recurring windows: Can be edited, but not while the window is actively running.
Delete a maintenance window
To delete a maintenance window:
- From the Maintenance Windows page, find the maintenance window you want to delete.
- Click ... > Delete.
- Confirm the deletion.
중요
Deleting a maintenance window doesn't affect the service levels themselves. They continue to track SLO compliance normally without the exclusion period.
Visualize maintenance windows in charts
When viewing a service level's summary page, maintenance windows are displayed visually on your SLO compliance and good/bad events charts:
- Gray bars: Maintenance windows appear as gray shaded areas on the timeline charts.
- Hover details: When you hover over a maintenance window marker, you'll see the maintenance window name, description (if provided), and the exact start and end times.
- No impact on metrics: During maintenance windows, neither good nor bad events are taken into account, so your SLO compliance percentage and remaining error budget are not affected.
팁
During scheduled maintenance windows, any service disruptions or threshold breaches won't impact your SLO compliance or remaining error budget calculations. Your metrics stay accurate and focused on operational periods.
Manage maintenance windows with NerdGraph
As an alternative to the UI, you can create, update, delete, and query maintenance windows programmatically using the NerdGraph API. For the full API reference with sample mutations and queries, refer to NerdGraph tutorial: Manage service level maintenance windows.