Compartilhar via


Usar a Ferramenta de Diagnóstico de Suporte para solucionar problemas do Azure Local

Aplica-se a: Azure Local 2311.2 e posterior

Este artigo fornece informações para baixar e usar a Ferramenta de Diagnóstico de Suporte Local do Azure. A ferramenta é um conjunto de comandos do PowerShell para simplificar a coleta de dados, a solução de problemas e a resolução de problemas comuns.

Esta ferramenta não substitui o conhecimento especializado. Se você encontrar algum problema, entre em contato com o Suporte da Microsoft para obter assistência.

Benefícios

A Ferramenta de Diagnóstico de Suporte Local do Azure usa comandos simples para identificar problemas sem conhecimento especializado do produto.

A ferramenta fornece:

  • Fácil instalação e atualizações: instale e atualize nativamente usando a Galeria do PowerShell, sem requisitos extras.

  • Verificações de diagnóstico: fornece verificações de diagnóstico com base em problemas comuns, incidentes e dados de telemetria.

  • Coleta automática de dados: coleta automaticamente dados importantes para fornecer ao Suporte da Microsoft.

  • Atualizações regulares: atualizações com novas verificações e comandos úteis para gerenciar, solucionar problemas e diagnosticar problemas no Azure Local.

Pré-requisitos

Antes de usar o módulo do PowerShell, certifique-se de:

  • Baixe a Ferramenta de Diagnóstico de Suporte Local do Azure na Galeria do PowerShell.

  • Importe o módulo para uma janela do PowerShell com privilégios elevados usando uma conta com privilégios de administrador no sistema local. Para obter mais informações, confira Importar um módulo do PowerShell.

  • Instale o módulo em cada nó do sistema local do Azure. Para obter informações sobre como se conectar a um nó, consulte Ativar RDP.

Instalar e usar a Ferramenta de Diagnóstico de Suporte Local do Azure

Execute o PowerShell como administrador e execute os seguintes comandos:

Para instalar a ferramenta, execute o seguinte comando:

Install-Module –Name Microsoft.AzureStack.HCI.CSSTools

Para listar todas as verificações de diagnóstico disponíveis, execute o seguinte comando:

Invoke-AzsSupportDiagnosticCheck –ProductName <BaseSystem, Registration>

Execute todas as verificações de diagnóstico pressionando CTRL+SPACE após o parâmetro ProductName.

Para coletar dados usando um de nossos conjuntos de coleta predefinidos, execute o seguinte comando:

New-AzsSupportDataBundle –Component <Component>

Para verificar todos os conjuntos de coleta de dados, pressione CTRL+SPACE após o parâmetro Component.

Para coletar seu próprio conjunto de dados, execute o seguinte comando:

$ClusterCommands = @(<clusterCommand1>,<clusterCommand2>)
$nodeCommands = @(<nodeCommand1>,<nodeCommand2>)
$nodeEvents = @(<eventLogName1>,<eventLogName2>)
$nodeRegistry = @(<registryPath1>,<registryPath2>)
$nodeFolders = @(<folderPath1>,<folderPath2>)


New-AzsSupportDataBundle -ClusterCommands $clusterCommands `
-NodeCommands $nodeCommands `
-NodeEvents $nodeEvents `
-NodeRegistry $nodeRegistry `
-NodeFolders $nodeFolders `
-ComputerName @(<computerName1>,<computerName2>)

Cenário de exemplo

Para solucionar problemas do Azure Local, execute os seguintes comandos:

Para problemas de implantação

Para gerar um relatório detalhado sobre sua implantação, incluindo etapas executadas com êxito, etapas ignoradas e detalhes de erro, execute o seguinte comando:

Get-AzsSupportEceDeploymentDetails

Para problemas de atualização ou upgrade

Get-AzsSupportEceUpdateDetails

Para problemas de registro

Invoke-AzsSupportDiagnosticCheck -ProductName Registration

Aqui está um exemplo de saída para um problema de registro:

PS C:\temp> Invoke-AzsSupportDiagnosticCheck -ProductName Registration
Starting known issue check for Azure Stack HCI: Registration.                                                                                                       
Starting Azure Stack HCI base system validation.                                                                                                                        
Gathering information from all clustered nodes.                                                                                                                         
We are preparing to collect diagnostic information from your environment                                                                                                
We started the diagnostic data collection! This might take some time.                                                                                                   
Finished collecting diagnostic information.                                                                                                                             
====[ Validating registration state on node: HCI-N-1 ]====                                                                                                              
[Pass] [Azure Stack HCI - General registration state]                                                                                                                   
Validate that the cluster is registered
Details: Validation successfull

[Fail] [Azure Stack HCI - Azure Connection state]
Validate that the cluster is in a connected state
Details: This Azure Stack HCI node does not seem to be connected to azure. Ensure that this node is in a connected state.
Documentation: https://learn.microsoft.com/en-us/azure-stack/hci/deploy/troubleshoot-hci-registration.

[Pass] [Azure Arc Agent - Connection state]
Validate that the azure arc agent is connected
Details: Validation successfull

[Pass] [Azure Arc Agent - Service state]
Validate that all azure arc services are running
Details: Validation successfull

[Pass] [Azure Arc Agent - Heartbeat state]
Validate that the azure arc agent has sent out a heartbeat at least a day ago
Details: Validation successfull

[Pass] [Azure Stack HCI - Arc Agent onboarded]
Validate that all arc agent checks are passed
Details: Validation successfull

[Fail] [Validation summary]

Details: At least one node reported an invalid registration state.

We will collect log information from your envirorment.
Creating local storage container for diagnostic data.
Gathering cluster data ... this might take a while.
Cluster data collection complete.
We are preparing to collect diagnostic information from your environment
We started the diagnostic data collection! This might take some time.
Waiting for all diagnostic output to be generated and compressed ... this might take a while.
Finished collecting diagnostic information.
Starting copy of items ... this might take a while.
All items copied.
Successfully created archive C:\temp\6c5a4685-6e32-4b68-aeec-05475f8d6c6f\log-collection-RegistrationInformation07-22_06-03-2024.zip. Removing raw data C:\temp\6c5a4685-6e32-4b68-aeec-05475f8d6c6f\container.
Data collection done . Please upload the file to the Microsoft Workspace.

Para problemas básicos do sistema local do Azure

Invoke-AzsSupportDiagnosticCheck -ProductName BaseSystem

Aqui está um exemplo da saída para problemas do sistema básico:

PS C:\temp> Invoke-AzsSupportDiagnosticCheck -ProductName BaseSystem
Starting known issue check for Azure Stack HCI: BaseSystem.
Gathering information from all clustered nodes.
We are preparing to collect diagnostic information from your environment
We started the diagnostic data collection! This might take some time.
Starting to validate cluster settings.
[Pass] [Failover Clustering - Cluster validation report contains no errors]
Validate that there are no critical errors in the cluster validation report
Details: Validation successfull

[Pass] [Failover Clustering - Cluster Networks have redundancy]
Validate that we have redundancy in clustered networks
Details: Validation successfull

[Pass] [Failover Clustering - Validation Summary]
Validate that there are no critical issues in our cluster validation report.
Details: Validation successfull

Collecting node data.
Finished collecting diagnostic information.
====[ Validating data from node: HCI-N-1 ]====
[Pass] [Windows Features - All windows features installed]
Verify that all features required for Azure Local are installed.
Details: Validation successfull

[Pass] [Validation summary]
Ensure that no other check has returned a failed state
Details: Validation successfull

Em seguida, é criada uma visão geral abrangente dos diferentes componentes necessários para sistemas locais do Azure conectados corretamente. Com base nessa visão geral, você pode seguir as diretrizes de solução de problemas ou entrar em contato com o Suporte da Microsoft para obter assistência.

Para coletar dados, consulte os dois cenários de exemplo a seguir:

Para coleta automática de dados

New-AzsSupportDataBundle -Component OS
==== CUT ==================== CUT =======
Data collection done C:\temp\Azs.Support\XXXXXXX\SupportDataBundle-XX-XX_XX-XX-XXXX.zip . Please upload the file to the Microsoft Workspace

Para coleta manual de dados

$ClusterCommands = @()
$nodeCommands = @('Get-AzureStackHci','Get-AzureStackHCIArcIntegration','Get-ClusteredScheduledTask | fl *','systeminfo.exe')
$nodeEvents = @('system','application','Microsoft-AzureStack-HCI/Admin')
$nodeRegistry = @('HKLM:\Cluster\ArcForServers')
$nodeFolders = @('C:\Windows\Tasks\ArcforServers\','C:\ProgramData\AzureConnectedMachineAgent\Log\')

New-AzsSupportDataBundle -ClusterCommands $clusterCommands `
-NodeCommands $nodeCommands `
-NodeEvents $nodeEvents `
-NodeRegistry $nodeRegistry `
-NodeFolders $nodeFolders `
-ComputerName (Get-ClusterNode)

==== CUT ==================== CUT =======
Data collection done C:\temp\Azs.Support\XXXXXXX\SupportDataBundle-XX-XX_XX-XX-XXXX.zip . Please upload the file to the Microsoft Workspace.

Perguntas ou comentários?

Você tem um problema? Gostaria de compartilhar comentários conosco sobre a Ferramenta de Diagnóstico de Suporte Local do Azure? Nós ouvimos! Para enviar comentários, use a opção "entrar em contato com os proprietários" dentro do PSGallery.

Próximas etapas

Para informações relacionadas, confira também: