收集 Azure 本機服務的診斷記錄 (預覽中)

發行項
03/10/2025

適用於：Azure Local 2311.2 和更新版本

本文說明如何收集 Azure Local 的診斷記錄，並透過 Azure 入口網站或 PowerShell 將其傳送至Microsoft。這些診斷記錄有助於識別並修正 Azure 本機解決方案的任何問題。

重要

這項功能目前為「預覽」狀態。請參閱 Microsoft Azure 預覽版增補使用規定，以了解適用於 Azure 功能 (搶鮮版 (Beta)、預覽版，或尚未正式發行的版本) 的法律條款。

關於隨選記錄收集

隨需記錄收集是指手動收集並傳送診斷記錄到 Microsoft。這些記錄會儲存在 Kusto 資料庫中，其中 Microsoft 支援服務可以存取它們，以協助解決回報的問題。收集的診斷數據會保留最多 30 天，並根據Microsoft 的標準隱私權做法來管理。

隨需日誌收集的使用時機

您可以在下列案例中執行隨選記錄收集：

當 Microsoft 支援服務要求開啟案例的記錄時。
當系統連線並註冊時。
當可觀察性元件安裝並運作正常時。
當系統只部分註冊時。
對於與註冊失敗無關的問題。

若要探索 Azure Local 的其他記錄收集方法並瞭解其使用時機，請參閱診斷。

必要條件

收集隨選記錄之前，您必須完成下列必要條件：

您必須能夠存取已部署和註冊的 Azure 本機實例。
您必須安裝 AzureEdgeTelemetryAndDiagnostics 擴充功能，才能從 Azure 本機實例收集遙測和診斷資訊。如需擴充功能的相關信息，請參閱 Azure 本機遙測和診斷擴充功能概觀。

收集 Azure 本地的記錄

您可以使用下列任一方法來執行隨選記錄收集：

（建議）Azure 入口網站。當您想要在系統層級收集及傳送記錄時，請使用此方法。
PowerShell。如果您想要根據特定參數收集記錄，請使用此方法。您可以選擇將記錄儲存至SMB共用、傳送補充記錄，或只傳送特定角色的記錄。

在開始收集記錄之前，請記住下列資訊：

記錄收集所需的時間取決於您指定的時間範圍。時間範圍越長，記錄收集所需的時間就越長。因此，我們建議將時間範圍限制為只限制您需要的記錄。
不支持超過24小時的記錄集合。
同時嘗試多個記錄檔集合會導致失敗。

Azure 入口網站（建議）
PowerShell

請遵循下列步驟，透過 Azure 入口網站收集 Azure 本機實例的診斷記錄：

在 Azure 入口網站中，移至 Azure 本機實例資源。
在左窗格中的 [設定] 底下，選取 [診斷和遠端支援]。
若要立即收集並傳送記錄，請選取 [ 傳送記錄]。
在 [將診斷記錄傳送至Microsoft] 窗格中，選取 [記錄開始時間和記錄結束時間]，然後選取 [收集及上傳記錄] 按鈕。

您會收到一則通知，指出最多可能需要 30 分鐘的時間才能收集診斷記錄。
[ 記錄活動 ] 表格會顯示日誌收集的狀態。如需了解特定記錄收集的更多詳細資訊，請選取在收集時間下的連結，並在 [記錄詳細窗格] 中檢閱詳細資訊。如果您遇到問題並需要 Microsoft 支援服務的協助，他們可能會要求相互關聯標識碼來找出記錄。

若要使用PowerShell進行記錄收集，請從 Azure 本機實例內的任何節點執行 Send-DiagnosticData Cmdlet。此 Cmdlet 會暫時在本機複製記錄。複製的記錄會剖析、傳送至Microsoft，然後從系統中刪除。

以下是使用PowerShell收集記錄時需要考慮的一些重點：

Cmdlet 的 Send-DiagnosticData 完成時間會因要收集記錄的角色、指定的時間長度和 Azure 本機環境中的節點數目等因素而有所不同。
如果您未指定任何參數， Send-DiagnosticData Cmdlet 會收集過去一小時內所有節點的數據。

以下是的 Send-DiagnosticData語法：

Send-DiagnosticData [[-FilterByRole] <string[]>] [[-FromDate] <datetime>] [[-ToDate] <datetime>] [[-CollectSddc] <bool>] [<CommonParameters>]

如需Send-DiagnosticData的參考資訊，請參閱本文稍後的Send-DiagnosticData命令參考一節。

範例和範例輸出

以下是一些範例命令，其中包含範例輸出，示範如何使用 Send-DiagnosticData Cmdlet 搭配不同的參數。

使用日期篩選傳送診斷數據

在此範例中，您會傳送過去兩個小時的記錄檔，並對其進行日期篩選的診斷數據：

Send-DiagnosticData -FromDate (Get-Date).AddHours(-2) -ToDate (Get-Date)

以下是此指令的範例輸出：

PS C:\CloudDeployment\logs> Send-DiagnosticData -FromDate (Get-Date).AddHours(-2) -ToDate (Get-Date)
Converting FromDate and ToDate to UTC
FromDate in UTC is now 12/04/2023 19:14:18. ToDate in UTC is now 12/04/2023 21:14:18
The correlation Id is <Correlation-ID>. This is used to query for this log collection in the diagnostic pipeline.
Provide the below information to the customer support engineer working on your case.
AEORegion: eastus
AEODeviceARMResourceUri: /Subscriptions/<Subscription-ID>/resourceGroups/EDGECI-REGISTRATION/providers/Microsoft.AzureStackHCI/clusters/<cluster-name>
AEOClusterNodeArcResourceUri: /subscriptions/<Subscription-ID>/resourceGroups/EDGECI-REGISTRATION/providers/Microsoft.HybridCompute/machines/<v-host-name>
CorrelationId: <Correlation-ID>
Observability Agent is running.
Successfully submitted on-demand. Log collection Job Id: <Job-ID>. This is used to track the log collection with Get-LogCollectionHistory.
Current log collection status: Running
Waiting for log collection to complete... 
==== CUT ==================== CUT =======
Log collection ended with status: Succeeded
PS C:\CloudDeployment\logs>

傳送指定角色的診斷數據

在此範例中，您會使用BareMetal和ECE的角色篩選來傳送診斷數據：

Send-DiagnosticData -FilterByRole BareMetal, ECE –CollectSddc $false

以下是此指令的範例輸出：

PS C:\Users\docsuser> Send-DiagnosticData -FilterByRole BareMetal, ECE –CollectSddc $false
FromDate parameter not specified. Setting to default value 12/04/2023 20:41:21
ToDate parameter not specified. Setting to default value 12/04/2023 21:41:21
Converting FromDate and ToDate to UTC
FromDate in UTC is now 12/04/2023 20:41:21. ToDate in UTC is now 12/04/2023 21:41:21
The correlation Id is <Correlation-ID>. This is used to query for this log collection in the diagnostic pipeline.
Provide the below information to the customer support engineer working on your case.
AEORegion: eastus
AEODeviceARMResourceUri: /Subscriptions/<Subscription-ID>/resourceGroups/EDGECI-REGISTRATION/providers/Microsoft.AzureStackHCI/clusters/cluster-e5c7b2aa9a36490f9567b432a0eb51f1
AEOClusterNodeArcResourceUri: /subscriptions/<Subscription-ID>/resourceGroups/EDGECI-REGISTRATION/providers/Microsoft.HybridCompute/machines/v-Host1
CorrelationId: <Correlation-ID>
Observability Agent is running.
Successfully submitted on-demand. Log collection Job Id: <Job-ID>. This is used to track the log collection with Get-LogCollectionHistory.
Current log collection status: Running
Waiting for log collection to complete... 
==== CUT ==================== CUT =======
Log collection ended with status: Succeeded
PS C:\Users\docsuser>

取得日誌收集的歷史記錄

您可以取得您進行的所有日誌集合的歷程記錄。此歷程記錄可協助您了解記錄集合的類型、記錄集合的大小、收集記錄的時間，以及記錄收集的方法。

若要取得過去 90 天記錄檔集合的歷程記錄，請輸入：

Get-LogCollectionHistory

以下是 Get-LogCollectionHistory Cmdlet 的範例輸出。參數 datetime 位於UTC時區。

PS C:\CloudDeployment\logs> Get-LogCollectionHistory
Name                           Value
----                           -----
TimeCollected                  9/29/2022 5:08:14 PM +00:00
Status                         Succeeded
CollectionFromDate             9/29/2022 4:07:57 PM +00:00
CollectionToDate               9/29/2022 5:07:57 PM +00:00
LogCollectionId                fdcd94c8-1bd2-4ec6-8612-c92d5abd9a84
Type                           OnDemand
LogUploadSizeMb                1598
UploadNumberOfFiles            1924
Directory
Location
Error
----------                     ---------------------------------------------------------
TimeCollected                  9/27/2022 11:57:25 PM +00:00
Status                         Succeeded
CollectionFromDate             9/27/2022 9:57:16 PM +00:00
CollectionToDate               9/27/2022 11:57:16 PM +00:00
LogCollectionId                f3d8dcc6-901e-4c72-a3cc-210055e6f198
Type                           OnDemand
LogUploadSizeMb                1069
UploadNumberOfFiles            1941
Directory
Location
Error
PS C:\CloudDeployment\logs>

如果您有網路問題或偏好在本機儲存數據，而不是將數據傳送至 Azure，您可以將診斷記錄儲存在本機伺服器訊息塊（SMB）共用上。

請遵循下列步驟，將記錄儲存至本機共用：

執行下列命令來建立共用：

New-SMBShare -Name <share-name> -Path <path-to-share> -FullAccess Users -ChangeAccess 'Server Operators'

執行下列命令以建立共用的 PSCredentials：

$user = "<username>"
$pass = "<password>"
$sec=ConvertTo-SecureString -String $pass -AsPlainText -Force
$shareCredential = New-Object System.Management.Automation.PSCredential ($user, $sec)

在系統的每個節點上執行下列命令，以收集記錄，並將其儲存在本機：
```
Send-DiagnosticData -SaveToPath <path to share> -ShareCredential $shareCredential
```
如果您從儲存記錄的 SMB 共用具有輸出連線能力，您可以執行下列命令，將記錄傳送至Microsoft：
```
Send-DiagnosticData NoLogCollection -SupplementaryLogs <path-to-share> -ShareCredentail $shareCredential
```

`Send-DiagnosticData` 命令參考

本節提供有關的 Send-DiagnosticData參考資訊，包括其參數、語法和使用範例。

起始日期和結束日期

這些參數可讓您收集特定時段的記錄。

語法

Send-DiagnosticData [[-FilterByRole] <string[]>] [[-FromDate] <datetime>] [[-ToDate] <datetime>] [[-CollectSddc] <bool>]  [<CommonParameters>]

範例

$fromDate = Get-Date -Date "11/30/2023 18:35:00"
$toDate = Get-Date -Date "11/30/2023 19:35:00"
Send-DiagnosticData –FromDate $fromDate –ToDate $toDate

延伸模組版本

全部

依角色篩選

此參數可讓您選擇要收集哪些角色的日誌。您可以指定多個角色。如需您可以篩選記錄的可用角色清單，請參閱可用於篩選記錄的角色。

語法

Send-DiagnosticData [[-FilterByRole] <string[]>]

範例

Send-DiagnosticData –FilterByRole “ALM” -CollectSddc $false

延伸模組版本

全部

CollectSddc

判斷是否要包含或排除軟體定義資料中心（SDDC）記錄。根據預設，會包含 SDDC 記錄。如果您想要將其排除，請將它設定為$false。如需使用 SDDC 診斷工具的詳細資訊，請參閱收集系統的診斷數據。

語法

Send-DiagnosticData [-CollectSddc <bool>]

範例

Send-DiagnosticData –CollectSddc $false

延伸模組版本

全部

BypassObsAgent

略過可觀察性代理程式時，只會在起始記錄收集的節點上收集記錄。集合的記錄不會保留在歷程記錄中。

語法

Send-DiagnosticData [-BypassObsAgent]

範例

Send-DiagnosticData –BypassObsAgent

延伸模組版本

全部

SaveToPath

此參數可讓您將診斷記錄儲存至主計算機上的指定路徑，而不是將它們傳輸至Microsoft。

語法

Send-DiagnosticData -SaveToPath <string> [-FilterByRole <string[]>] [-FromDate <datetime>] [-ToDate <datetime>] [-CollectSddc <bool>] [-SupplementaryLogs <string>] [-ShareCredential <pscredential>] [-BypassObsAgent]  [<CommonParameters>]

範例

您可以在主機上將共享路徑或輸出路徑提供給 SaveToPath 參數。

Send-DiagnosticData –SaveToPath <output path>

Send-DiagnosticData –SaveToPath <share path>

如果您使用未對應的共享路徑，您也必須使用 -ShareCredential 參數。

Send-DiagnosticData –SaveToPath <share path> -ShareCredential <credentials for share path>

您可以搭配其他參數使用 SaveToPath ，例如 FilterByRole、 FromDate、 ToDate、、 CollectSddc、 SupplementaryLogs、 ShareCredential和 BypassObsAgent。

Send-DiagnosticData –SaveToPath <output path> -FIlterByRole <role>

延伸模組版本

1.0.2.0 版和更新版本

NoLogCollection

switch NoLogCollection 參數可讓您將特定記錄集傳送至Microsoft。使用此參數時，請考慮下列詳細數據：

您可以將SupplementaryLogs、ShareCredential和BypassObsAgent參數與NoLogCollection參數結合。
使用 SupplementaryLogs時，參數NoLogCollection是必要參數。它會指定需要傳送至Microsoft之記錄的路徑。
您可以彈性地將主機上的共享路徑或輸出路徑傳遞至 SupplementaryLogs 參數。如果您使用未對應的共享路徑，也必須使用 -ShareCredential 參數。

語法

Send-DiagnosticData -SupplementaryLogs <string> -NoLogCollection [-ShareCredential <pscredential>] [-BypassObsAgent]  [<CommonParameters>]

範例

搭配強制–NoLogCollection參數使用SupplementaryLogs：

Send-DiagnosticData –NoLogCollection –SupplementaryPath <output path>

請使用 –NoLogCollection 搭配未對應的共享路徑：

Send-DiagnosticData –NoLogCollection –SupplementaryPath <share path>
-ShareCredential <credential to share path>

延伸模組版本

1.0.2.0 版和更新版本

補充記錄

SupplementaryLogs 參數可讓您將臨機操作記錄傳送至Microsoft。

語法

您可以透過下列方式使用它：

使用 SaveToPath。在此案例中，會收集診斷記錄和臨機操作記錄並儲存至指定的路徑。

Send-DiagnosticData [-SupplementaryLogs <string>] -SaveToPath <path>

使用 NoLogCollection。在這裡，只會收集特定記錄並傳送至Microsoft。不會收集任何診斷記錄。

Send-DiagnosticData -SupplementaryLogs <string> -NoLogCollection

不含 SaveToPath 或 NoLogCollection。這表示會收集診斷記錄和臨機操作記錄，並傳送至Microsoft。

Send-DiagnosticData [-SupplementaryLogs <string>]

收集診斷和臨機操作記錄時，您可以將參數與其他參數搭配使用 SupplementaryLogs ，例如 FilterByRole、 FromDate、 ToDate和 CollectSddc。

範例

不含 SaveToPath 或 NoLogCollection：

Send-DiagnosticData –SupplementaryLogs <path to adhoc logs to collect>

使用 SaveToPath：

Send-DiagnosticData –SaveToPath <path> -SupplementaryLogs <path to adhoc logs to collect>

使用 NoLogCollection：

Send-DiagnosticData –NoLogCollection –SupplementaryLogs <path to adhoc logs to collect>

延伸模組版本

1.0.2.0 版和更新版本

ShareCredential

此參數提供收集記錄並將其儲存到共享路徑或直接從共享路徑傳送記錄到Microsoft的彈性。

語法

將記錄儲存至路徑：

Send-DiagnosticData [-ShareCredential <pscredential>] -SaveToPath <path>

將共享路徑上的記錄傳送至Microsoft：

Send-DiagnosticData [-ShareCredential <pscredential>] -SupplementaryLogs <path> -NoLogCollection;

範例

將記錄儲存至路徑：

Send-DiagnosticData –SaveToPath <share path> -ShareCredential <credential to share path>

將共享路徑上的記錄傳送至Microsoft：

Send-DiagnosticData –NoLogCollection –SupplementaryLogs <share path> –ShareCredential <credential to the share path>

延伸模組版本

全部

（計劃淘汰）ToSMBShare

此參數可讓您將記錄儲存至輸出路徑或共享路徑。如果您使用未被映射的共享路徑，那麼您也需要使用 ShareCredential 參數。由於這個參數將在未來的延伸模組版本中移除，請改用 -SaveToPath 參數。

語法

Send-DiagnosticData –ToSMBShare –SharePath <path> [-ShareCredential <pscredential>]

範例

將記錄儲存至輸出路徑或共享路徑：

Send-DiagnosticData –ToSMBShare –SharePath <output path or share path>

將記錄儲存至未映射的共享路徑：

Send-DiagnosticData –ToSMBShare –SharePath <share path> -ShareCredential <credential for the share path>

延伸模組版本

不過，一開始可跨所有版本存取此參數，最終會限製為0.1.42版和更早版本。

（計劃淘汰）FromSMBShare

此參數可讓您直接從輸出路徑或共享路徑將記錄傳送至Microsoft。如果您使用未映射的共享路徑，您也需要使用 ShareCredential 參數。由於這個參數將在未來的延伸模組版本中移除，請改用 -NoLogCollection 參數。

語法

Send-DiagnosticData –FromSMBShare –SharePath <path> [-ShareCredential <pscredential>]

範例

Send-DiagnosticData –FromSMBShare –SharePath <output path or share path>

Send-DiagnosticData –FromSMBShare –SharePath <share path>

延伸模組版本

不過，一開始可跨所有版本存取此參數，最終會限製為0.1.42版和更早版本。

（計劃淘汰）SharePath

SharePath 參數可用於下列其中一個用途：

將診斷記錄儲存至共享路徑或輸出路徑。
從共享路徑或輸出路徑將記錄傳送至Microsoft。如果您使用共用路徑但該路徑未對應，則必須使用ShareCredential參數。

由於這個參數將在未來的擴充功能版本中被移除，請使用 –SaveToPath 將記錄儲存至路徑，或用 –SupplementaryLogs 將臨時操作記錄傳送至 Microsoft。

語法

Send-DiagnosticData –ToSMBShare –SharePath <path> [-ShareCredential <pscredential>];

Send-DiagnosticData –FromSMBShare –SharePath <path> [-ShareCredential <pscredential>];

範例

Send-DiagnosticData –ToSMBShare –SharePath <output path or share path>

Send-DiagnosticData –ToSMBShare –SharePath <share path> -ShareCredential <credential for the share path>

Send-DiagnosticData –FromSMBShare –SharePath <output path or share path>

Send-DiagnosticData –FromSMBShare –SharePath <share path>

延伸模組版本

不過，一開始可跨所有版本存取此參數，最終會限製為0.1.42版和更早版本。

可用於篩選記錄的角色

下列角色可供 FilterByRole 參數篩選。未來版本中可用的角色可能會有所不同。

角色名稱	描述
ALM（應用程式生命週期管理）	應用程式生命週期管理（ALM）涉及管理軟體應用程式的開發、測試、部署和維護。
ArcAgent	允許透過 Azure Arc 管理 Windows Server 的代理程式。請參閱 Azure 連線機器代理程式概觀。
BareMetal	基礎結構角色可讓您在裸機伺服器上執行服務，而不需要虛擬化層。您可以完整存取及控制作業系統和硬體。
CommonInfra	收集常見基礎結構元件的記錄，例如網路、記憶體和安全性。
部署日誌	記錄部署程式的詳細數據，包括所採取的步驟、發生錯誤和作業狀態。
ECE	管理生命週期工作流程，包括部署、更新、新增節點和節點取代。
擴展	與 Azure 受控延伸模組相關的數據。
FleetDiagnosticsAgent (艦隊診斷代理)	監聽健康觸發條件以開始日誌收集。這些記錄可用來診斷 FleetDiagnosticsAgent 和記錄收集的問題。
HCICloudService	Azure 雲端服務，提供 Azure Local 的核心功能。其結合了 Azure 電源與內部部署機器的彈性。
DownloadService	用於下載更新內容的基礎結構服務一部分。
健全狀況	從各種來源收集健康情況、效能和使用方式數據，例如事件記錄檔和性能計數器。
HostNetwork	用於排除網路 ATC 故障的日誌，這是配置主機網路的基礎操作系統元件。
MOC_ARB	管理堆疊，可在 Azure 本機和 Windows Server 上對虛擬機進行雲端式管理。
NC	與網路基礎結構相關的資訊。
ObservabilityLogmanTraces	收集可觀察性追蹤的記錄。這些記錄有助於針對傳送診斷數據的問題進行疑難解答。
可觀察性容量	收集觀察性容量的日誌。
OEMDiagnostics	收集 OEM 診斷的記錄，有助於識別和解決伺服器硬體的問題，例如 BIOS、驅動程式、感測器等等。
OSUpdateLogs	在 Azure 本機節點上，負責收集與操作系統更新相關記錄的角色，可幫助解決更新相關的問題。
遠端支持代理	協助針對遠端支援會話的問題進行疑難解答的記錄，這些會話可用來解決客戶支援案例。
TestObservability（可觀測性測試）	從 `Test-Observability` Cmdlet 收集記錄，用來測試 `TelemetryAndDiagnostics` 擴充功能是否正常運作。
URP	由與`UpdateService`和`OsUpdate` ECE角色事件相關的日誌記錄所組成。管理 `Update Service` Azure 本機的更新。 `OsUpdate` ECE 角色是用來在機器（實體主機和 InfraVMs）上取得和安裝操作系統更新的，這些機器在系統的部署、新增節點、修復節點和 Infra VMs 更新情境中不屬於系統的一部分。這兩個元件的痕跡是 `URP` 角色的一部分。

在支援案例中提供必要資訊

如果您遇到問題並需要 Microsoft 支援服務的協助，他們可能會要求特定資訊來找出您的記錄。

Azure 入口網站
PowerShell

請遵循下列步驟，在 Azure 入口網站中提供必要資訊：

在 [診斷] 頁籤的 [記錄活動] 下，選取 [收集時間] 底下的相關記錄連結。
在 [記錄詳細數據] 窗格中，記下相互關聯標識符的值，並將它與 Microsoft 支援服務共用，以便進行疑難解答。

當您使用 Send-DiagnosticData 來收集記錄時，它也會在其輸出中提供您需要與 Microsoft 支援服務共用的重要詳細數據。收集記錄之後，系統會將記錄傳送至 Kusto 資料庫。 Microsoft 支援服務接著可以使用提供的資訊，在 Kusto 中找出您的記錄，並協助您解決回報的問題。

要求時，請與 Microsoft 支援服務共用下列資訊。從Send-DiagnosticData輸出中取得此資訊。

AEORegion：註冊裝置的位置。
AEODeviceARMResourceUri：要尋找資源的唯一標識符，例如： /subscriptions/<subscription GUID>/resourceGroups/<Name of Resource group>/providers/Microsoft.AzureStackHCI/clusters/<Name of Cluster>。
AEOClusterNodeArcResourceUri：尋找 ARC 資源的唯一標識符，例如： /subscriptions/<subscription GUID>/resourceGroups/<Name of Resource group>/providers/Microsoft.HybridCompute/Machines/<machine name>。
CorrelationId：用於定位記錄的唯一標識符。

下一步

連絡 Microsoft 支援服務

共用方式為

收集 Azure 本機服務的診斷記錄 (預覽中)

關於隨選記錄收集

隨需日誌收集的使用時機

必要條件

收集 Azure 本地的記錄

範例和範例輸出

使用日期篩選傳送診斷數據

傳送指定角色的診斷數據

取得日誌收集的歷史記錄

`Send-DiagnosticData` 命令參考

起始日期和結束日期

依角色篩選

CollectSddc

BypassObsAgent

SaveToPath

NoLogCollection

補充記錄

ShareCredential

（計劃淘汰）ToSMBShare

（計劃淘汰）FromSMBShare

（計劃淘汰）SharePath

可用於篩選記錄的角色

在支援案例中提供必要資訊

下一步

意見反應

其他資源