alerting docs: activate active timing time (#107928)

* alerting docs: activate active timing time

rough draft: documentation for active timing feature.

* purdier

* more tweaks

* edits via yuri advice

* prettier

docs/sources/alerting/alerting-rules/create-grafana-managed-rule.md

@@ -302,7 +302,7 @@ Complete the following steps to set up notifications.
 
       All notifications for this alert rule are sent to this contact point automatically and notification policies aren't used.
 
-   1. You can also optionally select a mute timing as well as groupings and timings to define when not to send notifications.
+   1. You can also optionally select a mute or active timing as well as groupings and timings to define when not to send notifications.
 
    **Use notification policy**
 

docs/sources/alerting/configure-notifications/create-silence.md

@@ -14,6 +14,7 @@ keywords:
   - alerting
   - silence
   - mute
+  - active
 labels:
   products:
     - cloud
@@ -67,9 +68,9 @@ Silences stop notifications from being created for a specified time window but d
 Silences are assigned to a [specific Alertmanager](ref:alertmanager-architecture) and only suppress notifications for alerts managed by that Alertmanager.
 {{< /admonition >}}
 
-## Mute timings vs silences
+## Mute and active timings vs silences
 
-[Mute timings](ref:shared-mute-timings) and [silences](ref:shared-silences) are distinct methods to suppress notifications. They do not prevent alert rules from being evaluated or stop alert instances from appearing in the user interface; they only prevent notifications from being created.
+[Mute and active timings](ref:shared-mute-timings) and [silences](ref:shared-silences) are distinct methods to suppress notifications. They do not prevent alert rules from being evaluated or stop alert instances from appearing in the user interface; they only prevent notifications from being created.
 
 The following table highlights the key differences between mute timings and silences.
 

docs/sources/alerting/configure-notifications/mute-timings.md

@@ -4,7 +4,7 @@ aliases:
   - ../unified-alerting/notifications/mute-timings/ # /docs/grafana/<GRAFANA_VERSION>/alerting/unified-alerting/notifications/mute-timings/
   - ../manage-notifications/mute-timings/ # /docs/grafana/<GRAFANA_VERSION>/alerting/manage-notifications/mute-timings/
 canonical: /docs/grafana/latest/alerting/configure-notifications/mute-timings/
-description: Create mute timings to prevent alerts from firing during a specific and reoccurring period of time
+description: Use mute timings and active intervals to manage notification handling during a specific and reoccurring period of time
 keywords:
   - grafana
   - alerting
@@ -12,12 +12,13 @@ keywords:
   - mute
   - mute timings
   - mute time interval
+  - active intervals
 labels:
   products:
     - cloud
     - enterprise
     - oss
-title: Configure mute timings
+title: Configure mute timings and active time intervals
 weight: 430
 refs:
   alertmanager-architecture:
@@ -37,19 +38,23 @@ refs:
       destination: /docs/grafana-cloud/alerting-and-irm/alerting/configure-notifications/mute-timings/
 ---
 
-# Configure mute timings
+# Configure mute timings and active intervals
+
+Mute timing and active time intervals let you determine how your alert notifications are handled during designated periods of time. After you create a time interval, you can apply it as either a mute or active time interval for your notifications policies.
 
 A mute timing is a recurring interval that stops notifications for one or multiple notification policies during a specified period. It suppresses notifications but does not interrupt alert evaluation.
 
 Use mute timings to temporarily pause notifications for a specific recurring period, such as a regular maintenance window or weekends.
 
+The active time interval provide the opposite functionality, where alerts handled by a notification policy are suppressed unless the notification happens at a time that matches the time interval. Use active time intervals for periods where you want to reduce alert noise.
+
 {{< admonition type="note" >}}
-Mute timings are assigned to a [specific Alertmanager](ref:alertmanager-architecture) and only suppress notifications for alerts managed by that Alertmanager.
+Mute timings and active time intervals are assigned to a [specific Alertmanager](ref:alertmanager-architecture) and only suppress notifications for alerts managed by that Alertmanager.
 {{< /admonition >}}
 
-## Mute timings vs silences
+## Mute and active timings vs silences
 
-[Mute timings](ref:shared-mute-timings) and [silences](ref:shared-silences) are distinct methods to suppress notifications. They do not prevent alert rules from being evaluated or stop alert instances from appearing in the user interface; they only prevent notifications from being created.
+[Mute and active timings](ref:shared-mute-timings) and [silences](ref:shared-silences) are distinct methods to suppress notifications. They do not prevent alert rules from being evaluated or stop alert instances from appearing in the user interface; they only prevent notifications from being created.
 
 The following table highlights the key differences between mute timings and silences.
 
@@ -60,28 +65,28 @@ The following table highlights the key differences between mute timings and sile
 
 [//]: <> ({{< docs/shared lookup="alerts/mute-timings-vs-silences.md" source="grafana" version="<GRAFANA_VERSION>" >}})
 
-## Add mute timings
+## Add time intervals
 
 1. In the left-side menu, click **Alerts & IRM**, and then **Alerting**.
-1. Click **Notification policies** and then the **Mute Timings** tab.
+1. Click **Notification policies** and then the **Time intervals** tab.
 1. From the **Alertmanager** dropdown, select an external Alertmanager. By default, the **Grafana Alertmanager** is selected.
-1. Click **+ Add mute timing**.
-1. Fill out the form to create a [time interval](#time-intervals) to match against for your mute timing.
-1. Save your mute timing.
+1. Click **+ Add time interval**.
+1. Fill out the form to create a [time interval](#time-intervals) to match against for your mute or active timing.
+1. Save your changes.
 
-## Add mute timing to a notification policy
+## Assign a time interval to a notification policy
 
 1. In the left-side menu, click **Alerts & IRM**, and then **Alerting**.
 1. Click **Notification policies** and make sure you are on the **Notification Policies** tab.
-1. Find the notification policy you would like to add the mute timing to and click **...** -> **Edit**.
-1. From the **Mute timings** dropdown, choose the mute timings you would like to add to the policy.
+1. Find the notification policy you would like to add the time intervals to and click **...** -> **Edit**.
+1. From either the **Mute timings** or **Active timings** dropdowns, choose the notification timings you would like to add to the policy.
 1. Save your changes.
 
 ## Time intervals
 
 A time interval is a specific duration during which alerts are suppressed. The duration typically consists of a specific time range and the days of the week, month, or year.
 
-A mute timing can contain multiple time intervals.
+A mute or active timing can contain multiple time intervals.
 
 Supported time interval options are: