Skip to content

Commit e911343

Browse files
Merge pull request #232369 from AbhishekMallick01/Mar-28-2023-ReportAlert
Backup report and alert - GA
2 parents c221ae7 + 682754f commit e911343

7 files changed

+633
-457
lines changed

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

Lines changed: 32 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
title: Use diagnostics settings for Recovery Services vaults
33
description: 'This article describes how to use the old and new diagnostics events for Azure Backup.'
44
ms.topic: conceptual
5-
ms.date: 10/30/2019
5+
ms.date: 03/31/2023
66
author: jyothisuri
77
ms.author: jsuri
88
---
@@ -20,7 +20,6 @@ You can configure diagnostics settings for a Recovery Services vault via the Azu
2020
Azure Backup provides the following diagnostics events. Each event provides detailed data on a specific set of backup-related artifacts:
2121

2222
* CoreAzureBackup
23-
* AddonAzureBackupAlerts
2423
* AddonAzureBackupProtectedInstance
2524
* AddonAzureBackupJobs
2625
* AddonAzureBackupPolicy
@@ -38,31 +37,54 @@ You can now use Azure Backup to send vault diagnostics data to dedicated Log Ana
3837

3938
To send your vault diagnostics data to Log Analytics:
4039

41-
1. Go to your vault, and select **Diagnostic Settings**. Select **+ Add Diagnostic Setting**.
42-
1. Give a name to the diagnostics setting.
43-
1. Select the **Send to Log Analytics** check box, and select a Log Analytics workspace.
44-
1. Select **Resource specific** in the toggle, and select the following six events: **CoreAzureBackup**, **AddonAzureBackupJobs**, **AddonAzureBackupAlerts**, **AddonAzureBackupPolicy**, **AddonAzureBackupStorage**, and **AddonAzureBackupProtectedInstance**.
40+
**Choose a vault type**:
41+
42+
# [Recovery Services vaults](#tab/recovery-services-vaults)
43+
44+
1. Go to your *vault*, and then select **Diagnostic Settings** > **+ Add Diagnostic Setting**.
45+
1. Provide a name to the *diagnostics setting*.
46+
1. Select the **Send to Log Analytics** checkbox, and then select a *Log Analytics workspace*.
47+
1. Select **Resource specific** in the toggle, and select the following five events: **CoreAzureBackup**, **AddonAzureBackupJobs**, **AddonAzureBackupPolicy**, **AddonAzureBackupStorage**, and **AddonAzureBackupProtectedInstance**.
4548
1. Select **Save**.
4649

47-
![Resource-specific mode](./media/backup-azure-diagnostics-events/resource-specific-blade.png)
50+
51+
52+
# [Backup vaults](#tab/backup-vaults)
53+
54+
1. Go to your *vault*, and then select **Diagnostic Settings** > **+ Add Diagnostic Setting**.
55+
2. Provide a name to the *diagnostics setting*.
56+
3. Select the **Send to Log Analytics** checkbox, and then select a *Log Analytics workspace*.
57+
4. Select the following events: **CoreAzureBackup**, **AddonAzureBackupJobs**, **AddonAzureBackupPolicy**, and **AddonAzureBackupProtectedInstance**.
58+
5. Select **Save**.
59+
60+
61+
62+
---
4863

4964
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.
5065

5166
> [!IMPORTANT]
52-
> The six events, namely, CoreAzureBackup, AddonAzureBackupJobs, AddonAzureBackupAlerts, AddonAzureBackupPolicy, AddonAzureBackupStorage, and AddonAzureBackupProtectedInstance, are supported *only* in the resource-specific mode in [Backup reports](./configure-reports.md). *If you try to send data for these six events in Azure diagnostics mode, no data will be visible in Backup reports.*
67+
> 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.*
68+
>
69+
> *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.
70+
>
71+
> 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.
5372
5473
## Legacy event
5574

56-
Traditionally, 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.
75+
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.
5776

58-
Currently, we continue to support the AzureBackupReport event for backward compatibility in cases where users have existing custom queries on this event. Examples are 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:
77+
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:
5978

6079
* Make the data much easier to work with in log queries.
6180
* Provide better discoverability of schemas and their structure.
6281
* Improve performance across both ingestion latency and query times.
6382

6483
*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.
6584

85+
> [!NOTE]
86+
> 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.
87+
6688
### Steps to move to new diagnostics settings for a Log Analytics workspace
6789

6890
1. Identify which vaults are sending data to the Log Analytics workspaces by using the legacy event and the subscriptions they belong to. Run the following query in each of your workspaces to identify these vaults and subscriptions.

articles/backup/backup-azure-monitoring-use-azuremonitor.md

Lines changed: 39 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
title: Monitor Azure Backup with Azure Monitor
33
description: Monitor Azure Backup workloads and create custom alerts by using Azure Monitor.
44
ms.topic: conceptual
5-
ms.date: 06/04/2019
5+
ms.date: 04/18/2023
66
ms.assetid: 01169af5-7eb0-4cb0-bbdb-c58ac71bf48b
77
author: jyothisuri
88
ms.author: jsuri
@@ -57,7 +57,11 @@ For more information, see [Create, view, and manage log alerts by using Azure Mo
5757

5858
### Sample Kusto queries
5959

60-
The default graphs give you Kusto queries for basic scenarios on which you can build alerts. You can also modify the queries to get the data you want to be alerted on. Paste the following sample Kusto queries in the **Logs** page and then create alerts on the queries:
60+
The default graphs give you Kusto queries for basic scenarios on which you can build alerts. You can also modify the queries to fetch the data you want to be alerted on. Paste the following sample Kusto queries on the **Logs** page, and then create alerts on the queries.
61+
62+
Recovery Services vaults and Backup vaults send data to a common set of tables that are listed in this article. However, there are slight differences in the schema for Recovery Services vaults and Backup vaults ([learn more](backup-azure-monitoring-built-in-monitor.md)). So, this section is split into multiple sub-sections that helps you to use the right queries depending on which workload or vault types you want to query.
63+
64+
#### Queries common across Recovery Services vaults and Backup vaults
6165

6266
- All successful backup jobs
6367

@@ -77,6 +81,8 @@ The default graphs give you Kusto queries for basic scenarios on which you can b
7781
| where JobStatus=="Failed"
7882
````
7983
84+
#### Queries specific to Recovery Services vault workloads
85+
8086
- All successful Azure VM backup jobs
8187
8288
````Kusto
@@ -147,6 +153,37 @@ The default graphs give you Kusto queries for basic scenarios on which you can b
147153
| sort by StorageConsumedInMBs desc
148154
````
149155
156+
#### Queries specific to Backup vault workloads
157+
158+
- All successful Azure PostgreSQL backup jobs
159+
160+
````Kusto
161+
AddonAzureBackupJobs
162+
| where JobOperation=="Backup"
163+
| summarize arg_max(TimeGenerated,*) by JobUniqueId
164+
| where DatasourceType == "Microsoft.DBforPostgreSQL/servers/databases"
165+
| where JobStatus=="Completed"
166+
````
167+
168+
- All successful Azure Disk restore jobs
169+
170+
````Kusto
171+
AddonAzureBackupJobs
172+
| where JobOperation == "Restore"
173+
| summarize arg_max(TimeGenerated,*) by JobUniqueId
174+
| where DatasourceType == "Microsoft.Compute/disks"
175+
| where JobStatus=="Completed"
176+
````
177+
178+
- Backup Storage Consumed per Backup Item
179+
180+
````Kusto
181+
CoreAzureBackup
182+
| where OperationName == "BackupItem"
183+
| summarize arg_max(TimeGenerated, *) by BackupItemUniqueId
184+
| project BackupItemUniqueId, BackupItemFriendlyName, StorageConsumedInMBs
185+
````
186+
150187
### Diagnostic data update frequency
151188
152189
The diagnostic data from the vault is pumped to the Log Analytics workspace with some lag. Every event arrives at the Log Analytics workspace *20 to 30 minutes* after it's pushed from the Recovery Services vault. Here are further details about the lag:

0 commit comments

Comments
 (0)