Skip to content

Commit 2f02ad1

Browse files
committed
Updated text
1 parent f894445 commit 2f02ad1

File tree

2 files changed

+35
-16
lines changed

2 files changed

+35
-16
lines changed

azure-local/manage/disconnected-operations-fallback.md

Lines changed: 1 addition & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -160,16 +160,6 @@ The autogenerated output folder, **CopyLogs_20240501T1525097418**, has the copie
160160
- **RobocopyLog.log**: Records the copying of all file types except Windows Event files.
161161
- **wevtutil**: A tool used to copy Windows events. This activity is logged in the **WEvtUtilLog.log** file.
162162

163-
Here are examples of the **LogsToExport** folder structures:
164-
165-
Overall file structure:
166-
167-
[![Screenshot of the copy diagnostics overall file structure.](./media/disconnected-operations/fallback-log/overall-file-structure.png)](media/disconnected-operations/fallback-log/overall-file-structure.png#lightbox)
168-
169-
Azure Local VM running disconnected nested file structure:
170-
171-
[![Screenshot of the Azure Local VM running disconnected nested file structure.](./media/disconnected-operations/fallback-log/nested-file-structure.png)](media/disconnected-operations/fallback-log/nested-file-structure.png#lightbox)
172-
173163
### Send-DiagnosticData
174164

175165
After you collect logs into a directory, either by using the `Copy-DiagnosticData` cmdlet or by copying them manually, send them to Microsoft with the standalone pipeline. This pipeline Arc-enables the host (the machine running the cmdlet) to perform the operation, targets all the logs in the file location you provide, and sends them for ingestion to Microsoft. If log ingestion fails, the cmdlet tries up to three times and then outputs the results of the send activity when it's complete.
@@ -245,13 +235,8 @@ Log parsing engine results can be found under:
245235
G:\CopyLogs_20241218T1622391740\SendLogs_20241218T1625348996\ObsScheduledTaskTranscripts
246236
```
247237

248-
Here's an example of the file structure for the send logs:
249-
250-
[![Screenshot of the file structure for the send logs.](./media/disconnected-operations/fallback-log/send-logs-file-structure.png)](media/disconnected-operations/fallback-log/send-logs-file-structure.png#lightbox)
251-
252-
The send logs file structure has all the logs and installation files from the standalone observability pipeline, including the **GMACache logs** and pipeline install and uninstall logs.
253-
254238
## Related content
239+
255240
- [Collect logs on-demand with Azure Local disconnected operations (preview)](disconnected-operations-on-demand-logs.md)
256241
- [Disconnected operations with Azure Local Overview](disconnected-operations-overview.md)
257242

azure-local/manage/disconnected-operations-on-demand-logs.md

Lines changed: 34 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -481,6 +481,40 @@ For more information, see [Use appliance fallback log collection](disconnected-o
481481
482482
- `Invoke-ApplianceLogCollectionAndSaveToShareFolder`: you need to specify the account in the format: Domain\Username, if you omit the domain or use an incorrect username, the copy operation to the share will fail with an access-denied error.
483483
484+
## When to use on-demand log collection
485+
486+
Use on-demand direct log collection when an on-premises device running Azure Local temporarily has connectivity to Azure.
487+
488+
- Improper Execution of Send-DiagnosticData.
489+
- Log collection fails when customers attempt to run Send-DiagnosticData or copy diagnostic data from:
490+
- Nodes that are not part of the Azure Local host infrastructure.
491+
- External machines (e.g., personal laptops) that do not host the required appliance VMs (such as IRVM) on the same Hyper-V host.
492+
493+
- Misuse of the Observability Tool.
494+
- The Standalone Observability Tool must be:
495+
- Run on a Windows Server.
496+
- Configured with additional manual steps if executed in unsupported environments.
497+
498+
### Indirect or Fallback Log Collection (Disconnected Mode)
499+
500+
Use indirect log collection methods when direct upload is not possible:
501+
502+
- Run the following commands on the seed node:
503+
- `Invoke-ApplianceLogCollectionAndSaveToShareFolder`
504+
- `Copy-DiagnosticData`
505+
506+
- Ensure that:
507+
- The share folder is accessible.
508+
- Troubleshooting instructions are provided for common failures (e.g., permission issues, missing dependencies).
509+
510+
### Uploading Logs to Microsoft Support
511+
512+
To upload collected logs to Microsoft:
513+
514+
- Use the Send-DiagnosticData command from the Azure Local Disconnected Operations PowerShell module.
515+
- Important: This command must not be run on Azure Local host nodes, as those are managed by the ALDO control plane.
516+
- Instead, run it from a Windows machine with Azure connectivity—ideally the customer’s laptop or desktop.
517+
484518
## Related content
485519
486520
- Learn how and when to use [Use appliance fallback log collection](disconnected-operations-fallback.md).

0 commit comments

Comments
 (0)