Skip to content

Commit 3e374e3

Browse files
authored
Alerts/Monitors tags (#4605)
* Alerts/Monitors tags * more edits
1 parent f6d8f83 commit 3e374e3

File tree

1 file changed

+22
-41
lines changed

1 file changed

+22
-41
lines changed

docs/alerts/monitors/settings.md

Lines changed: 22 additions & 41 deletions
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,8 @@
11
---
22
id: settings
3-
title: Monitor Settings and Activity
3+
title: Monitor and Alert Settings
44
sidebar_label: Monitor Settings
5-
description: Monitors continuously query your logs or metrics and send notifications when specific events occur, such as critical, warning, and missing data.
5+
description: Monitors continuously query your logs or metrics and send alert notifications when specific events occur, such as critical, warning, and missing data.
66
---
77

88
import useBaseUrl from '@docusaurus/useBaseUrl';
@@ -13,7 +13,6 @@ The **Monitors** page allows you to view, create, manage, and organize your moni
1313

1414
[**New UI**](/docs/get-started/sumo-logic-ui/). To access the Monitors page, in the main Sumo Logic menu select **Alerts > Monitors**. You can also click the **Go To...** menu at the top of the screen and select **Monitors**.
1515

16-
1716
The page displays the following information:
1817
* **Name**. Name of the monitor.
1918
* **Status**. A monitor is considered **Normal** when none of the trigger conditions are met and your data is actively being monitored.
@@ -89,54 +88,36 @@ Note that the same threshold translating functionality supports to [Creating Mon
8988

9089
## Tags
9190

92-
Tagging monitors and alerts can help you categorize, search, filter, and correlate data. These tags are key/value pairs that allow you to apply additional metadata to your monitors and alerts beyond their names and descriptions. Example tag: `team=alerting`, where key is `team` and value is `alerting`.
93-
94-
### Create a tag
91+
Tags allow you to categorize, search, filter, and correlate your monitors and alerts more effectively. They are key/value pairs that add metadata beyond the basic name and description of your monitors and alerts. Example tag: `team=alerting`, where the key is `team` and the value is `alerting`.
9592

96-
To add a tag while creating a new monitor, see [Create a Monitor > Monitor details](/docs/alerts/monitors/create-monitor/#step-5-monitor-details).
93+
### Creating tags
9794

98-
To add a tag to an existing monitor:
95+
You can create and use tags at different stages:
9996

100-
1. [**Classic UI**](/docs/get-started/sumo-logic-ui-classic). In the main Sumo Logic menu, select **Manage Data > Monitoring > Monitors**. <br/>[**New UI**](/docs/get-started/sumo-logic-ui). In the main Sumo Logic menu, select **Alerts > Monitors**. You can also click the **Go To...** menu at the top of the screen and select **Monitors**.
101-
1. Double-click on any monitor in your list.
102-
1. In the side panel, click **Edit**.
103-
1. Under the **Monitor details** step, create a tag using the `key=value` format.
104-
1. Click **Save**.
97+
#### Adding tags while creating a monitor
10598

106-
### Syntax
99+
When setting up a new monitor, follow the steps in the [Monitor Details](/docs/alerts/monitors/create-monitor/#step-5-monitor-details) section to add tags in the `key=value` format.
107100

108-
- Tag keys cannot start with the prefixes `sumo.` or `_`
109-
- Tag keys must only contain letters, numbers, and/or the symbols `_`, `.`, `/`, `+`, `-`, `@`
110-
- Tag values can only contain letters, white spaces, numbers, and/or the symbols `_`, `.`, `/`, `=`, `+`, `-`, `@`
111-
- You can associate a maximum of 50 tags per monitor
112-
113-
### Using tags
114-
115-
:::note
116-
After you create a tag from a Monitor, it will appear on future alerts triggered by that monitor. Tags are not retroactively applied to past alerts.
117-
:::
101+
#### Adding tags to existing monitors
118102

119-
#### From the Monitors page
103+
You can also add tags to monitors that are already created.
120104

121-
To view tags from your Monitors page:
122-
123-
1. [**Classic UI**](/docs/get-started/sumo-logic-ui-classic). In the main Sumo Logic menu, select **Manage Data > Monitoring > Monitors**. <br/>[**New UI**](/docs/get-started/sumo-logic-ui). In the main Sumo Logic menu, select **Alerts > Monitors**. You can also click the **Go To...** menu at the top of the screen and select **Monitors**.
124-
1. You'll see a **Tags** column, and you can filter by tags at the top.<br/><img src={useBaseUrl('img/alerts/monitors-tags.png')} alt="Monitors page showing a column labeled 'Tags' next to alert details" style={{border: '1px solid gray'}} width="800" />
125-
126-
127-
#### From the Alert List page
128-
129-
To view tags from your Alert List:
130-
131-
1. [**Classic UI**](/docs/get-started/sumo-logic-ui-classic). Navigate to the **Alerts** section by clicking the notification bell icon at the top of your Sumo Logic dashboard.<br/> [**New UI**](/docs/get-started/sumo-logic-ui). In the main Sumo Logic menu, select **Alerts > Alert List**. You can also click the **Go To...** menu at the top of the screen and select **Alert List**.
132-
1. You'll see a **Tags** column, and you can filter by tags at the top.<br/><img src={useBaseUrl('img/alerts/alerts-list-tags.png')} alt="Alerts list page showing a column labeled 'Tags' next to alert details" style={{border: '1px solid gray'}} width="800" />
105+
1. [**Classic UI**](/docs/get-started/sumo-logic-ui-classic). In the main Sumo Logic menu, select **Manage Data > Monitoring > Monitors**. [**New UI**](/docs/get-started/sumo-logic-ui). Go to **Alerts > Monitors** from the main menu, or use the **Go To...** menu at the top of the screen to navigate to **Monitors**.
106+
1. Select a monitor from the list and double-click on it.
107+
1. In the side panel, click **Edit**.
108+
1. Under the **Monitor details** step, create a tag using the `key=value` format, following these syntax rules:
109+
- Tag keys cannot start with the prefixes `sumo.` or `_`
110+
- Tag keys can only contain letters, numbers, and/or the symbols `_`, `.`, `/`, `+`, `-`, `@`
111+
- Tag values can only contain letters, white spaces, numbers, and/or the symbols `_`, `.`, `/`, `=`, `+`, `-`, `@`
112+
- A maximum of 50 tags can be associated with each monitor.
113+
1. Click **Save**.
133114

134-
#### From Alert Response pages
115+
### Using tags in alerts
135116

136-
You can also see your tags on Alert Response pages:
117+
After you’ve created tags for a monitor, these tags will be applied to future alerts generated by the monitor. You can view and use tags in different places:
137118

138-
1. Click on any alert from your **Alerts List** page (like those shown in the previous screenshot).
139-
1. Go to the **Tags** section.<br/><img src={useBaseUrl('img/alerts/alert-response-tags.png')} alt="Alert Response page displaying graphs with tags shown in the tags section" style={{border: '1px solid gray'}} width="800" />
119+
* **Alert List**. [**Classic UI**](/docs/get-started/sumo-logic-ui-classic). Navigate to the **Alerts** section by clicking the notification bell icon at the top of your Sumo Logic dashboard. [**New UI**](/docs/get-started/sumo-logic-ui). Select **Alerts > Alert List** or click the **Go To...** menu at the top of the screen and select **Alert List**. You'll see a **Tags** column, and you can filter by tags at the top.<br/><img src={useBaseUrl('img/alerts/alerts-list-tags.png')} alt="Alerts list page showing a column labeled 'Tags' next to alert details" style={{border: '1px solid gray'}} width="800" />
120+
* **Alert Response**. Click on any alert in your **Alerts List** page to see more details, including tags in the **Tags** section.<br/><img src={useBaseUrl('img/alerts/alert-response-tags.png')} alt="Alert Response page displaying graphs with tags shown in the tags section" style={{border: '1px solid gray'}} width="800" />
140121

141122

142123
## Monitor folder permissions

0 commit comments

Comments
 (0)