次の方法で共有


Azure Stack HCI の診断ログを収集する

適用対象: Azure Stack HCI バージョン 23H2

この記事では、診断ログを収集し、それらを Microsoft に送信して、Azure Stack HCI ソリューションに関する問題を特定して修正する方法について説明します。

オンデマンド ログ収集

オンデマンド ログ収集では、Azure Stack HCI クラスター内の任意のノードから コマンドレットを Send-DiagnosticData 使用して、診断ログを手動で収集して Microsoft に送信します。 このコマンドレットを実行すると、ログが一時的にローカルにコピーされます。 このコピーは解析され、Microsoft に送信され、システムから削除されます。 Microsoft は、この診断データを最大 30 日間保持し、 標準のプライバシープラクティスに従って処理します。

オンデマンド ログ収集を使用するタイミング

オンデマンド ログ収集を実行できるシナリオを次に示します。

  • オープン ケースに基づいてログの要求をMicrosoft サポートします。
  • クラスターが接続されて登録されると、ログが収集されます。
  • Observability コンポーネントが操作可能でインストールされると、ログが収集されます。
  • ログは、クラスターが一部しか登録されていない場合に収集されます。
  • 登録エラーに関連しない問題のログが収集されます。

Azure Stack HCI で追加のログ収集方法を調べて、それらを使用するタイミングを理解するには、「 診断」を参照してください。

前提条件

オンデマンド ログを収集する前に、次の前提条件を満たす必要があります。

  • Azure Stack HCI クラスターにアクセスできる必要があります。
  • Azure にアクセスできる必要があります。
  • Azure Stack HCI システムからテレメトリと診断情報を収集するには、拡張機能をインストールAzureEdgeTelemetryAndDiagnosticsしておく必要があります。 拡張機能の詳細については、Azure Stack HCI テレメトリと拡張機能の概要診断参照してください。

PowerShell を使用したオンデマンド ログ収集の実行

この記事で後述するように、PowerShell、推奨される方法、またはAzure portalのWindows Admin Centerを使用して、オンデマンド ログ収集を実行できます。

Send-DiagnosticData Azure Stack HCI クラスター上の任意のノードからコマンドレットを実行して、オンデマンドログ収集を実行します。

考慮すべき重要な点は次のとおりです。

  • コマンドレットの Send-DiagnosticData 完了時間は、ログが収集されるロール、指定された期間、Azure Stack HCI 環境内のノードの数などの要因によって異なります。
  • パラメーターを指定しない場合、コマンドレットは Send-DiagnosticData 以前の 1 時間の間、すべてのノードからデータを収集します。

の構文を次に Send-DiagnosticData示します。

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

Send-DiagnosticDataリファレンス情報については、この記事で後述する Send-DiagnosticData コマンド リファレンス セクションを参照してください。

例とサンプル出力

さまざまなパラメーターで コマンドレットを使用する方法を示すサンプル出力を含むコマンドの例を次に Send-DiagnosticData 示します。

日付フィルター処理診断データを送信する

この例では、過去 2 時間のログ ファイルの日付フィルター処理を使用して、診断データを送信します。

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 します。 パラメーターは 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) 共有に診断ログを格納できます。

ログをローカル共有に保存するには、次の手順に従います。

  1. 次のコマンドを実行して共有を作成します。

    New-SMBShare -Name <share-name> -Path <path-to-share> -FullAccess Users -ChangeAccess 'Server Operators'
    
  2. 次のコマンドを実行して、共有に PSCredentials を作成します。

    $user = "<username>"
    $pass = "<password>"
    $sec=ConvertTo-SecureString -String $pass -AsPlainText -Force
    $shareCredential = New-Object System.Management.Automation.PSCredential ($user, $sec)
    
  3. クラスターの各ノードで次のコマンドを実行してログを収集し、ローカルに保存します。

    Send-DiagnosticData -SaveToPath <path to share> -ShareCredential $shareCredential
    

ログを保存した SMB 共有からの送信接続がある場合は、次のコマンドを実行してログを Microsoft に送信できます。

Send-DiagnosticData NoLogCollection -SupplementaryLogs <path-to-share> -ShareCredentail $shareCredential

サポート ケースで必要な情報を提供する

問題が発生し、Microsoft サポートからの支援が必要な場合は、ログを特定するための特定の情報を求められる場合があります。

この情報は、コマンドレットの出力から取得することも、Send-DiagnosticDataAzure portalの問題のあるページから直接取得することもできます。

出力から情報を提供するSend-DiagnosticData

を使用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: ログを検索する一意の識別子。

問題が発生したAzure portal ページから情報を提供する

Azure portalの問題のあるページで、Ctrl + Alt + A キーを押して、セッション ID と URL の情報を含む診断ファイルをダウンロードします。 ほとんどの場合、この情報はトラブルシューティングMicrosoft サポート開始するのに十分です。

問題が発生している Azure Stack HCI ブレードのいずれかを使用している場合、現在の URI には、サービスのデバッグに必要なリソース ID があります。

Send-DiagnosticData コマンド リファレンス

このセクションでは、パラメーター、構文、使用例など、 に関 Send-DiagnosticDataするリファレンス情報を提供します。

FromDate と ToDate

これらのパラメーターを使用すると、特定の期間のログを収集できます。

構文

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

拡張機能のバージョン

すべて

FilterByRole

このパラメーターを使用すると、収集するロールのログを選択できます。 複数のロールを指定できます。 ログをフィルター処理できる使用可能なロールの一覧については、「ログの フィルター処理に使用できるロール」を参照してください。

構文

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>

、、 などのToDateShareCredentialFilterByRoleFromDateCollectSddcSupplementaryLogs他のパラメーターとBypassObsAgent共に を使用SaveToPathできます。

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

拡張機能のバージョン

バージョン 1.0.2.0 以降

NoLogCollection

NoLogCollection switch パラメーターを使用すると、ログのアドホック セットを Microsoft に送信できます。 このパラメーターを使用する場合は、次の詳細を考慮してください。

  • 、、および のSupplementaryLogsShareCredential各パラメーターを パラメーターとBypassObsAgentNoLogCollection組み合わせることができます。
  • を使用NoLogCollectionする場合、SupplementaryLogsパラメーターは必須です。 Microsoft に送信する必要があるログへのパスを指定します。
  • ホスト SupplementaryLogs 上の共有パスまたは出力パスを パラメーターに渡す柔軟性があります。 マップされていない共有パスを使用している場合は、 パラメーターも使用する -ShareCredential 必要があります。

構文

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

使用例

必須SupplementaryLogsパラメーターで を使用–NoLogCollectionします。

Send-DiagnosticData –NoLogCollection –SupplementaryPath <output path>

マップされていない共有パスで を使用 –NoLogCollection します。

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

拡張機能のバージョン

バージョン 1.0.2.0 以降

補足ログ

補助ログ パラメーターを使用すると、アドホック ログを Microsoft に送信できます。

構文

次の方法で使用できます。

を使用 SaveToPathします。 このシナリオでは、診断ログとアドホック ログの両方が収集され、指定したパスに保存されます。

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

を使用 NoLogCollectionします。 ここでは、アドホック ログのみが収集され、Microsoft に送信されます。 診断ログは収集されません。

Send-DiagnosticData -SupplementaryLogs <string> -NoLogCollection

または NoLogCollectionなしSaveToPath。 つまり、診断ログとアドホック ログの両方が収集され、Microsoft に送信されます。

Send-DiagnosticData [-SupplementaryLogs <string>]

診断ログとアドホック ログの両方を収集する場合は、 パラメーターをSupplementaryLogs、 などのToDateFilterByRoleFromDate他のパラメーターとCollectSddc共に使用できます。

使用例

または NoLogCollectionなしSaveToPath:

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 –SupplemenatryLogs <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 Connected Machine エージェントの概要」を参照してください。
BareMetal 仮想化レイヤーを使用せずにベア メタル サーバーでサービスを実行できるインフラストラクチャ ロール。 オペレーティング システムとハードウェアに対するフル アクセスと制御を持つことができます。
CommonInfra ネットワーク、ストレージ、セキュリティなどの一般的なインフラストラクチャ コンポーネントのログを収集します。
DeploymentLogs 実行された手順、発生したエラー、操作の状態など、デプロイ プロセスの詳細を記録します。
ECE デプロイ、更新、追加ノード、ノード置換などのライフサイクル ワークフローを管理します。
拡張機能 Azure マネージド拡張機能に関連するデータ。
FleetDiagnosticsAgent 正常性トリガーをリッスンしてログ収集を開始します。 これらのログは、FleetDiagnosticsAgent とログ収集に関する問題を診断するために使用されます。
HCICloudService Azure Stack HCI のコア機能を提供する Azure クラウド サービス。 Azure の電源とオンプレミス サーバーの柔軟性が組み合わされています。
DownloadService 更新プログラムのコンテンツをダウンロードするためのインフラストラクチャ サービスの一部。
健康 イベント ログやパフォーマンス カウンターなど、さまざまなソースから正常性、パフォーマンス、使用状況データを収集します。
HostNetwork ホスト ネットワークの構成に使用される基になるオペレーティング システム コンポーネントである Network ATC のトラブルシューティングに使用されるログ。
MOC_ARB Azure Stack HCI および Windows Server 上の仮想マシンのクラウドベースの管理を可能にする管理スタック。
NC ネットワーク インフラストラクチャに関連する情報。
ObservabilityLogmanTraces 監視トレースのログを収集します。 これらのログは、診断データの送信に関する問題のトラブルシューティングに役立ちます。
ObservabilityVolume 監視ボリュームのログを収集します。
OEMDiagnostics OEM 診断のログを収集します。これは、BIOS、ドライバー、センサーなどのサーバー ハードウェアに関する問題を特定して解決するのに役立ちます。
OSUpdateLogs Azure Stack HCI ノード上のオペレーティング システムの更新に関連するログを収集するロール。更新関連の問題のトラブルシューティングに役立ちます。
RemoteSupportAgent カスタマー サポート ケースに対処するために使用されるリモート サポート セッションに関する問題のトラブルシューティングに役立つログ。
TestObservability コマンドレットからログを Test-Observability 収集します。これは、拡張機能が正常に動作していることを TelemetryAndDiagnostics テストするために使用されます。
URP および OsUpdate ECE ロール イベントにUpdateService関連するログで構成されます。 は Update Service 、Azure Stack HCI システムの更新プログラムを管理します。 OsUpdate ECE ロールは、デプロイ中にクラスターの一部ではないマシン (物理ホストと InfraVM) にオペレーティング システムの更新プログラムを取得してインストールし、ノードの追加、ノードの修復、および Infra VM の更新シナリオに使用します。 これら 2 つのコンポーネントからのトレースは、ロールの URP 一部です。

Azure portalのWindows Admin Centerを使用してオンデマンド ログ収集を実行する

Diagnostics Azure portalの Windows Admin Center 内の拡張機能を使用すると、オンデマンドのログ収集を実行し、Microsoft とログを共有できます。

Azure portalのWindows Admin Centerを使用してオンデマンド ログ収集を実行するには、次の手順に従います。

  1. Azure portalのWindows Admin Centerに接続します。 詳細については、「Azure でWindows Admin Centerを使用して Azure Stack HCI クラスターを管理する」を参照してください。

  2. 左側のウィンドウの [ 拡張機能] で、[ 診断] を選択します。

  3. [診断] ページ [ ログ アクティビティ ] で、ログ収集履歴を確認するか、行を選択して特定のログ 収集に関する詳細を表示します。

  4. [ 手動で送信] を選択します。 右側のコンテキスト ウィンドウで、ログの開始時刻と終了時刻を入力し、[ログの 収集] & [アップロード ログ] を選択します。

    オンデマンド ログ収集の [手動で送信] ボタンを示す [診断] ページのスクリーンショット。

次の手順