Skip to content

Commit abe0489

Browse files
authored
Merge branch 'main' into aironefr-queue-events
2 parents fb85872 + b199709 commit abe0489

22 files changed

Lines changed: 1385 additions & 124 deletions

support/azure/azure-kubernetes/storage/file-share-mount-failures-azure-files.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -23,10 +23,10 @@ Error: failed to generate container "56907e9807c6f4203c3aace8c5a6e3a75832cf07d30
2323

2424
Manually update the `azurestorageaccountkey` field in an Azure file secret to add your base64-encoded storage account key. To make this update, follow these steps:
2525

26-
1. Encode your storage account key in base64 by running the `echo <storage-account-key> | base64` command, such as in the following example:
26+
1. Encode your storage account key in base64 by running the following command:
2727

2828
```console
29-
echo X+ALAAUgMhWHL7QmQ87E1kSfIqLKfgC03Guy7/xk9MyIg2w4Jzqeu60CVw2r/dm6v6E0DWHTnJUEJGVQAoPaBc== | base64
29+
echo <storage-account-key> | base64
3030
```
3131

3232
1. [Update your Azure secret file](https://kubernetes.io/docs/concepts/configuration/secret/#editing-a-secret) by running the `kubectl edit secret` command to open the secret file in your default text editor:
Lines changed: 86 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,86 @@
1+
---
2+
title: Diagnostic Settings Transition from Legacy Solutions
3+
description: Provides step-by-step guidance on diagnostic settings transition from legacy solutions.
4+
ms.date: 07/09/2025
5+
ms.reviewer: v-liuamson
6+
ms.service: azure-monitor
7+
ms.custom: I can’t configure export of Activity Logs
8+
---
9+
# Diagnostic Settings Transition from Legacy Solutions
10+
11+
## Resolve Transition Issues from Legacy Azure Activity Log Solutions
12+
13+
This article addresses the transition from legacy solutions for forwarding Azure activity logs to new diagnostic settings. The legacy solution will be retired on September 30, 2026, and this change will occur automatically without disrupting your workflow. However, if you have automation using the legacy API, you will need to update it.
14+
15+
### Step-by-Step Instructions to Resolve Transition Issues
16+
17+
1. **Verify Current Configuration**
18+
- Navigate to **Azure Portal**.
19+
- Go to **Monitor** > **Activity Log** > **Export Activity Log**.
20+
- Select your subscription from the dropdown and ensure a diagnostic setting is configured.
21+
22+
2. **Update Automation Scripts**
23+
- If you have scripts using the legacy API, update them to use the **diagnostic settings API** by September 30, 2026.
24+
- Refer to the [Azure Diagnostic Settings API Documentation](https://learn.microsoft.com/azure/azure-monitor/essentials/activity-log?tabs=powershell#legacy-collection-methods) for guidance.
25+
26+
3. **Check Log Analytics Workspace**
27+
- Ensure the destination Log Analytics Workspace is active.
28+
- If the workspace is inactive, change the destination to an active subscription.
29+
30+
4. **Run PowerShell Script to List Diagnostic Settings**
31+
- Open **Azure Cloud Shell** or any PowerShell connected to your tenant.
32+
- Run the following script to list all diagnostic settings across your subscriptions:
33+
34+
```powershell
35+
# Install and login with Connect-AzAccount
36+
If ($null -eq (Get-Command -Name Get-CloudDrive -ErrorAction SilentlyContinue)) {
37+
If ($null -eq (Get-Module Az -ListAvailable -ErrorAction SilentlyContinue)){
38+
Write-Host Installing Az module from default repository
39+
Install-Module -Name Az -AllowClobber
40+
}
41+
Write-Host Importing Az
42+
Import-Module -Name Az
43+
Write-Host Connecting to Az
44+
Connect-AzAccount
45+
}
46+
# Get all Azure Subscriptions
47+
$Subs = Get-AzSubscription
48+
# Set array
49+
$DiagResults = @()
50+
# Loop through all Azure Subscriptions
51+
foreach ($Sub in $Subs) {
52+
Set-AzContext $Sub.id | Out-Null
53+
Write-Host Processing Subscription: ($Sub).name
54+
# Get all Azure resources for current subscription
55+
$Resources = Get-AZResource
56+
# Get all Azure resources which have Diagnostic settings enabled and configured
57+
foreach ($res in $Resources) {
58+
$resId = $res.ResourceId
59+
$DiagSettings = Get-AzDiagnosticSetting -ResourceId $resId -WarningAction SilentlyContinue -ErrorAction SilentlyContinue | Where-Object { $_.Id -ne $null }
60+
foreach ($diag in $DiagSettings) {
61+
# Store all results for resource in PS Object
62+
$item = [PSCustomObject]@{
63+
ResourceName = $res.name
64+
DiagnosticSettingsName = $diag.name
65+
StorageAccountName = $diag.StorageAccountId
66+
EventHubName = $diag.EventHubAuthorizationRuleId
67+
WorkspaceName = $diag.WorkspaceId
68+
Subscription = $Sub.Name
69+
ResourceId = $resId
70+
DiagnosticSettingsId = $diag.Id
71+
}
72+
Write-Host $item
73+
# Add PS Object to array
74+
$DiagResults += $item
75+
}
76+
}
77+
}
78+
# Save Diagnostic settings to CSV as tabular data
79+
$DiagResults | Export-Csv -Force -Path .\AzureResourceDiagnosticSettings-$(get-date -f yyyy-MM-dd-HHmm).csv
80+
```
81+
82+
## Reference
83+
- [Azure Diagnostic Settings Documentation](https://learn.microsoft.com/azure/azure-monitor/essentials/activity-log?tabs=powershell#legacy-collection-methods)
84+
- [Azure Monitor Overview](https://learn.microsoft.com/azure/azure-monitor/overview)
85+
86+
If the issue persists after following the solution steps, please open a support case for further assistance.
Lines changed: 44 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,44 @@
1+
---
2+
title: Understanding and Transitioning from Legacy to Diagnostic Settings for Azure Activity Logs
3+
description: Provides step-by-step instructions to transition from legacy to diagnostic settings.
4+
ms.date: 07/09/2025
5+
ms.reviewer: v-liuamson
6+
ms.service: azure-monitor
7+
ms.custom: I can’t configure export of Activity Logs
8+
---
9+
# Understanding and Transitioning from Legacy to Diagnostic Settings for Azure Activity Logs
10+
11+
When Azure announced the transition from legacy solutions to diagnostic settings for forwarding activity logs, users received notifications about necessary updates. This article provides guidance on how to manage this transition effectively.
12+
13+
### Introduction
14+
Azure is retiring the legacy solution for forwarding activity logs and replacing it with diagnostic settings. This change is automatic, but users with automation relying on the legacy API need to update their configurations. This guide will help you verify your current setup and make necessary adjustments.
15+
16+
### Step-by-Step Instructions to Transition to Diagnostic Settings
17+
18+
1. **Verify Existing Log Profiles**
19+
- Use the **Get-AzLogProfile** command in Azure PowerShell or the **az monitor log-profiles list** command in Azure CLI to check for existing log profiles.
20+
- If these commands return no results, no legacy log profiles are configured, and no action is needed.
21+
22+
2. **Update Automation Scripts**
23+
- If you have automation scripts using the legacy API, update them to use the diagnostic settings API by September 30, 2026.
24+
- Refer to the [Azure Monitor documentation](https://learn.microsoft.com/azure/azure-monitor/platform/activity-log?tabs=powershell#managing-legacy-log-profiles---retiring) for detailed instructions.
25+
26+
3. **Manual Transition to Diagnostic Settings**
27+
- For users with legacy log profiles, manually transition to diagnostic settings by following the steps outlined in the Azure documentation.
28+
- Ensure all configurations are updated before the retirement date to avoid disruptions.
29+
30+
### Common Issues and Solutions
31+
32+
- **Issue:** Unable to find existing log profiles.
33+
- **Solution:** Ensure you are using the correct commands and have the necessary permissions to access log profiles.
34+
35+
- **Issue:** Automation scripts fail after the transition.
36+
- **Solution:** Double-check that all scripts are updated to use the new diagnostic settings API.
37+
38+
### Reference
39+
40+
- [Azure Monitor Documentation](https://learn.microsoft.com/azure/azure-monitor/platform/activity-log?tabs=powershell#managing-legacy-log-profiles---retiring)
41+
- [Get-AzLogProfile Command](https://learn.microsoft.com/powershell/module/az.monitor/get-azlogprofile?view=azps-14.0.0)
42+
- [Azure CLI Log Profiles](https://learn.microsoft.com/cli/azure/monitor/log-profiles?view=azure-cli-latest#az-monitor-log-profiles-list)
43+
44+
If the issue persists after following the solution steps, please open a support case for further assistance.

support/azure/azure-monitor/toc.yml

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,16 @@
11
items:
22
- name: Troubleshoot Azure Monitor
33
href: welcome-azure-monitor.yml
4+
- name: Activity Logs
5+
items:
6+
- name: I can't configure export of Activity Logs
7+
items:
8+
- name: Configuring Export in Azure Portal
9+
items:
10+
- name: Diagnostic Settings Transition from Legacy Solutions
11+
href: activity-logs/config-export/diagnostic-settings-transition-from-legacy-solutions.md
12+
- name: Understanding and Transitioning from Legacy to Diagnostic Settings for Azure Activity Logs
13+
href: activity-logs/config-export/understanding-and-transitioning-from-legacy-to-diagnostic-settings.md
414
- name: Application Insights
515
items:
616
- name: OpenTelemetry troubleshooting

support/azure/azure-monitor/welcome-azure-monitor.yml

Lines changed: 10 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -9,13 +9,22 @@ metadata:
99
ms.topic: landing-page # Required
1010
author: genlin #Required; your GitHub user alias, with correct capitalization.
1111
ms.author: genli #Required; microsoft alias of author; optional team alias.
12-
ms.date: 04/30/2025
12+
ms.date: 07/09/2025
1313

1414
# linkListType: architecture | concept | deploy | download | get-started | how-to-guide | learn | overview | quickstart | reference | tutorial | video | whats-new
1515

1616
landingContent:
1717

1818
# Card
19+
- title: Troubleshoot Azure Activity Log issues
20+
linkLists:
21+
- linkListType: how-to-guide
22+
links:
23+
- text: Diagnostic Settings Transition from Legacy Solutions
24+
url: ./activity-logs/config-export/diagnostic-settings-transition-from-legacy-solutions.md
25+
- text: Understanding and Transitioning from Legacy to Diagnostic Settings for Azure Activity Logs
26+
url: ./activity-logs/config-export/understanding-and-transitioning-from-legacy-to-diagnostic-settings.md
27+
1928
- title: Troubleshoot Azure Application Insights issues
2029
linkLists:
2130
- linkListType: how-to-guide

0 commit comments

Comments
 (0)