Usar a ferramenta de Diagnóstico de Suporte do Azure Stack HCI para solucionar problemas
Aplica-se a: Azure Stack HCI, versão 22H2
Este artigo fornece informações sobre a Ferramenta de Diagnóstico de Suporte do Azure Stack HCI que ajuda você a solucionar problemas complexos no Azure Stack HCI. A ferramenta consiste em um conjunto de comandos do PowerShell que simplificam a coleta de dados, a solução de problemas e a resolução de problemas comuns no Azure Stack HCI.
Observação
No momento, essa ferramenta só está disponível para o Azure Stack HCI, versão 22H2.
Essa ferramenta foi projetada para simplificar o processo de suporte e solução de problemas e não substitui o conhecimento especializado. Se você encontrar problemas, recomendamos que entre em contato com Suporte da Microsoft para obter assistência.
Benefícios
A Ferramenta de Diagnóstico de Suporte do Azure Stack HCI simplifica o processo de suporte e solução de problemas, fornecendo comandos simples que não exigem nenhum conhecimento do produto subjacente. Isso significa que você pode rapidamente obter uma primeira olhada no que pode estar causando um problema, sem precisar ser um especialista no produto.
Atualmente, a ferramenta oferece os seguintes recursos:
Instalação e atualizações fáceis: pode ser instalado e atualizado nativamente usando Galeria do PowerShell, sem nenhum requisito adicional.
Verificações de diagnóstico: oferece verificações de diagnóstico com base em problemas comuns, incidentes e dados de telemetria.
Coleta automática de dados: coleta automaticamente dados importantes caso deseje entrar em contato com o Suporte ao Cliente da Microsoft.
Atualizações regulares: é atualizado regularmente com novas verificações e comandos úteis para gerenciar, solucionar problemas e diagnosticar problemas no Azure Stack HCI.
Pré-requisitos
Os seguintes pré-requisitos devem ser concluídos para garantir que o módulo do PowerShell seja executado corretamente:
Baixe a ferramenta diagnóstico de suporte do Azure Stack HCI no Galeria do PowerShell.
Importe o módulo para uma janela elevada do PowerShell por uma conta com privilégios de administrador no sistema local.
Instale o módulo em cada nó do sistema Azure Stack HCI.
Instalar e usar a ferramenta
Para instalar a ferramenta, execute o seguinte comando no PowerShell:
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>
Você pode marcar todas as verificações de diagnóstico pressionando CTRL+SPACE após o parâmetro ProductName.
Cenário de exemplo
Para solucionar problemas de produtos principais do Azure Stack HCI, por exemplo, você pode executar o seguinte cmdlet:
Para problemas de registro
Invoke-AzsSupportDiagnosticCheck -ProductName Registration
Aqui está um exemplo da saída para o 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 Azure Stack HCI
Invoke-AzsSupportDiagnosticCheck -ProductName BaseSystem
Aqui está um exemplo da saída para problemas do sistema base:
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 Stack HCI are installed.
Details: Validation successfull
[Pass] [Validation summary]
Ensure that no other check has returned a failed state
Details: Validation successfull
Posteriormente, uma visão geral abrangente dos diferentes componentes necessários para sistemas do Azure Stack HCI conectados corretamente é criada. Com base nessa visão geral, você pode seguir as diretrizes de solução de problemas ou entrar em contato com Suporte da Microsoft para obter mais assistência.
Próximas etapas
Para informações relacionadas, confira também: