Skip to content

Commit 214ed21

Browse files
Merge pull request #244549 from normesta/normesta-reg-updates-12
Fixing steps in alerting section of files article
2 parents 53a2972 + c1ed5a9 commit 214ed21

File tree

1 file changed

+53
-61
lines changed

1 file changed

+53
-61
lines changed

articles/storage/files/storage-files-monitoring.md

Lines changed: 53 additions & 61 deletions
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ author: normesta
55
services: storage
66
ms.service: azure-file-storage
77
ms.topic: conceptual
8-
ms.date: 10/06/2022
8+
ms.date: 07/11/2023
99
ms.author: normesta
1010
ms.devlang: csharp
1111
ms.custom: monitoring, devx-track-csharp, devx-track-azurepowershell
@@ -374,6 +374,11 @@ For more information on how to write queries, see [Log Analytics tutorial](../..
374374

375375
Azure Monitor alerts proactively notify you when important conditions are found in your monitoring data. They allow you to identify and address issues in your system before your customers notice them. You can set alerts on [metrics](../../azure-monitor/alerts/alerts-metric-overview.md), [logs](../../azure-monitor/alerts/alerts-unified-log.md), and the [activity log](../../azure-monitor/alerts/activity-log-alerts.md).
376376

377+
To learn more about how to create an alert, see [Create or edit an alert rule](../../azure-monitor/alerts/alerts-create-new-alert-rule.md).
378+
379+
> [!NOTE]
380+
> If you create an alert and it's too noisy, adjust the threshold value and alert logic.
381+
377382
The following table lists some example scenarios to monitor and the proper metric to use for the alert:
378383

379384
| Scenario | Metric to use for alert |
@@ -382,38 +387,15 @@ The following table lists some example scenarios to monitor and the proper metri
382387
| File share size is 80% of capacity. | Metric: File Capacity<br>Dimension name: FileShare (premium file share only) |
383388
| File share egress has exceeded 500 GiB in one day. | Metric: Egress<br>Dimension name: FileShare (premium file share only) |
384389

385-
### How to create alerts for Azure Files
386-
387-
1. Go to your **storage account** in the **Azure portal**.
388-
389-
2. Click **Alerts** and then click **+ New alert rule**.
390-
391-
3. Click **Edit resource**, select the **File resource type** and then click **Done**.
392-
393-
4. Click **Add condition** and provide the following information for the alert:
394-
395-
- **Metric**
396-
- **Dimension name**
397-
- **Alert logic**
398-
399-
5. Click **Add action groups** and add an action group (email, SMS, etc.) to the alert either by selecting an existing action group or creating a new action group.
400-
401-
6. Fill in the **Alert details** like **Alert rule name**, **Description**, and **Severity**.
390+
### How to create an alert if a file share is throttled
402391

403-
7. Click **Create alert rule** to create the alert.
392+
1. Open the **Create an alert rule** dialog box. For more information, see [Create or edit an alert rule](../../azure-monitor/alerts/alerts-create-new-alert-rule.md).
404393

405-
> [!NOTE]
406-
> If you create an alert and it's too noisy, adjust the threshold value and alert logic.
394+
2. In the **Condition** tab, select the **Transactions** metric.
407395

408-
### How to create an alert if a file share is throttled
396+
3. In the **Dimension name** drop-down list, select **Response type**.
409397

410-
1. Go to your **storage account** in the **Azure portal**.
411-
2. In the **Monitoring** section, click **Alerts**, and then click **+ New alert rule**.
412-
3. Click **Edit resource**, select the **File resource type** for the storage account and then click **Done**. For example, if the storage account name is `contoso`, select the `contoso/file` resource.
413-
4. Click **Add condition** to add a condition.
414-
5. You'll see a list of signals supported for the storage account, select the **Transactions** metric.
415-
6. On the **Configure signal logic** blade, click the **Dimension name** drop-down and select **Response type**.
416-
7. Click the **Dimension values** drop-down and select the appropriate response types for your file share.
398+
4. In the **Dimension values** drop-down list, select the appropriate response types for your file share.
417399

418400
For standard file shares, select the following response types:
419401

@@ -431,61 +413,71 @@ The following table lists some example scenarios to monitor and the proper metri
431413
- ClientShareIopsThrottlingError
432414

433415
> [!NOTE]
434-
> If the response types are not listed in the **Dimension values** drop-down, this means the resource has not been throttled. To add the dimension values, next to the **Dimension values** drop-down list, select **Add custom value**, enter the respone type (for example, **SuccessWithThrottling**), select **OK**, and then repeat these steps to add all applicable response types for your file share.
416+
> If the response types are not listed in the **Dimension values** drop-down, this means the resource has not been throttled. To add the dimension values, next to the **Dimension values** drop-down list, select **Add custom value**, enter the response type (for example, **SuccessWithThrottling**), select **OK**, and then repeat these steps to add all applicable response types for your file share.
435417
436-
8. For **premium file shares**, click the **Dimension name** drop-down and select **File Share**. For **standard file shares**, skip to **step #10**.
418+
5. For **premium file shares**, select the **Dimension name** drop-down and select **File Share**. For **standard file shares**, skip to step 7.
437419

438420
> [!NOTE]
439421
> If the file share is a standard file share, the **File Share** dimension will not list the file share(s) because per-share metrics are not available for standard file shares. Throttling alerts for standard file shares will be triggered if any file share within the storage account is throttled and the alert will not identify which file share was throttled. Since per-share metrics are not available for standard file shares, the recommendation is to have one file share per storage account.
440422
441-
9. Click the **Dimension values** drop-down and select the file share(s) that you want to alert on.
442-
10. Define the **alert parameters** (threshold value, operator, aggregation granularity and frequency of evaluation) and click **Done**.
423+
6. Select the **Dimension values** drop-down and select the file share(s) that you want to alert on.
424+
425+
7. Define the alert parameters (threshold value, operator, lookback period, and frequency of evaluation).
443426

444427
> [!TIP]
445428
> If you are using a static threshold, the metric chart can help determine a reasonable threshold value if the file share is currently being throttled. If you're using a dynamic threshold, the metric chart will display the calculated thresholds based on recent data.
446429
447-
11. Click **Add action groups** to add an **action group** (email, SMS, etc.) to the alert either by selecting an existing action group or creating a new action group.
448-
12. Fill in the **Alert details** like **Alert rule name**, **Description**, and **Severity**.
449-
13. Click **Create alert rule** to create the alert.
430+
8. Select the **Actions** tab to add an action group (email, SMS, etc.) to the alert. You can select an existing action group or create a new action group.
431+
432+
9. Select the **Details** tab to fill in the details of the alert such as the alert name, description, and severity.
433+
434+
10. Select **Review + create** to create the alert.
450435

451436
### How to create an alert if the Azure file share size is 80% of capacity
452437

453-
1. Go to your **storage account** in the **Azure portal**.
454-
2. In the **Monitoring** section, click **Alerts** and then click **+ New alert rule**.
455-
3. Click **Edit resource**, select the **File resource type** for the storage account and then click **Done**. For example, if the storage account name is `contoso`, select the `contoso/file` resource.
456-
4. Click **Add condition** to add a condition.
457-
5. You'll see a list of signals supported for the storage account, select the **File Capacity** metric.
458-
6. For **premium file shares**, click the **Dimension name** drop-down and select **File Share**. For **standard file shares**, skip to **step #8**.
438+
1. Open the **Create an alert rule** dialog box. For more information, see [Create or edit an alert rule](../../azure-monitor/alerts/alerts-create-new-alert-rule.md).
439+
440+
2. In the **Condition** tab of the **Create an alert rule** dialog box, select the **File Capacity** metric.
441+
442+
3. For **premium file shares**, select the **Dimension name** drop-down list, and then select **File Share**. For **standard file shares**, skip to step 5.
459443

460444
> [!NOTE]
461445
> If the file share is a standard file share, the **File Share** dimension will not list the file share(s) because per-share metrics are not available for standard file shares. Alerts for standard file shares are based on all file shares in the storage account. Since per-share metrics are not available for standard file shares, the recommendation is to have one file share per storage account.
462446
463-
7. Click the **Dimension values** drop-down and select the file share(s) that you want to alert on.
464-
8. Enter the **Threshold value** in bytes. For example, if the file share size is 100 TiB and you want to receive an alert when the file share size is 80% of capacity, the threshold value in bytes is 87960930222080.
465-
9. Define the rest of the **alert parameters** (aggregation granularity and frequency of evaluation) and click **Done**.
466-
10. Click **Add action groups** to add an **action group** (email, SMS, etc.) to the alert either by selecting an existing action group or creating a new action group.
467-
11. Fill in the **Alert details** like **Alert rule name**, **Description**, and **Severity**.
468-
12. Click **Create alert rule** to create the alert.
447+
4. Select the **Dimension values** drop-down and select the file share(s) that you want to alert on.
448+
449+
5. Enter the **Threshold value** in bytes. For example, if the file share size is 100 TiB and you want to receive an alert when the file share size is 80% of capacity, the threshold value in bytes is 87960930222080.
450+
451+
6. Define the alert parameters (threshold value, operator, lookback period, and frequency of evaluation).
452+
453+
7. Select the **Actions** tab to add an action group (email, SMS, etc.) to the alert. You can select an existing action group or create a new action group.
454+
455+
8. Select the **Details** tab to fill in the details of the alert such as the alert name, description, and severity.
456+
457+
9. Select **Review + create** to create the alert.
469458

470459
### How to create an alert if the Azure file share egress has exceeded 500 GiB in a day
471460

472-
1. Go to your **storage account** in the **Azure portal**.
473-
2. In the Monitoring section, click **Alerts** and then click **+ New alert rule**.
474-
3. Click **Edit resource**, select the **File resource type** for the storage account and then click **Done**. For example, if the storage account name is contoso, select the contoso/file resource.
475-
4. Click **Add condition** to add a condition.
476-
5. You'll see a list of signals supported for the storage account, select the **Egress** metric.
477-
6. For **premium file shares**, click the **Dimension name** drop-down and select **File Share**. For **standard file shares**, skip to **step #8**.
461+
1. Open the **Create an alert rule** dialog box. For more information, see [Create or edit an alert rule](../../azure-monitor/alerts/alerts-create-new-alert-rule.md).
462+
463+
2. In the **Condition** tab of the **Create an alert rule** dialog box, select the **Egress** metric.
464+
465+
3. For **premium file shares**, select the **Dimension name** drop-down list and select **File Share**. For **standard file shares**, skip to step 5.
478466

479467
> [!NOTE]
480468
> If the file share is a standard file share, the **File Share** dimension will not list the file share(s) because per-share metrics are not available for standard file shares. Alerts for standard file shares are based on all file shares in the storage account. Since per-share metrics are not available for standard file shares, the recommendation is to have one file share per storage account.
481469
482-
7. Click the **Dimension values** drop-down and select the file share(s) that you want to alert on.
483-
8. Enter **536870912000** bytes for Threshold value.
484-
9. Click the **Aggregation granularity** drop-down and select **24 hours**.
485-
10. Select the **Frequency of evaluation** and **click Done**.
486-
11. Click **Add action groups** to add an **action group** (email, SMS, etc.) to the alert either by selecting an existing action group or creating a new action group.
487-
12. Fill in the **Alert details** like **Alert rule name**, **Description**, and **Severity**.
488-
13. Click **Create alert rule** to create the alert.
470+
4. Select the **Dimension values** drop-down and select the file share(s) that you want to alert on.
471+
472+
5. Enter **536870912000** bytes for Threshold value.
473+
474+
6. From the **Check every** drop-down list, select the frequency of evaluation.
475+
476+
7. Select the **Actions** tab to add an action group (email, SMS, etc.) to the alert. You can select an existing action group or create a new action group.
477+
478+
8. Select the **Details** tab to fill in the details of the alert such as the alert name, description, and severity.
479+
480+
9. Select **Review + create** to create the alert.
489481

490482
## Next steps
491483

0 commit comments

Comments
 (0)