Skip to content

Commit e8380e6

Browse files
author
Manika Dhiman
committed
Added tabs
1 parent 847ac0c commit e8380e6

File tree

1 file changed

+14
-11
lines changed

1 file changed

+14
-11
lines changed

azure-stack/hci/manage/collect-logs.md

Lines changed: 14 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -19,12 +19,6 @@ This article describes how to collect diagnostic logs for Azure Stack HCI and se
1919

2020
On-demand log collection involves manually collecting and sending diagnostic logs to Microsoft. After you collect logs, they're sent to the Kusto database. Microsoft Support can then use the information provided to locate your logs in Kusto and help you in resolving the reported issue. Microsoft retains this diagnostic data for up to 30 days and handles it as per the [standard privacy practices](https://privacy.microsoft.com/).
2121

22-
You can perform on-demand log collection using any of the following methods:
23-
24-
- **(Recommended) Azure portal**. Use this method when you want to collect logs at the cluster level and send them to Microsoft. See [Collect logs via the Azure portal](#collect-logs-via-the-azure-portal)
25-
26-
- **PowerShell**. Use this method if you want to collect logs based on specific parameters. You can save them to an SMB share, send supplementary logs, or send logs for specific rules only. To collect logs and send them to Microsoft, run the `Send-DiagnosticData` cmdlet from any node within the Azure Stack HCI cluster. When you run this cmdlet, the logs are temporarily copied locally. This copy is parsed, sent to Microsoft, and then deleted from your system. See [Collect logs via PowerShell](#collect-logs-via-powershell)
27-
2822
### When to use on-demand log collection
2923

3024
Here are the scenarios in which you can perform on-demand log collection:
@@ -39,14 +33,21 @@ To explore additional log collection methods in Azure Stack HCI and understand w
3933

4034
## Prerequisites
4135

42-
Before you collect on-demand logs via the Azure portal, you must complete the following prerequisites:
36+
Before you collect on-demand logs, you must complete the following prerequisites:
4337

4438
- You must have access to an Azure Stack HCI cluster.
4539
- You must have access to Azure.
4640
- You must have installed the `AzureEdgeTelemetryAndDiagnostics` extension to collect telemetry and diagnostics information from your Azure Stack HCI system. For information about the extension, see [Azure Stack HCI telemetry and diagnostics extension overview](../concepts/telemetry-and-diagnostics-overview.md).
47-
- You must review the terms and conditions for log collection.
4841

49-
## Collect logs via the Azure portal
42+
## Collect logs for Azure Stack HCI
43+
44+
You can perform on-demand log collection using any of the following methods:
45+
46+
- **(Recommended) Azure portal**. Use this method when you want to collect and send logs at the cluster level.
47+
48+
- **PowerShell**. Use this method if you want to collect logs based on specific parameters. You can save them to an SMB share, send supplementary logs, or send logs for specific rules only. To collect logs and send them to Microsoft, run the `Send-DiagnosticData` cmdlet from any node within the Azure Stack HCI cluster. When you run this cmdlet, the logs are temporarily copied locally. This copy is parsed, sent to Microsoft, and then deleted from your system.
49+
50+
### [Azure portal (recommended)](#tab/azureportal)
5051

5152
Follow these steps to collect diagnostic logs for you Azure Stack HCI cluster via the Azure portal:
5253

@@ -56,7 +57,7 @@ Follow these steps to collect diagnostic logs for you Azure Stack HCI cluster vi
5657

5758
:::image type="content" source="./media/collect-logs/get-started-tab.png" alt-text="Screenshot shows the Get started tab." lightbox="./media/collect-logs/get-started-tab.png" :::
5859

59-
1. On the **Diagnostics** page, under **Log activity**, review log collection history. You can also select a link under **Time collected** to view details about a specific log collection in the **Log details** pane.
60+
1. On the **Diagnostics** tab, under **Log activity**, review the log collection entries for your cluster. If you want more details about a specific log collection entry, select the link under **Time collected** to view more details in the **Log details** pane.
6061

6162
:::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" :::
6263

@@ -70,7 +71,7 @@ Follow these steps to collect diagnostic logs for you Azure Stack HCI cluster vi
7071

7172
:::image type="content" source="./media/collect-logs/send-logs-pane.png" alt-text="Screenshot shows the Send logs pane." lightbox="./media/collect-logs/send-logs-pane.png" :::
7273

73-
## Collect logs via PowerShell
74+
## [PowerShell](#tab/powershell)
7475

7576
Run the `Send-DiagnosticData` cmdlet from any node on your Azure Stack HCI cluster to perform on-demand log collection.
7677

@@ -615,6 +616,8 @@ The following roles are available for filtering by the **FilterByRole** paramete
615616
| TestObservability | Collects logs from the `Test-Observability` cmdlet, which is used to test that the `TelemetryAndDiagnostics` extension is working properly. |
616617
| URP | Consists of logs related to the `UpdateService` and `OsUpdate` ECE role events. The `Update Service` manages updates for Azure Stack HCI systems. The `OsUpdate` ECE role is used to acquire and install operating system updates on machines (physical hosts and InfraVMs) which aren't part of the cluster during the deployment, add node, repair node, and Infra VMs update scenarios. Traces from these two components are part of the `URP` role. |
617618

619+
---
620+
618621
## Next steps
619622

620623
- [Contact Microsoft Support](get-support.md)

0 commit comments

Comments
 (0)