Skip to content

Commit 82074aa

Browse files
author
Manika Dhiman
committed
Addressed review feedback
1 parent 6071ca9 commit 82074aa

File tree

1 file changed

+11
-12
lines changed

1 file changed

+11
-12
lines changed

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

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

1818
## About on-demand log collection
1919

20-
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/).
20+
On-demand log collection involves manually collecting and sending diagnostic logs to Microsoft. The logs you collect are sent to the Kusto database. Microsoft Support can then use the information you provide to locate your logs in Kusto and assist you in resolving your 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

2222
### When to use on-demand log collection
2323

@@ -35,8 +35,7 @@ To explore other log collection methods in Azure Stack HCI and understand when t
3535

3636
Before you collect on-demand logs, you must complete the following prerequisites:
3737

38-
- You must have access to an Azure Stack HCI cluster.
39-
- You must have access to Azure.
38+
- You must have access to an Azure Stack HCI cluster that is deployed and registered.
4039
- 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).
4140

4241
## Collect logs for Azure Stack HCI
@@ -51,31 +50,31 @@ You can perform on-demand log collection using any of the following methods:
5150

5251
Follow these steps to collect diagnostic logs for your Azure Stack HCI cluster via the Azure portal:
5352

54-
1. In the Azure portal, go to the Azure Stack HCI cluster resource.
53+
1. In [the Azure portal](https://portal.azure.com/), go to the Azure Stack HCI cluster resource.
5554
1. In the left pane, under **Settings**, select **Diagnostics and Remote Support**.
5655
1. On the **Get started** tab, under the **Send Diagnostics Logs** tile, select **Go to diagnostics**.
5756

5857
:::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" :::
5958

60-
1. On the **Diagnostics** tab, under **Log activity**, review log collection history for your cluster. To get more details about a specific log collection entry, select the link under **Time collected** to view more information in the **Log details** pane.
59+
1. On the **Diagnostics** tab, under **Log activity**, review log collection history for your cluster. To get more details about a specific log collection entry, select the link under **Time collected** and view the **Log details** pane.
6160

6261
:::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" :::
6362

6463
1. To collect and send logs now, select **Send logs**.
6564

6665
:::image type="content" source="./media/collect-logs/diagnostics-tab.png" alt-text="Screenshot shows the Send logs button." lightbox="./media/collect-logs/diagnostics-tab.png" :::
6766

68-
1. On the **Send logs** pane on the right, select the **Log start time** and **Log end time**, and then select the **Collect and upload logs** button. By doing this, you agree to the terms and conditions of collection logs.
67+
1. On the **Send logs** pane on the right, select the **Log start time** and **Log end time**, and then select the **Collect and upload logs** button. By doing this, you agree to the terms and conditions of collecting logs.
6968

7069
:::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" :::
7170

7271
## [PowerShell](#tab/powershell)
7372

74-
To collect logs and send them to Microsoft using PowerShell, 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.
73+
To use PowerShell for log collection, run the `Send-DiagnosticData` cmdlet from any node within the Azure Stack HCI cluster. This cmdlet temporarily copies the logs locally. The copied logs are parsed, sent to Microsoft, and then deleted from your system.
7574

7675
Here are some important points to consider when collecting logs using PowerShell:
7776

78-
- The completion time of the `Send-DiagnosticData` cmdlet varies depending on factors, such as the roles for which logs are being collected, time duration specified, and the number of nodes in your Azure Stack HCI environment.
77+
- The completion time of the `Send-DiagnosticData` cmdlet varies depending on factors, such as the roles for which logs are being collected, the time duration specified, and the number of nodes in your Azure Stack HCI environment.
7978
- If you don't specify any parameters, the `Send-DiagnosticData` cmdlet collects data from all nodes for the previous one-hour duration.
8079

8180
Here's the syntax of `Send-DiagnosticData`:
@@ -152,7 +151,7 @@ PS C:\Users\docsuser>
152151

153152
### Get a history of log collection
154153

155-
You can get a history of all the log collections that you have performed. This history helps you learn about the kinds of log collections, the sizes of log collections, the times when logs were collected, and the methods of log collection.
154+
You can get a history of all the log collections that you've performed. This history helps you learn about the kinds of log collections, the sizes of log collections, the times when logs were collected, and the methods of log collection.
156155

157156
To get a history of log collections for the last 90 days, enter:
158157

@@ -274,7 +273,7 @@ All
274273

275274
### CollectSddc
276275

277-
Determines whether to include or exclude software-defined data center (SDDC) logs. By default, SDDC logs are included. Set it to $false if you want to exclude them. For more information about using SDDC diagnostic tools, see [Collect diagnostic data for clusters](./collect-diagnostic-data.md).
276+
This parameter helps determine whether to include or exclude software-defined data center (SDDC) logs. By default, SDDC logs are included. Set it to $false if you want to exclude them. For more information about using SDDC diagnostic tools, see [Collect diagnostic data for clusters](./collect-diagnostic-data.md).
278277

279278
**Syntax**
280279

@@ -390,13 +389,13 @@ The SupplementaryLogs parameter allows you to send ad-hoc logs to Microsoft.
390389

391390
You can use it in the following ways:
392391

393-
With `SaveToPath`. In this scenario, both diagnostic logs and ad-hoc logs are collected and saved to a specified path.
392+
In this scenario, with `SaveToPath`, both diagnostic logs and ad-hoc logs are collected and saved to a specified path.
394393

395394
```powershell
396395
Send-DiagnosticData [-SupplementaryLogs <string>] -SaveToPath <path>
397396
```
398397

399-
With `NoLogCollection`. Here, only ad-hoc logs are collected and sent to Microsoft. No diagnostic logs are collected.
398+
Here, with `NoLogCollection`, only ad-hoc logs are collected and sent to Microsoft. No diagnostic logs are collected.
400399

401400
```powershell
402401
Send-DiagnosticData -SupplementaryLogs <string> -NoLogCollection

0 commit comments

Comments
 (0)