diff --git a/content/v2.0/cloud/monitor-alert/notification-rules/_index.md b/content/v2.0/cloud/monitor-alert/notification-rules/_index.md new file mode 100644 index 000000000..8f907fa01 --- /dev/null +++ b/content/v2.0/cloud/monitor-alert/notification-rules/_index.md @@ -0,0 +1,14 @@ +--- +title: Manage notification rules +description: > + Manage notification rules in InfluxDB. +weight: 20 +v2.0/tags: [notifications] +menu: + v2_0: + name: Manage notification rules + parent: Monitor and alert +--- +The following articles provide information on managing your notification rules: + +{{< children >}} diff --git a/content/v2.0/cloud/monitor-alert/notification-rules/create-notification-rules.md b/content/v2.0/cloud/monitor-alert/notification-rules/create-notification-rules.md new file mode 100644 index 000000000..025166030 --- /dev/null +++ b/content/v2.0/cloud/monitor-alert/notification-rules/create-notification-rules.md @@ -0,0 +1,46 @@ +--- +title: Create notification rules +description: > + Create notification rules to receive alerts on your time series data. + +weight: 20 +v2.0/tags: [notifications] +menu: + v2_0: + name: Create notification rules + parent: Manage notification rules +--- + +Once you've set up checks and notification endpoints, create notification rules to alert you. For details, see and . + +## Create a new notification rule in the UI + +1. Select the **Monitoring and Alerting** icon from the sidebar. + + + {{< nav-icon "alerts" >}} + + +2. Under **Notification Rules**, click **+Create**. +3. Complete the **About** section: + 1. In the **Name** field, enter a name for the notification rule. + 2. In the **Schedule Every** field, enter how frequently the rule should run. + 3. In the **Offset** field, enter an offset time. For example,if a task runs on the hour, a 10m offset delays the task to 10 minutes after the hour. Time ranges defined in the task are relative to the specified execution time. +4. In the **Conditions** section, build a condition using a combination of status and tag keys. + 1. Next to **When status**, select a an operator from the drop-down field: + - **is equal to** and then select the status + - **changes from** and then select both statuses + 2. Next to **AND When**, enter one or more tag key-value pairs to filter by. +5. In the **Message** section, select an endpoint to notify. +6. Click **Create Notification Rule**. + +## Clone an existing notification rule in the UI + +1. Select the **Monitoring and Alerting** icon from the sidebar. + + + {{< nav-icon "alert" >}} + + +2. Under **Notification Rules**, hover over the rule you want to clone. +3. Click the clone icon and select **Clone**. The cloned rule appears. diff --git a/content/v2.0/cloud/monitor-alert/notification-rules/delete-notification-rules.md b/content/v2.0/cloud/monitor-alert/notification-rules/delete-notification-rules.md new file mode 100644 index 000000000..ba3d61c31 --- /dev/null +++ b/content/v2.0/cloud/monitor-alert/notification-rules/delete-notification-rules.md @@ -0,0 +1,24 @@ +--- +title: Delete notification rules +description: > + If you no longer need to receive an alert, delete the associated notification rule. + + +weight: 201 +v2.0/tags: [notifications] +menu: + v2_0: + name: Delete notification rules + parent: Manage notification rules +--- + +## Delete a notification rule in the UI + +1. Select the **Monitoring and Alerting** icon from the sidebar. + + + {{< nav-icon "alerts" >}} + + +2. Under **Notification Rules**, find the rule you want to delete. +3. Click the delete icon, then click **Delete** to confirm. diff --git a/content/v2.0/cloud/monitor-alert/notification-rules/update-notfication-rules.md b/content/v2.0/cloud/monitor-alert/notification-rules/update-notfication-rules.md new file mode 100644 index 000000000..cc0a53d23 --- /dev/null +++ b/content/v2.0/cloud/monitor-alert/notification-rules/update-notfication-rules.md @@ -0,0 +1,53 @@ +--- +title: Update notification rules +description: > + Update notification rules to update the notification message or change the schedule or conditions. + +weight: 201 +v2.0/tags: [notifications] +menu: + v2_0: + name: Update notification rules + parent: Manage notification rules +--- + +## Add a label to notification rules + +1. Select the **Monitoring and Alerting** icon from the sidebar. + + + {{< nav-icon "alerts" >}} + + +2. Under **Notification Rules**, click **Add a label** next to the rule you want to add a label to. The **Add Labels** box opens. +3. To add an existing label, select the label from the list. +4. To create and add a new label: + - In the search field, enter the name of the new label. The **Create Label** box opens. + - In the **Description** field, enter an optional description for the label. + - Select a color for the label. + - Click **Create Label**. +5. To remove a label, hover over the label under to a rule and click X. + + +## Disable notification rules + +1. Select the **Monitoring and Alerting** icon from the sidebar. + + + {{< nav-icon "alerts" >}} + + +2. Under **Notification Rules**, find the rule you want to disable. +3. Click the blue toggle to disable the notification rule. + +## Update the name or description for notification rules + +1. Select the **Monitoring and Alerting** icon from the sidebar. + + + {{< nav-icon "alerts" >}} + + +2. Under **Notification Rules**, hover over the name or description of a rule. +3. Click the pencil icon to edit the field. +4. Click outside of the field to save your changes.