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: