diff --git a/mission-control/docs/notifications/concepts/silence-notification-form.png b/mission-control/docs/notifications/concepts/silence-notification-form.png index 6d15c9f..26d58ab 100644 Binary files a/mission-control/docs/notifications/concepts/silence-notification-form.png and b/mission-control/docs/notifications/concepts/silence-notification-form.png differ diff --git a/mission-control/docs/notifications/concepts/silences.mdx b/mission-control/docs/notifications/concepts/silences.mdx index 39452c0..a01e890 100644 --- a/mission-control/docs/notifications/concepts/silences.mdx +++ b/mission-control/docs/notifications/concepts/silences.mdx @@ -2,8 +2,12 @@ title: Silences --- -Silences prevent notifications from being sent. -Silences are attached to a particular resource (`catalog`, `health check`, or `component`) and are active for a specified duration. +A silence is a way to temporarily suppress notifications. Each silence has: + +- A set duration - like an expiration timer +- A scope - it can be applied to either: + - Individual resources (a specific catalog, health check, or component) + - Multiple matching resources using filters :::note Notifications that aren't sent due to silence are still visible in the notification history for auditing purposes. @@ -22,7 +26,20 @@ on each notification. ![Silence Notification form](./silence-notification-form.png) +### Filters + +A silence can optionally contain a filter. A filter is a cel-expression that results in a boolean value. +If a filter returns a truthy value, the notification is silenced. + +Example: `check.type == 'http'` filter will only silence HTTP check related notifications + +#### Template variables + +- [CheckEvents](/reference/notifications/template_vars/checks) +- [ConfigEvents](/reference/notifications/template_vars/config) +- [ComponentEvents](/reference/notifications/template_vars/components) + ## Recursive mode When a silence is recursively applied, it applies to all of its children. -So silencing a namespace would silence all deployments, statefulsets, pods, etc in that namespace. \ No newline at end of file +So silencing a namespace would silence all deployments, statefulsets, pods, etc in that namespace.