You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: azure-stack/hci/manage/collect-logs.md
+11-12Lines changed: 11 additions & 12 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -17,7 +17,7 @@ This article describes how to collect diagnostic logs for Azure Stack HCI and se
17
17
18
18
## About on-demand log collection
19
19
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/).
21
21
22
22
### When to use on-demand log collection
23
23
@@ -35,8 +35,7 @@ To explore other log collection methods in Azure Stack HCI and understand when t
35
35
36
36
Before you collect on-demand logs, you must complete the following prerequisites:
37
37
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.
40
39
- 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).
41
40
42
41
## Collect logs for Azure Stack HCI
@@ -51,31 +50,31 @@ You can perform on-demand log collection using any of the following methods:
51
50
52
51
Follow these steps to collect diagnostic logs for your Azure Stack HCI cluster via the Azure portal:
53
52
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.
55
54
1. In the left pane, under **Settings**, select **Diagnostics and Remote Support**.
56
55
1. On the **Get started** tab, under the **Send Diagnostics Logs** tile, select **Go to diagnostics**.
57
56
58
57
:::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" :::
59
58
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.
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.
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.
75
74
76
75
Here are some important points to consider when collecting logs using PowerShell:
77
76
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.
79
78
- If you don't specify any parameters, the `Send-DiagnosticData` cmdlet collects data from all nodes for the previous one-hour duration.
80
79
81
80
Here's the syntax of `Send-DiagnosticData`:
@@ -152,7 +151,7 @@ PS C:\Users\docsuser>
152
151
153
152
### Get a history of log collection
154
153
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.
156
155
157
156
To get a history of log collections for the last 90 days, enter:
158
157
@@ -274,7 +273,7 @@ All
274
273
275
274
### CollectSddc
276
275
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).
278
277
279
278
**Syntax**
280
279
@@ -390,13 +389,13 @@ The SupplementaryLogs parameter allows you to send ad-hoc logs to Microsoft.
390
389
391
390
You can use it in the following ways:
392
391
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.
0 commit comments