Skip to content

Commit f5a8748

Browse files
Merge pull request #238794 from nolavime/patch-107
Update alerts-create-new-alert-rule.md
2 parents 6b587a5 + 9dc1ac1 commit f5a8748

File tree

1 file changed

+15
-4
lines changed

1 file changed

+15
-4
lines changed

articles/azure-monitor/alerts/alerts-create-new-alert-rule.md

Lines changed: 15 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -239,23 +239,32 @@ Alerts triggered by these alert rules contain a payload that uses the [common al
239239
240240
1. On the **Actions** tab, select or create the required [action groups](./action-groups.md).
241241
242-
1. (Optional) If you've configured action groups for this alert rule, you can add custom properties in key:value pairs to add more information to the alert notification payload in the <a name="custom-props">**Custom properties**</a> section. Add the property **Name** and **Value** for the custom property you want included in the payload.
242+
243+
> [!NOTE]
244+
> We're continually adding more regions for regional data processing.
245+
246+
1. (Optional) In the **Custom properties** section, if you've configured action groups for this alert rule, you can add custom properties in key:value pairs to the alert notification payload to add more information to it. Add the property **Name** and **Value** for the custom property you want included in the payload.
243247
244248
You can also use custom properties to extract and manipulate data from alert payloads that use the common schema. You can use those values in the action group webhook or logic app.
245249
246-
The format for extracting values from the [common schema](alerts-common-schema.md), use a "$", and then the path of the common schema field inside curly brackets. For example: `${data.essentials.monitorCondition}`.
250+
The format for extracting values from the common schema, use a "$", and then the path of the [common schema](https://learn.microsoft.com/azure/azure-monitor/alerts/alerts-common-schema) field inside curly brackets. For example: `${data.essentials.monitorCondition}`.
251+
252+
247253
248254
In the following examples, values in the **custom properties** are used to utilize data from the payload:
249255
250256
**Example 1**
251-
This example creates an "Additional Details" tag with data about the "evaluation window start time" and "evaluation window end time".
257+
258+
This example creates an "Additional Details" tag with data refarding the "window start time" and "window end time".
259+
252260
- **Name:** "Additional Details"
253261
- **Value:** "Evaluation windowStartTime: \${data.alertContext.condition.windowStartTime}. windowEndTime: \${data.alertContext.condition.windowEndTime}"
254262
- **Result:** "AdditionalDetails:Evaluation windowStartTime: 2023-04-04T14:39:24.492Z. windowEndTime: 2023-04-04T14:44:24.492Z"
255263
256264
257265
**Example 2**
258-
This example adds data about the reason the alert was fired or resolved.
266+
This example add the data regarding the reason of resolving or firing the alert.
267+
259268
- **Name:** "Alert \${data.essentials.monitorCondition} reason"
260269
- **Value:** "\${data.alertContext.condition.allOf[0].metricName} \${data.alertContext.condition.allOf[0].operator} \${data.alertContext.condition.allOf[0].threshold} \${data.essentials.monitorCondition}. The value is \${data.alertContext.condition.allOf[0].metricValue}"
261270
- **Result:** Example results could be something like:
@@ -264,9 +273,11 @@ Alerts triggered by these alert rules contain a payload that uses the [common al
264273
265274
:::image type="content" source="media/alerts-create-new-alert-rule/alerts-rule-actions-tab.png" alt-text="Screenshot that shows the Actions tab when creating a new alert rule.":::
266275
276+
267277
> [!NOTE]
268278
> The [common schema](alerts-common-schema.md) overwrites custom configurations. Therefore, you can't use both custom properties and the common schema for log alerts.
269279
280+
270281
1. On the **Details** tab, define the **Project details**.
271282
- Select the **Subscription**.
272283
- Select the **Resource group**.

0 commit comments

Comments
 (0)