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) 共有に診断ログを格納できます。
ログをローカル共有に保存するには、次の手順に従います。
次のコマンドを実行して共有を作成します。
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
サポート ケースで必要な情報を提供する
問題が発生し、Microsoft サポートからの支援が必要な場合は、ログを特定するための特定の情報を求められる場合があります。
この情報は、コマンドレットの出力から取得することも、Send-DiagnosticData
Azure 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>
、、 などのToDate
ShareCredential
FilterByRole
FromDate
CollectSddc
SupplementaryLogs
他のパラメーターとBypassObsAgent
共に を使用SaveToPath
できます。
Send-DiagnosticData –SaveToPath <output path> -FIlterByRole <role>
拡張機能のバージョン
バージョン 1.0.2.0 以降
NoLogCollection
NoLogCollection
switch パラメーターを使用すると、ログのアドホック セットを Microsoft に送信できます。 このパラメーターを使用する場合は、次の詳細を考慮してください。
- 、、および の
SupplementaryLogs
ShareCredential
各パラメーターを パラメーターとBypassObsAgent
NoLogCollection
組み合わせることができます。 - を使用
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
、 などのToDate
FilterByRole
FromDate
他のパラメーターと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を使用してオンデマンド ログ収集を実行するには、次の手順に従います。
Azure portalのWindows Admin Centerに接続します。 詳細については、「Azure でWindows Admin Centerを使用して Azure Stack HCI クラスターを管理する」を参照してください。
左側のウィンドウの [ 拡張機能] で、[ 診断] を選択します。
[診断] ページ の [ ログ アクティビティ ] で、ログ収集履歴を確認するか、行を選択して特定のログ 収集に関する詳細を表示します。
[ 手動で送信] を選択します。 右側のコンテキスト ウィンドウで、ログの開始時刻と終了時刻を入力し、[ログの 収集] & [アップロード ログ] を選択します。