Skip to content

Commit e5234d0

Browse files
Merge pull request #272270 from ankitaduttaMSFT/reporting
monitor alerts
2 parents f21f4e3 + e4ce2f2 commit e5234d0

31 files changed

+176
-93
lines changed

articles/backup/backup-azure-diagnostic-events.md

Lines changed: 33 additions & 29 deletions
Original file line numberDiff line numberDiff line change
@@ -23,13 +23,15 @@ You can configure diagnostics settings for a Recovery Services vault via the Azu
2323

2424
Azure Backup provides the following diagnostics events. Each event provides detailed data on a specific set of backup-related artifacts:
2525

26-
* CoreAzureBackup
27-
* AddonAzureBackupProtectedInstance
28-
* AddonAzureBackupJobs
29-
* AddonAzureBackupPolicy
30-
* AddonAzureBackupStorage
26+
- Core Azure Backup Data
27+
- Addon Azure Backup Job Data
28+
- Addon Azure Backup Policy Data
29+
- Addon Azure Backup Storage Data
30+
- Addon Azure Backup Protected Instance Data
31+
- Azure Backup Operations
3132

32-
If you are still using the [legacy event](#legacy-event) AzureBackupReport, we recommend switching to using the events above.
33+
34+
If you are still using the [legacy event](#legacy-event) Azure Backup Reporting Data, we recommend switching to using the events above.
3335

3436
For more information, see [Data model for Azure Backup diagnostics events](./backup-azure-reports-data-model.md).
3537

@@ -45,48 +47,48 @@ To send your vault diagnostics data to Log Analytics:
4547

4648
# [Recovery Services vaults](#tab/recovery-services-vaults)
4749

48-
1. Go to your *vault*, and then select **Diagnostic Settings** > **+ Add Diagnostic Setting**.
49-
1. Provide a name to the *diagnostics setting*.
50-
1. Select the **Send to Log Analytics** checkbox, and then select a *Log Analytics workspace*.
51-
1. Select **Resource specific** in the toggle, and select the following five events: **CoreAzureBackup**, **AddonAzureBackupJobs**, **AddonAzureBackupPolicy**, **AddonAzureBackupStorage**, and **AddonAzureBackupProtectedInstance**.
50+
1. Go to your *vault*, and select **Diagnostic Settings** > **+ Add diagnostic setting**.
51+
1. Provide a name to the *Diagnostics setting name*.
52+
1. Select the **Send to Log Analytics** checkbox, and select a *Log Analytics workspace*.
53+
1. Select **Resource specific** and select the following six events: **Core Azure Backup Data**, **Addon Azure Backup Job Data**, **Addon Azure Backup Policy Data**, and **Addon Azure Backup Protected Instance Data**, **Azure Backup Operations.**
5254
1. Select **Save**.
5355

5456
:::image type="content" source="./media/backup-azure-configure-backup-reports/recovery-services-vault-diagnostics-settings-inline.png" alt-text="Screenshot shows the recovery services vault diagnostics settings." lightbox="./media/backup-azure-configure-backup-reports/recovery-services-vault-diagnostics-settings-expanded.png":::
5557

5658
# [Backup vaults](#tab/backup-vaults)
5759

58-
1. Go to your *vault*, and then select **Diagnostic Settings** > **+ Add Diagnostic Setting**.
59-
2. Provide a name to the *diagnostics setting*.
60-
3. Select the **Send to Log Analytics** checkbox, and then select a *Log Analytics workspace*.
61-
4. Select the following events: **CoreAzureBackup**, **AddonAzureBackupJobs**, **AddonAzureBackupPolicy**, and **AddonAzureBackupProtectedInstance**.
60+
1. Go to your *vault*, and then select **Diagnostic Settings** > **+ Add diagnostic setting**.
61+
2. Provide a name to the *Diagnostics setting name*.
62+
3. Select the **Send to Log Analytics** checkbox and select a *Log Analytics workspace*.
63+
4. Select the following events: **Core Azure Backup Data**, **Addon Azure Backup Job Data**, **Addon Azure Backup Policy Data**, and **Addon Azure Backup Protected Instance Data**.
6264
5. Select **Save**.
6365

64-
:::image type="content" source="./media/backup-azure-configure-backup-reports/backup-vault-diagnostics-settings.png" alt-text="Screenshot shows the backup vault diagnostics settings.":::
66+
:::image type="content" source="./media/backup-azure-diagnostics-events/backup-vault-diagnostics-settings.png" alt-text="Screenshot shows the backup vault diagnostics settings.":::
6567
---
6668

6769
After data flows into the Log Analytics workspace, dedicated tables for each of these events are created in your workspace. You can query any of these tables directly. You can also perform joins or unions between these tables if necessary.
6870

6971
> [!IMPORTANT]
70-
> The six events, namely, *CoreAzureBackup*, *AddonAzureBackupJobs*, *AddonAzureBackupAlerts*, *AddonAzureBackupPolicy*, *AddonAzureBackupStorage*, and *AddonAzureBackupProtectedInstance*, are supported *only* in the resource-specific mode for Recovery Services vaults in [Backup reports](configure-reports.md). *If you try to send data for these six events in Azure diagnostics mode, no data will appear in Backup reports.*
72+
> *Addon Azure Backup Alerts* refers to the alerts being generated by the classic alerts solution. As classic alerts solution is on deprecation path in favour of Azure Monitor-based alers, we recommend you not to select the event *Addon Azure Backup Alerts* when configuring diagnostics settings. To send the fired Azure Monitor-based alerts to a destination of your choice, you can create an alert processing rule and action group that routes these alerts to a logic app, webhook, or runbook that in turn sends these alerts to the required destination.
7173
>
72-
> *AddonAzureBackupAlerts* refers to the alerts being generated by the classic alerts solution. As classic alerts solution is on deprecation path in favour of Azure Monitor-based alers, we recommend you not to select the event *AddonAzureBackupAlerts* when configuring diagnostics settings. To send the fired Azure Monitor-based alerts to a destination of your choice, you can create an alert processing rule and action group that routes these alerts to a logic app, webhook, or runbook that in turn sends these alerts to the required destination.
74+
> For Recovery Services vault, the six events- *Core Azure Backup*, *Addon Azure Backup Jobs*, *Addon Azure Backup Policy*, *Addon Azure Backup Storage*, *Azure Backup Operations*, and *Addon Azure Backup Protected Instance* are supported *only* in the *resource-specific* mode for Recovery Services in Backup reports. If you try to send data for these events in the Azure diagnostics mode, no data will appear in Backup reports.
7375
>
74-
> For Backup vaults, since information on the frontend size and backup storage consumed are already included in the *CoreAzureBackup* and *AddonAzureBackupProtectedInstances* events (to aid query performance), the *AddonAzureBackupStorage event* isn't applicable for Backup vault, to avoid creation of redundant tables.
76+
> For Backup vaults, since information on the frontend size and backup storage consumed are already included in the *Core Azure Backup* and *Addon Azure Backup Protected Instances* events (to aid query performance), the *Addon Azure Backup Storage event* isn't applicable for Backup vault, to avoid creation of redundant tables.
7577
7678
## Legacy event
7779

78-
Traditionally, for Recovery Services vaults, all backup-related diagnostics data for a vault was contained in a single event called AzureBackupReport. The six events described here are, in essence, a decomposition of all the data contained in AzureBackupReport.
80+
Traditionally, for Recovery Services vaults, all backup-related diagnostics data for a vault was contained in a single event called Azure Backup Reporting Data. The six events described here are, in essence, a decomposition of all the data contained in Azure Backup Reporting Data.
7981

80-
Currently, we continue to support the *AzureBackupReport* event for Recovery Services vaults, backward compatibility in cases where you've existing custom queries on this event. For example, custom log alerts and custom visualizations. *We recommend that you move to the [new events](#diagnostics-events-available-for-azure-backup-users) as early as possible*. The new events:
82+
Currently, we continue to support the *Azure Backup Reporting Data* event for Recovery Services vaults, backward compatibility in cases where you've existing custom queries on this event. For example, custom log alerts and custom visualizations. *We recommend that you move to the [new events](#diagnostics-events-available-for-azure-backup-users) as early as possible*. The new events:
8183

8284
* Make the data much easier to work with in log queries.
8385
* Provide better discoverability of schemas and their structure.
8486
* Improve performance across both ingestion latency and query times.
8587

86-
*The legacy event in Azure diagnostics mode will eventually be deprecated. Choosing the new events might help you to avoid complex migrations at a later date*. Our [reporting solution](./configure-reports.md) that uses Log Analytics will also stop supporting data from the legacy event.
88+
*The legacy event in Azure diagnostics mode will eventually be deprecated. Choosing the new events can help you avoid complex migrations later*. Our Log Analytics-based [reporting solution](./configure-reports.md) will also cease support for data from the legacy event.
8789

8890
> [!NOTE]
89-
> For Backup vaults, all diagnostics events are sent to the resource-specific tables only; so, you don't need to do any migration for Backup vaults. The following section is specific to Recovery services vaults.
91+
> For Backup vaults, all diagnostics events are sent to the resource-specific tables only; so, you don't need to do any migration for Backup vaults. The preceeding section is specific to Recovery services vaults.
9092
9193
### Steps to move to new diagnostics settings for a Log Analytics workspace
9294

@@ -118,25 +120,27 @@ Currently, we continue to support the *AzureBackupReport* event for Recovery Ser
118120
| project ResourceId, SubscriptionId, VaultName
119121
````
120122
121-
Below is a screenshot of the query being run in one of the workspaces:
123+
The following screenshot shows the query being run in one of the workspaces:
122124
123125
![Workspace query](./media/backup-azure-diagnostics-events/workspace-query.png)
124126
125-
2. Use the [built-in Azure Policy definitions](./azure-policy-configure-diagnostics.md) in Azure Backup to add a new diagnostics setting for all vaults in a specified scope. This policy adds a new diagnostics setting to vaults that either don't have a diagnostics setting or have only a legacy diagnostics setting. This policy can be assigned to an entire subscription or resource group at a time. You must have Owner access to each subscription for which the policy is assigned.
127+
2. Use the [built-in Azure Policy definitions](./azure-policy-configure-diagnostics.md) in Azure Backup to add a new diagnostics setting for all vaults in a specified scope. This policy adds a new diagnostics setting to vaults that either don't have a diagnostics setting or have only a legacy diagnostics setting. This policy can be assigned to an entire subscription or resource group at a time. You must have Owner access to each subscription for which the policy is assigned.
126128
127-
You might choose to have separate diagnostics settings for AzureBackupReport and the six new events until you've migrated all of your custom queries to use data from the new tables. The following image shows an example of a vault that has two diagnostic settings. The first setting, named **Setting1**, sends data of an AzureBackupReport event to a Log Analytics workspace in Azure diagnostics mode. The second setting, named **Setting2**, sends data of the six new Azure Backup events to a Log Analytics workspace in the resource-specific mode.
129+
You might choose to have separate diagnostics settings for *Azure Backup Report* and the six new events until you've migrated all of your custom queries to use data from the new tables. The following image shows an example of a vault that has two diagnostic settings. The first setting, named **Setting1**, sends data of an *Azure Backup Report* event to a Log Analytics workspace in Azure diagnostics mode. The second setting, named **Setting2**, sends data of the six new Azure Backup events to a Log Analytics workspace in the resource-specific mode.
128130
129131
![Two settings](./media/backup-azure-diagnostics-events/two-settings-example.png)
130132
131133
> [!IMPORTANT]
132-
> The AzureBackupReport event is supported *only* in Azure diagnostics mode. *If you try to send data for this event in the resource-specific mode, no data will flow to the Log Analytics workspace.*
134+
> The Azure Backup Report event is supported *only* in Azure diagnostics mode. *If you try to send data for this event in the resource-specific mode, no data will flow to the Log Analytics workspace.*
133135
134136
> [!NOTE]
135-
> The toggle for **Azure diagnostics** or **Resource specific** appears only if the user selects **Send to Log Analytics**. To send data to a storage account or an event hub, a user selects the required destination and selects the check boxes for any of the desired events, without any additional inputs. Again, we recommend that you don't choose the legacy event AzureBackupReport going forward.
137+
> The toggle for **Azure diagnostics** or **Resource specific** appears only if the user selects **Send to Log Analytics**. To send data to a storage account or an event hub, a user selects the required destination and selects the check boxes for any of the desired events, without any additional inputs. Again, we recommend that you don't choose the legacy event Azure Backup Reporting Data going forward.
138+
139+
136140
137141
## Send Azure Site Recovery events to Log Analytics
138142
139-
Azure Backup and Azure Site Recovery events are sent from the same Recovery Services vault. Azure Site Recovery is currently not available for resource-specific tables. Users who want to send Azure Site Recovery events to Log Analytics are directed to use Azure diagnostics mode *only*, as shown in the image. *Choosing the resource-specific mode for Azure Site Recovery events will prevent the required data from being sent to the Log Analytics workspace*.
143+
Azure Backup and Azure Site Recovery events are sent from the same Recovery Services vault. Azure Site Recovery offers two resource-specific tables - *Azure Site Recovery Jobs* and *Azure Site Recovery Replicated Items Details*. Users must choose resource specific for the two tables mentioned. Choosing the resource-specific mode for Azure Site Recovery events for any other table for site recovery prevents the required data from being sent to the Log Analytics workspace. Azure Site Recovery Jobs is available as both resource specific and legacy table.
140144
141145
![Site Recovery events](./media/backup-azure-diagnostics-events/site-recovery-settings.png)
142146
@@ -146,7 +150,7 @@ To summarize:
146150
* If you also want to onboard onto new tables, as we recommend, create a **new** diagnostics setting, select **Resource specific**, and select the six new events.
147151
* If you're currently sending Azure Site Recovery events to Log Analytics, *do not* choose the resource-specific mode for these events. Otherwise, data for these events won't flow into your Log Analytics workspace. Instead, create an additional diagnostic setting, select **Azure diagnostics**, and select the relevant Azure Site Recovery events.
148152
149-
The following image shows an example of a user who has three diagnostics settings for a vault. The first setting, named **Setting1**, sends data from an AzureBackupReport event to a Log Analytics workspace in Azure diagnostics mode. The second setting, named **Setting2**, sends data from the six new Azure Backup events to a Log Analytics workspace in the resource-specific mode. The third setting, named **Setting3**, sends data from the Azure Site Recovery events to a Log Analytics workspace in Azure diagnostics mode.
153+
The following image shows an example of a user who has three diagnostics settings for a vault. The first setting, named **Setting1**, sends data from an Azure Backup Reporting Data event to a Log Analytics workspace in Azure diagnostics mode. The second setting, named **Setting2**, sends data from the six new Azure Backup events to a Log Analytics workspace in the resource-specific mode. The third setting, named **Setting3**, sends data from the Azure Site Recovery events to a Log Analytics workspace in Azure diagnostics mode.
150154
151155
![Three settings](./media/backup-azure-diagnostics-events/three-settings-example.png)
152156

0 commit comments

Comments
 (0)