Skip to content

Commit 0a22c2c

Browse files
Update Azure Entra ID logs config docs (DataDog#23217)
* update azure entra log forwarding * ran fix-links * resolving Codex suggestion * Update formatting and phrasing --------- Co-authored-by: Bryce Eadie <bryce.eadie@datadoghq.com>
1 parent b44be71 commit 0a22c2c

1 file changed

Lines changed: 46 additions & 13 deletions

File tree

azure_active_directory/README.md

Lines changed: 46 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -9,11 +9,39 @@ This integration allows you to forward your [Microsoft Entra ID][1] audit and si
99

1010
### Installation
1111

12-
This integration forwards logs to Datadog using Azure with Event Hubs. Configure Entra ID to forward activity logs to the event hub.
12+
This integration forwards logs to Datadog using either [Azure Automated Log Forwarding][2] (recommended) or [Azure with Event Hubs][3]. Datadog recommends using the automated solution because it requires less configuration and maintenance.
1313

1414
### Configuration
1515

16-
1. Set up the log forwarding pipeline from Azure to Datadog using Event Hubs by following the [Send Azure Logs to Datadog][2] guide.
16+
<!-- xxx tabs xxx -->
17+
<!-- xxx tab "Automated Log Forwarding" xxx -->
18+
19+
1. Set up the log forwarding pipeline from Azure to Datadog by following the [Azure Automated Log Forwarding Setup][2] guide.
20+
21+
2. In Azure portal, select _Microsoft Entra ID > Monitoring > Audit logs_.
22+
23+
3. Select **Export Data Settings**.
24+
25+
4. In the Diagnostics settings pane, do one of the following:
26+
27+
- To change existing settings, select **Edit setting**.
28+
- To add new settings, select **Add diagnostics setting**. You can have up to three settings.
29+
30+
5. Select the **Archive to a storage account** check box.
31+
32+
6. Select any storage account that begins with `ddlogstorage`. These are all managed by the automated log forwarding infrastructure deployed by the ARM template, and any of them will forward logs successfully.
33+
34+
7. Do one or both of the following. Datadog recommends selecting both.
35+
36+
- To send audit logs, select the **AuditLogs** check box.
37+
- To send sign-in logs, select the **SignInLogs** check box.
38+
39+
8. Select **Save**.
40+
<!-- xxz tab xxx -->
41+
42+
<!-- xxx tab "Azure with Event Hubs" xxx -->
43+
44+
1. Set up the log forwarding pipeline from Azure to Datadog using Event Hubs by following the [Send Azure Logs to Datadog from an Event Hub][3] guide.
1745

1846
2. In Azure portal, select _Microsoft Entra ID > Monitoring > Audit logs_.
1947

@@ -35,8 +63,12 @@ This integration forwards logs to Datadog using Azure with Event Hubs. Configure
3563

3664
8. Select **Save**.
3765

66+
For more details on the setup, see Microsoft's [Azure tutorial][4] on streaming Entra ID logs to an Event Hub.
67+
68+
<!-- xxz tab xxx -->
69+
<!-- xxz tabs xxx -->
70+
3871
Logs should start coming into Datadog within 15 minutes.
39-
For more details on the setup, see the [Azure tutorial][3].
4072

4173
## Data Collected
4274

@@ -56,27 +88,28 @@ Microsoft Entra ID does not include any metrics.
5688

5789
### Events
5890

59-
Datadog sends credential expiry events, which grant visibility into credential expirations for Azure app registrations, Key Vault keys, Key Vault secrets, and Key Vault certificates. The Microsoft Entra ID integration must be installed to receive events for Azure app registrations. Receiving events from Azure also requires installation of the [Azure integration][7].
91+
Datadog sends credential expiry events, which grant visibility into credential expirations for Azure app registrations, Key Vault keys, Key Vault secrets, and Key Vault certificates. The Microsoft Entra ID integration must be installed to receive events for Azure app registrations. Receiving events from Azure also requires installation of the [Azure integration][5].
6092

6193

6294
- **Expiration events** are sent 60, 30, 15, and 1 day(s) before credential expiration, and once after expiration.
6395
- **Missing permission events** are sent every 15 days. A missing permission event lists the Key Vaults for which Datadog has not been given permissions. If no changes have been made regarding Key Vault permissions in the previous 15-day cycle, the event notification is not sent again.
6496

65-
You can view these events in [Event Explorer][5].
97+
You can view these events in [Event Explorer][6].
6698

6799
**Notes**:
68100

69-
- To collect Azure app registration expiration events, [enable access to the Microsoft Graph API][6].
101+
- To collect Azure app registration expiration events, [enable access to the Microsoft Graph API][7].
70102
- If a certificate and its associated key and secret expire at the exact same time, one expiration event is sent for all resources.
71103

72104
## Troubleshooting
73105

74-
Need help? Contact [Datadog support][4].
106+
Need help? Contact [Datadog support][8].
75107

76108
[1]: https://learn.microsoft.com/entra/identity/monitoring-health/overview-monitoring-health
77-
[2]: https://docs.datadoghq.com/logs/guide/azure-logging-guide/
78-
[3]: https://learn.microsoft.com/entra/identity/monitoring-health/howto-stream-logs-to-event-hub
79-
[4]: https://docs.datadoghq.com/help
80-
[5]: /event/explorer
81-
[6]: https://docs.datadoghq.com/integrations/guide/azure-graph-api-permissions/
82-
[7]: https://docs.datadoghq.com/integrations/azure/
109+
[2]: https://docs.datadoghq.com/logs/guide/azure-automated-log-forwarding/
110+
[3]: https://docs.datadoghq.com/logs/guide/azure-event-hub-log-forwarding/
111+
[4]: https://learn.microsoft.com/entra/identity/monitoring-health/howto-stream-logs-to-event-hub
112+
[5]: https://docs.datadoghq.com/integrations/azure/
113+
[6]: /event/explorer
114+
[7]: https://docs.datadoghq.com/integrations/guide/azure-graph-api-permissions/
115+
[8]: https://docs.datadoghq.com/help

0 commit comments

Comments
 (0)