Usar o AGDiag para diagnosticar eventos de integridade do grupo de disponibilidade

O AGDiag é um aplicativo que automatiza a análise manual de logs de cluster e correlaciona e relata eventos pertinentes de outros logs (logs de erros do SQL Server, logs de eventos do Windows e assim por diante). O AGDiag gera um relatório resumido dos eventos de integridade do Cluster do Windows e do Always On, e fornece resultados de análise mais detalhados para cada evento de integridade detectado. Ele também automatiza grande parte do seu trabalho quando você fornece os logs apropriados da réplica primária do grupo de disponibilidade no momento do evento de saúde.

Gerar logs para diagnóstico pelo AGDiag

Você pode usar vários métodos para gerar os logs que o AGDiag usa como entradas. O AGDiag depende dos seguintes logs base para fazer a análise:

• Logs de diagnóstico de cluster do Windows
• Logs de erros do SQL Server
• Logs de eventos do sistema windows
• Arquivos XEL (Eventos Estendidos de Saúde do Sistema)
• Arquivos XEL da Sessão de Saúde AlwaysOn

Como um método alternativo para coletar manualmente esses logs, você pode usar qualquer uma das seguintes ferramentas de coleta de logs para capturá-los:

• LogScout
• TSS

Usar o LOGScout do SQL para capturar logs para análise do AGDiag

Para diagnosticar um evento relacionado à saúde do grupo de disponibilidade, use o SQL LogScout para coletar logs na instância do SQL Server que estava no papel primário no momento do evento.

1. Baixe o mais recente SQL LogScout como um arquivo .zip.

2. Salve e extraia o arquivo .zip no computador no qual o SQL Server hospeda a réplica primária. Esse sistema é onde o failover foi iniciado ou o grupo de disponibilidade estava sendo resolvido.

3. Abra uma janela de console do PowerShell com privilégios de administrador e altere o diretório para a pasta SQL LogScout na qual você extraiu o arquivo .zip.

4. Execute o comando a seguir para capturar o Basic cenário e siga as instruções.

   .\SQL_LogScout.ps1 -Scenario "Basic" -ServerName "<Your_Sql_Instance_Name>"
   

   

5. Quando o processo de captura de log for concluído, você poderá apontar o AGDiag para a \output pasta que foi criada dentro da pasta LogScout do SQL. Esta pasta contém os logs coletados pelo LOGScout do SQL.

Usar o TSS para gerar logs para o AGDiag diagnosticar

Como alternativa, você pode capturar os logs usando o TSS na instância do SQL Server que estava na função primária no momento do evento:

1. Baixe o conjunto de ferramentas (TSSv2.zip) como um arquivo .zip. Para obter mais informações, consulte Introdução ao conjunto de ferramentas TroubleShootingScript (TSSv2).

2. Salve e extraia o arquivo .zip para uma pasta na instância do SQL Server que hospedava a réplica primária do grupo de disponibilidade quando o failover foi iniciado ou o grupo de disponibilidade estava sendo resolvido.

3. Abra uma janela do Prompt de Comando com privilégios elevados, altere o diretório para a pasta TSS em que você salvou e extraiu o arquivo TSSv2.zip , execute TSS SDP:SQLBasee responda aos prompts.

   

4. Depois que o TSS criar o arquivo .cab do SQLBase, extraia o arquivo .cab em uma pasta.

   

Baixe a ferramenta AGDiag

Para baixar o AGDiag, siga estas etapas:

1. Versão aberta AGDiag Windows Release outubro de 2021 (assinado).

2. Selecione o link agdiag.zip para baixar a ferramenta.

   

Inicie o AGDiag e alimente-o com os logs de TSS descompactados

Depois de baixar a ferramenta, siga estas etapas para iniciar o AGDiag e fornecer a ele os logs TSS descompactados:

1. Extraia o arquivo .zip e clique duas vezes agdiag.exe para iniciar o AGDiag.

   Uma caixa de diálogo semelhante à caixa a seguir é exibida.

   

2. Selecione Pasta de Log, acesse a pasta na qual você extraiu os arquivos .cab do SQLBase do TSS e então selecione OK.

Interpretar o relatório AGDiag

O navegador do sistema padrão abre o relatório AGDiag. As ilustrações a seguir ajudam você a interpretar o relatório:

• A tela inicial do AGDiag a seguir descreve as informações de versão e funcionalidades do AGDiag.

  

• O AGDiag relata nos logs que analisa na seção de inicialização. Para ver informações mais detalhadas, selecione os triângulos (realçados em caixas vermelhas na imagem a seguir).

  

• O relatório de resumo lista os eventos de integridade do grupo de disponibilidade do log do cluster. Para acessar o relatório detalhado de um evento de saúde específico, selecione o link numérico (destacado na caixa vermelha na imagem a seguir).

  

• Existe um relatório detalhado para cada evento de saúde detectado. Este relatório inclui descobertas de log que se correlacionam com o evento de saúde, o diagnóstico e as recomendações. Para ver informações mais detalhadas, selecione os triângulos (realçados em caixas vermelhas na imagem a seguir).

  

Problemas conhecidos no AGDiag

Para obter as informações mais recentes sobre problemas documentados e possíveis soluções, consulte Problemas Conhecidos com o AGDiag.