Estratégias de coleta de dados para solucionar problemas comuns relacionados ao servidor Web do IIS no Windows Server

O servidor Web do IIS permite aos administradores, proprietários de sites e proprietários de aplicativos Web um rico conjunto de possibilidades para gerar telemetria e métricas sobre o desempenho dos aplicativos Web hospedados: desde os logs de solicitação do IIS até o rastreamento de log de solicitações com falha, entradas do visualizador de eventos e muito mais. Essas partes de telemetria podem ser espalhadas em vários locais no Windows Server que está executando o IIS e coletar todas elas quando a solução de problemas pode ser demorada, especialmente se o número de aplicativos hospedados for grande. A equipe de suporte do IIS construiu uma ferramenta para ajudar nessa tarefa específica: o LogCather é uma ferramenta que permite a coleta de dados relacionados à telemetria e configuração do IIS em um local centralizado, permitindo que os administradores direcionem todo o servidor ou apenas um subconjunto dos aplicativos hospedados e definam um período de tempo para o qual os dados serão coletados.

Sintomas

Os problemas de conexão ocorrem quando você executa o ASP.NET, o ASP.NET Core ou outros tipos de sites e aplicativos Web em um servidor Web do IIS em execução no Windows Server.

Observação

As versões atualmente com suporte do Windows Server são Windows Server 2019, Windows Server 2016, Windows Server 2012 R2 e Windows Server 2012.

Este artigo descreve estratégias de coleta de dados para solucionar problemas comuns relacionados ao servidor Web do IIS.

Problemas de certificado do servidor SSL e SSL

Quando você se conecta a um site hospedado no IIS por meio de HTTPS, o servidor e o cliente (navegador da Web) negociam uma conexão TLS (Transport Layer Security) entre eles.

Observação

TLS é a versão atualizada da tecnologia Secure Sockets Layer (SSL), embora "SSL" continue sendo o termo mais comum para certificados de segurança.

Durante a negociação, o IIS fornece um certificado de servidor para o cliente de conexão. O certificado retornado pode não ser o certificado esperado e pode não ser confiável para o cliente. Isso impede que o cliente seja capaz de concluir a conexão com o servidor Web por meio do TLS.

Exceções e erros de tempo de execução, incluindo códigos de status HTTP 4xx e 5xx

Quando você acessa determinados recursos em aplicativos Web hospedados no IIS ou executa determinadas ações enquanto navega nesses sites, os aplicativos Web ou sites do IIS geram erros de forma aleatória ou consistente. Você pode receber mensagens de erro de código de status "500" (erro "servidor interno") que relatam várias exceções de erro na execução do código do lado do servidor para o site. Você também pode receber mensagens de erro de código de status "400" ("solicitação incorreta") que são retornadas quando você acessa serviços Web, como ASP.NET API Web, e está tentando enviar dados para um ponto de extremidade de serviço Web. Prompts de autenticação inesperados ou solicitações de "acesso negado" representadas pelos códigos de status "401" e "403" também podem ocorrer.

Problemas de mapeamento de manipulador

As solicitações enviadas ao servidor Web são mapeadas para um manipulador específico (por exemplo: manipulador .NET gerenciado) e são registradas usando um aplicativo Web implantado no servidor. O manipulador processa as solicitações e retorna uma resposta HTTP. Algumas solicitações podem ser roteadas para o manipulador inesperado. Por exemplo, as solicitações acabam sendo executadas pelo manipulador incorreto (como o manipulador de Arquivo Estático) e isso aciona um código de status 403.14 ("uma solicitação de listagem de diretório não é permitida").

Problema de redirecionamento HTTP

Um site ou aplicativo Web não redireciona os usuários que estão acessando o site por meio de uma conexão não segura para um canal criptografado (por TLS). Ou os redirecionamentos de determinadas solicitações ou recursos para URLs mais recentes não retornam o conteúdo esperado. Esse problema ocorre porque o cliente é constantemente redirecionado entre duas páginas até que o navegador exiba uma mensagem de erro ou porque o cliente foi redirecionado incorretamente pelo servidor IIS.

Erros no console de gerenciamento do IIS

Ao acessar as configurações do site ou do aplicativo Web por meio do console do Gerenciador do IIS, você recebe mensagens de erro que indicam uma configuração incorreta ou inválida. Você não pode acessar determinadas partes da configuração do site (por exemplo: configurações de autenticação, módulos registrados ou manipuladores). Além disso, o Gerenciador do IIS para de responder quando você tenta iniciá-lo ou quando tenta se conectar a um site específico.

Extensões, ferramentas e problemas de suplemento do IIS

Quando você adiciona uma extensão do IIS, como ARR (Solicitação e Roteamento de Aplicativo), a um servidor Web para converter seu servidor Web em um balanceador de carga ou proxy reverso, as solicitações enviadas ao servidor que está executando o IIS causam um comportamento inesperado. Por exemplo, um código de status "500" ou "400" é retornado ou as respostas contêm conteúdo incorreto.

Problemas de serviço do FTP

O serviço FTP é uma parte importante do servidor Web do IIS. Ele permite que os usuários carreguem ou baixem arquivos grandes por meio de conexões FTP (protocolo de transferência de arquivos) ou conexões FTPS (seguras). Ao usar um servidor FTP para IIS para listar, baixar ou carregar arquivos, você recebe códigos de status "5xx" (por exemplo: um código de status "550" do FTP que indica que um comando específico que foi enviado ao servidor não foi executado).

Problemas de configuração de farm de servidores

Quando você executa um aplicativo Web ou um site em um farm que consiste em vários serviços do IIS, ocorrem problemas quando as solicitações subsequentes do mesmo usuário (cliente) são roteadas para servidores diferentes do farm de servidores. Esses erros variam de solicitações que são rejeitadas e geram códigos de status "4xx" a erros de servidor, como os códigos de status "5xx". Esses erros podem ser causados por inconsistências na configuração dos servidores no farm.

Solução

Ao relatar esses tipos de problemas ao Suporte da Microsoft, você deve fornecer todos os dados de telemetria necessários para diagnosticar o problema. Se ocorrer um problema em um servidor de produção, uma estratégia de coleta de dados completa e oportuna permitirá um tempo de resolução mais rápido. Use a ferramenta Microsoft LogCatcher para coleta automatizada de dados para coleta de dados de telemetria mais rápida e consistente de todos os dados necessários do servidor Web. Os agentes de Suporte da Microsoft solicitarão que você baixe a ferramenta de seu repositório GitHub () e instale-a.

A tela de boas-vindas no LogCatcher fornece instruções para seu uso. A interface do usuário é semelhante à captura de tela a seguir.

Na parte inferior da janela principal, o LogCatcher exibe uma lista de sites hospedados no servidor em que a ferramenta está sendo executada e também os pools de aplicativos correspondentes e o local do conteúdo de cada site.

Para filtrar os dados coletados do seu sistema, colete dados de apenas um subconjunto de sites da lista e apenas por um determinado período (expresso em número de dias contados para trás a partir de hoje). Você pode usar as caixas de texto de filtro IDs de site e Idade de logs, respectivamente.

Determine os filtros que você deseja aplicar, a quais sites aplicá-los e durante qual período de tempo os dados devem ser coletados. Em seguida, pressione o botão GERAR ZIP e inicie o processo de coleta de logs. A barra de status fica verde quando a coleta de dados é concluída para confirmar que todos os logs necessários foram coletados e compactados em um arquivo .zip. A barra de status também fornece o local do arquivo.

O Explorador de Arquivos do Windows abre automaticamente a pasta onde o arquivo de log compactado foi salvo.

O LogCatcher coleta as seguintes informações:

• Os arquivos de configuração do IIS (localizados em C:\WINDOWS\system32\inetsrv\config)
• Os logs HTTP.sys (localizados em C:\Windows\System32\LogFiles\HTTPERR)
• Os logs de eventos Sistema, Aplicativo, Segurança, Instalação, Configuração do Microsoft-IIS e CAPI2.
• Os arquivos de log do IIS para os sites selecionados.
• A solicitação com falha é rastreada para os sites selecionados.

O LogCatcher não carrega automaticamente nenhum dos arquivos compactados gerados para os servidores da Microsoft. A ferramenta apenas automatiza a coleta de dados. Você pode inspecionar o conteúdo do arquivo .zip gerado pela ferramenta para ver quais dados foram coletados ou carregar o arquivo na Microsoft para análise.

Se você precisar coletar logs de vários servidores e não quiser clicar na interface do usuário de geração de dados todas as vezes, ou se estiver mais confortável usando a linha de comando, execute a ferramenta diretamente do PowerShell. Para obter mais informações sobre como fazer isso, execute o comando Get-Help .

Veja a seguir exemplos de como executar a ferramenta na CLI do PowerShell, incluindo possíveis parâmetros.

-------------------------- EXAMPLE 1 --------------------------
PS C:\>     .\LogCatcher.ps1

Esse comando inicia o LogCatcher com a interface do usuário.

-------------------------- EXAMPLE 2 --------------------------
PS C:\> .\LogCatcher.ps1 -Quiet $true -ZipLocation "C:\Temp"

Esse comando inicia o LogCatcher com a CLI e define um local de .zip personalizado para a geração de arquivos.

-------------------------- EXAMPLE 3 --------------------------
PS C:\> .\LogCatcher.ps1 -Quiet $true -LogAge 45 -SiteIds "1,2,3,4"

Esse comando indica a idade máxima de todos os logs a serem coletados e os identificadores do IIS para cada site para o qual os logs devem ser coletados.

Mais informações

Para obter mais informações sobre a ferramenta LogCatcher, consulte este artigo do blog do LogCatcher.