Skip to content

docs: note mute/active time intervals are not inherited #5440

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
locker95 wants to merge 1 commit into
base: main
Choose a base branch
from
Open

docs: note mute/active time intervals are not inherited #5440

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
18 changes: 16 additions & 2 deletions docs/configuration.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -190,8 +190,16 @@ Routing-related settings allow configuring how alerts are routed, aggregated, th

### `<route>`

A route block defines a node in a routing tree and its children. Its optional
configuration parameters are inherited from its parent node if not set.
A route block defines a node in a routing tree and its children. Most optional
configuration parameters are inherited from its parent node if not set
(`receiver`, `group_by`, `group_wait`, `group_interval`, `repeat_interval`, and
`labels`).

**Exception:** `mute_time_intervals` and `active_time_intervals` are **not**
inherited. A child route that omits them is never muted or restricted by a
parent's intervals—you must list the interval names again on each route that
should honor them. (This matches the current implementation: those fields are
always taken from the route itself, defaulting to empty.)

Every alert enters the routing tree at the configured top-level route, which
must match all alerts (i.e. not have any configured matchers).
Expand Down Expand Up @@ -330,6 +338,9 @@ labels:
# When a route is muted it will not send any notifications, but
# otherwise acts normally (including ending the route-matching process
# if the `continue` option is not set.)
#
# Not inherited from parent routes. Omit this field only if the route
# should never be muted by time intervals (even if a parent lists some).
mute_time_intervals:
[ - <string> ...]

Expand All @@ -340,6 +351,9 @@ mute_time_intervals:
# The route will send notifications only when active, but otherwise
# acts normally (including ending the route-matching process
# if the `continue` option is not set).
#
# Not inherited from parent routes. List intervals on every route that
# should be time-restricted.
active_time_intervals:
[ - <string> ...]

Expand Down