Skip to content
20 changes: 9 additions & 11 deletions azure-local/manage/collect-logs.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
title: Collect diagnostic logs for Azure Local (preview)
description: Learn how to collect diagnostic logs and share them with Microsoft (preview).
title: Collect diagnostic logs for Azure Local
description: Learn how to collect diagnostic logs and share them with Microsoft.
author: alkohli
ms.author: alkohli
ms.topic: how-to
Expand All @@ -9,7 +9,7 @@ ms.date: 04/08/2025
ms.custom: sfi-image-nochange
---

# Collect diagnostic logs for Azure Local (preview)
# Collect diagnostic logs for Azure Local

[!INCLUDE [applies-to](../includes/hci-applies-to-23h2.md)]

Expand Down Expand Up @@ -54,15 +54,9 @@ Keep in mind the following information before you start log collection:
- The time required for log collection depends on the time range you specify. The longer the time range, the more time it'll take for log collection. Therefore, we recommend limiting the time range to only the logs you need.
- Log collections longer than 24 hours aren't supported.
- Attempting multiple log collections simultaneously will result in a failure.
- Make sure the `DeviceManagementExtension` version is **1.2510.0.3012 and later**. If it's not, update the connected machine extension on all nodes to ensure compatibility, consistency, and successful log collection. Use the following command.
- If your cluster runs a build earlier than 2510, the portal shows a banner that says *Device Management Extension is outdated and not supported. Update to the latest version*, and disables the **Send Logs** button. To collect logs, upgrade your cluster to build 2510 or later.

- Make sure you replace the extension name and version with the appropriate values for your environment.

```powershell
$target = @{"Microsoft.Compute.CustomScriptExtension" = @{"targetVersion"="1.10.12"}} Update-AzConnectedExtension -ResourceGroupName $env.ResourceGroupName -MachineName $machineName -ExtensionTarget $target
```

For more information about updating the connected machine extension, see [Update-AzConnectedExtension](/powershell/module/az.connectedmachine/update-azconnectedextension?view=azps-12.5.0&preserve-view=true).
:::image type="content" source="./media/collect-logs/device-management-extension-disabled-logs.png" alt-text="Screenshot that shows the banner message and disabled send logs button." lightbox="./media/collect-logs/device-management-extension-disabled-logs.png" :::

### [Azure portal (recommended)](#tab/azureportal)

Expand All @@ -86,6 +80,9 @@ Follow these steps to collect diagnostic logs for your Azure Local instance via

:::image type="content" source="./media/collect-logs/log-details-pane.png" alt-text="Screenshot shows the Log details pane." lightbox="./media/collect-logs/log-details-pane.png" :::

> [!NOTE]
> In the Portal, after you start log collection, status updates can take up to five minutes to appear. This is expected behavior.

## [PowerShell](#tab/powershell)

To use PowerShell for log collection, run the `Send-DiagnosticData` cmdlet from any node within the Azure Local instance. This cmdlet temporarily copies the logs locally. The copied logs are parsed, sent to Microsoft, and then deleted from your system.
Expand Down Expand Up @@ -636,6 +633,7 @@ When requested, share the following information with Microsoft Support. Get this

---


## Next steps

- [Contact Microsoft Support](get-support.md).
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.