Configurar diagnóstico para máquinas virtuais e Serviços de Nuvem do Azure (suporte estendido)

Observação

Este artigo se aplica aos Serviços de Nuvem do Azure (suporte estendido). Os Serviços de Nuvem (clássico) serão desativados em 31 de agosto de 2024. Para obter mais informações, consulte O modelo de implantação dos Serviços de Nuvem (clássico) será desativado em 31 de agosto de 2024. Para novos desenvolvimentos, é recomendável usar um tipo de serviço mais recente projetado para sua finalidade específica, como o Serviço de Aplicativo do Azure, o Azure Functions ou os Aplicativos de Contêiner do Azure. Para obter a lista mais recente de serviços disponíveis, confira Diretório de produtos do Azure.

Quando você precisar solucionar problemas de uma máquina virtual ou de Serviços de Nuvem do Azure (suporte estendido), pode usar o Visual Studio para configurar o Diagnóstico do Azure com mais facilidade. O diagnóstico captura dados do sistema e dados de log em máquinas virtuais e instâncias de máquinas virtuais que executam o serviço de nuvem. Dados de diagnóstico são transferidos para uma conta de armazenamento que você escolhe. Para obter mais informações sobre o registro em log de diagnóstico no Azure, consulte Habilitar o registro em log de diagnóstico para aplicativos Web no Serviço de Aplicativo do Azure.

Neste artigo, mostramos como ativar e configurar o Diagnóstico do Azure usando o Visual Studio. Saiba como configurar o Diagnóstico em Máquinas Virtuais do Azure, como selecionar os tipos de informações de diagnóstico a coletar e como exibir as informações depois de coletadas.

Para configurar o Diagnóstico do Azure, altere as configurações de diagnóstico na caixa de diálogo Configuração de Diagnóstico no Visual Studio. As configurações serão salvas em um arquivo chamado diagnostics.wadcfgx. Você também pode alterar diretamente o arquivo de configuração. Se você atualizar manualmente o arquivo, as alterações de configuração entrarão em vigor na próxima vez que você implantar o serviço de nuvem no Azure ou executar o serviço no emulador.

Aviso

No Visual Studio 2022, o Emulator do Armazenamento do Azure preterido foi substituído pelo emulador do Azurite ao depurar seus projetos do serviço de nuvem. Esse emulador do Azurite não funciona com o plug-in Diagnóstico do Azure, que fornece suporte para o Diagnóstico do Azure ao executar e testar localmente. Se precisar do plug-in para execução local e cenários de teste, você poderá atualizar a cadeia de conexão na configuração do serviço local (.cscfg) para uma conta de Armazenamento do Azure (confira Gerenciar cadeias de conexão para contas de armazenamento) ou baixar o emulador de Armazenamento do Azure anterior. Na versão do Visual Studio 17.10, o plug-in local do Diagnóstico do Azure está sendo preterido e desabilitado por padrão, com a opção de habilitação nessa versão. O plug-in foi removido no Visual Studio 17.11. Esse plug-in foi usado somente com o emulador de Computação do Azure local e a desabilitação não afeta os Serviços de Nuvem implantados que usam a extensão de Diagnóstico do Azure no Azure. Para habilitar o plug-in de diagnóstico no Visual Studio 17.10, adicione esta configuração de propriedade para qualquer PropertyGroup no arquivo de projeto: <EnableEmulatorDiagnosticsPlugin>True</EnableEmulatorDiagnosticsPlugin>.

Como o Visual Studio determina a conta de armazenamento de diagnóstico

• Se uma cadeia de conexão de diagnóstico for especificada no arquivo .cscfg, o Visual Studio a usará para configurar a extensão de diagnóstico ao publicar e gerar os arquivos XML de configuração pública durante o empacotamento.
• Se uma cadeia de conexão de diagnóstico não for especificada no arquivo .cscfg, o Visual Studio voltará a usar a conta de armazenamento especificada no arquivo .wadcfgx para configurar a extensão de diagnóstico durante a publicação e para o gerar os arquivos XML de configuração pública durante o empacotamento.
• A cadeia de conexão de diagnóstico no arquivo .cscfg tem precedência sobre a conta de armazenamento no arquivo .wadcfgx. Se uma cadeia de conexão de diagnóstico for especificada no arquivo .cscfg, o Visual Studio usará essa cadeia de conexão e ignorará a conta de armazenamento em .wadcfgx.

O que faz a caixa de seleção "Atualizar cadeias de conexão do armazenamento de desenvolvimento…"?

A caixa de seleção Atualizar cadeias de conexão do armazenamento de desenvolvimento para Diagnóstico e Cache com credenciais de conta de armazenamento do Microsoft Azure ao publicar no Microsoft Azure oferece uma maneira conveniente de atualizar qualquer cadeia de conexão de conta de armazenamento de desenvolvimento com a conta de Armazenamento do Azure especificada durante a publicação. Quando você publica o projeto no Azure, o Visual Studio atualiza automaticamente a cadeia de conexão de diagnóstico com a conta de armazenamento que você especificou no assistente de publicação. No entanto, se uma conta de armazenamento real tiver sido especificada como a cadeia de conexão de diagnóstico, essa conta será usada.

Configurar fontes de dados de diagnóstico

Após habilitar a coleção de dados de diagnóstico, você pode escolher exatamente quais fontes de dados que deseja coletar e quais informações são coletadas. As próximas seções descrevem as guias na caixa de diálogo Configuração de Diagnóstico e o que significa cada opção de configuração significa.

Logs de aplicativo

Logs de aplicativo têm informações de diagnóstico que são geradas por um aplicativo Web. Se você quiser coletar logs de aplicativo, selecione a caixa de seleção Habilitar transferência dos logs de aplicativo . Para aumentar ou diminuir o intervalo entre a transferência de logs de aplicativo para sua conta de armazenamento, altere o valor do Período de Transferência (min). Você pode também alterar a quantidade de informações capturadas no log definindo o valor de Nível de log. Por exemplo, selecione Detalhado para obter mais informações ou selecione Crítico para capturar somente erros críticos. Se você tiver um provedor de diagnósticos específico que emita os logs de aplicativo, poderá capturar os logs adicionando o GUID do provedor na caixa GUID do Provedor.

Para obter mais informações sobre logs de aplicativo, consulte Habilitar o registro em log de diagnóstico para aplicativos Web no Serviço de Aplicativo do Azure.

Logs de eventos do Windows

Para capturar logs de evento do Windows, marque a caixa de seleção Habilitar transferência dos logs de evento do Windows. Para aumentar ou diminuir o intervalo entre a transferência de logs de evento para sua conta de armazenamento, altere o valor do Período de Transferência (min). Selecione as caixas de seleção para os tipos de eventos que você deseja controlar.

Se você quiser especificar uma fonte de dados personalizada, insira-a na caixa de texto <Nome da fonte de dados> e selecione Adicionar. A fonte de dados é adicionada ao arquivo diagnostics.cfcfg.

Contadores de desempenho

As informações do contador de desempenho podem ajudá-lo a localizar gargalos do sistema e ajustar o sistema e desempenho do aplicativo. Para obter mais informações, consulte Criar e usar contadores de desempenho em um aplicativo do Azure. Para capturar contadores de desempenho, marque a caixa de seleção Habilitar a transferência de contadores de desempenho. Para aumentar ou diminuir o intervalo entre a transferência de logs de evento para sua conta de armazenamento, altere o valor do Período de Transferência (min). Selecione as caixas de seleção para os contadores de desempenho que você deseja controlar.

Para rastrear um contador de desempenho que não esteja listado, insira o contador de desempenho usando a sintaxe sugerida. Então selecione Adicionar. O sistema operacional na máquina virtual determina quais contadores de desempenho você pode acompanhar. Para obter mais informações sobre sintaxe, consulte Especificar um caminho de contador.

Logs de infraestrutura

Logs de infraestrutura têm informações sobre a infraestrutura de diagnóstico do Azure, o módulo RemoteAccess e o módulo RemoteForwarder. Para coletar informações sobre logs de infraestrutura, marque a caixa de seleção Habilitar transferência de Logs de Infraestrutura. Para aumentar ou diminuir o intervalo entre a transferência de logs de infraestrutura para sua conta de armazenamento, altere o valor do Período de Transferência (min).

Para saber mais, consulte Coletar dados do log usando o Diagnóstico do Azure.

Diretórios de log

Diretórios de log têm dados coletados de diretórios de log para solicitações de IIS (Serviços de Informações da Internet), solicitações com falha ou pastas que você escolher. Para capturar os diretórios de log, marque a caixa de seleção Habilitar transferência de Diretórios de Log. Para aumentar ou diminuir o intervalo entre a transferência de logs para sua conta de armazenamento, altere o valor do Período de Transferência (min).

Marque as caixas de seleção dos logs que deseja coletar, como Logs do IIS e logs de Solicitação com Falha. Os nomes de contêiner de armazenamento padrão são fornecidos, mas você pode alterá-los.

Você pode capturar logs de qualquer pasta. Especifique o caminho na seção Log do Diretório Absoluto e, em seguida, selecione Adicionar Diretório. Os logs são capturados nos contêineres especificados.

Logs do ETW

Se você usar ETW (Rastreamento de Eventos para Windows) e desejar capturar logs de ETW, selecione a caixa de seleção Habilitar transferência de logs de ETW. Para aumentar ou diminuir o intervalo entre a transferência de logs para sua conta de armazenamento, altere o valor do Período de Transferência (min).

Os eventos são capturados das origens de eventos e manifestos de evento que você especificar. Para especificar uma origem de evento, na seção Fontes de Evento, insira um nome e, em seguida, selecione Adicionar Origem de Evento. Da mesma forma, você pode especificar um manifesto de evento na seção Manifestos de Evento e, em seguida, escolher o botão Adicionar Manifesto de Evento.

O framework do ETW tem suporte no ASP.NET por meio de classes no namespace System.Diagnostics.aspx. O namespace Microsoft.WindowsAzure.Diagnostics, que herda e estende classes System.Diagnostics.aspx padrão, permite o uso de System.Diagnostics.aspx como um registro em log estrutura no ambiente do Azure. Para obter mais informações, consulte Assumir controle do registro em log e do rastreamento no Microsoft Azure e Habilitar o diagnóstico em máquinas virtuais e Serviços de Nuvem do Azure (suporte estendido).

Despejos de memória

Para capturar informações sobre quando uma instância de função falha, marque a caixa de seleção Habilitar transferência de despejos. (Como o ASP.NET lida com a maioria das exceções, isso geralmente é útil apenas para funções de trabalho.) Para aumentar ou diminuir o percentual de espaço de armazenamento dedicado aos despejos de memória, altere o valor Cota de diretório (%). Você pode alterar o contêiner de armazenamento no qual os despejos de memória são armazenados e selecionar se deseja capturar um despejo Completo ou Mini.

Os processos que estão sendo rastreados no momento são listados na seguinte captura de tela. Selecione as caixas de seleção para os processos que você deseja capturar. Para adicionar outro processo à lista, insira o nome do processo e, em seguida, selecione Adicionar Processo.

Para obter mais informações, confira Assumir o controle do registro em log e do rastreamento no Microsoft Azure.

Solucionar problemas dos Serviços de Nuvem do Azure (suporte estendido)

Se você tiver problemas com seus projetos de serviço de nuvem, como uma função travar no status "ocupado", repetidamente reciclar ou lançar um erro interno do servidor, existem ferramentas e técnicas que você poderá usar para diagnosticar e corrigir esses problemas. Para obter exemplos específicos de problemas e soluções comuns e para uma visão geral dos conceitos e ferramentas que você pode usar para diagnosticar e corrigir esses erros, consulte Dados de diagnóstico de computação de PaaS (plataforma como serviço) do Azure.

Perguntas e respostas

Qual é o tamanho do buffer e que tamanho o buffer deve ter?

Em cada instância de máquina virtual, as cotas limitam quantos dados de diagnóstico podem ser armazenados no sistema de arquivos local. Além disso, você pode especificar um tamanho do buffer para cada tipo de dados de diagnóstico disponível. Esse tamanho do buffer age como uma cota individual para esse tipo de dados. Para determinar a cota geral e a quantidade de memória que permanece, consulte a parte inferior da caixa de diálogo para o tipo de dados de diagnóstico. Se você especificar buffers maiores ou mais tipos de dados, abordará a cota geral. Você pode alterar a cota geral modificando o arquivo de configuração diagnostics.wadcfgx. Os dados de diagnóstico são armazenados no sistema de arquivos como seus dados do aplicativo. Se seu aplicativo usar uma grande quantidade de espaço em disco, você não deverá aumentar a cota de diagnóstico geral.

Qual é o período de transferência e por qual tempo deve ser?

O período de transferência é a quantidade de tempo que decorreu as capturas de dados. Depois de cada período de transferência, os dados são movidos do sistema de arquivos local de uma máquina virtual para tabelas em sua conta de armazenamento. Se a quantidade de dados que são coletados excede a cota antes do final de um período de transferência, dados antigos serão descartados. Você talvez queira diminuir o período de transferência se estiver perdendo dados porque seus dados excedem o tamanho do buffer ou a cota geral.

Os carimbos de data/hora estão inseridos em que fuso horário?

Os carimbos de data/hora estão no fuso horário local do data center que hospeda o serviço de nuvem. As três colunas de carimbo de data/hora a seguir nas tabelas de log são usadas:

• PreciseTimeStamp: o carimbo de data/hora de ETW do evento. Ou seja, a hora em que o evento é registrado no cliente.
• TIMESTAMP: o valor para PreciseTimeStamp arredondado para baixo até o limite de frequência de upload. Portanto, se a frequência de upload for de 5 minutos e a hora do evento for 00:17:12, TIMESTAMP será 00:15:00.
• Timestamp: o carimbo de data/hora em que a entidade foi criada na tabela do Azure.

Como gerenciar custos ao coletar informações de diagnóstico?

As configurações padrão (Nível de log definido como Erro e Período de transferência definido como 1 minuto) são projetadas para minimizar os custos. Os custos de computação aumentam quando você coleta mais dados de diagnóstico ou se você diminui o período de transferência. Não colete mais dados do que você precisa e não se esqueça de desabilitar a coleta de dados quando não precisar mais dela. Você sempre poderá habilitá-lo novamente, mesmo no tempo de execução, conforme descrito anteriormente neste artigo.

Como posso coletar logs de solicitação com falha do IIS?

Por padrão, o IIS não coleta logs de solicitação com falha. Você pode configurar o IIS para coletar logs de solicitação com falha editando o arquivo web.config para sua função web.

Não estou obtendo informações de rastreamento de métodos RoleEntryPoint como OnStart. Qual é o problema?

Os métodos de RoleEntryPoint são chamados no contexto de WAIISHost.exe, não em IIS. As informações de configuração no web.config que normalmente habilitam o rastreamento não se aplicam. Para resolver esse problema, adicione um arquivo .config ao seu projeto de função web e nomeie o arquivo para corresponder ao assembly de saída que contém o código RoleEntryPoint. No projeto de função web padrão, o nome do arquivo .config deve ser WAIISHost.exe.config. Adicione as seguintes linhas a esse arquivo:

<system.diagnostics>
  <trace>
      <listeners>
          <add name "AzureDiagnostics" type="Microsoft.WindowsAzure.Diagnostics.DiagnosticMonitorTraceListener">
              <filter type="" />
          </add>
      </listeners>
  </trace>
</system.diagnostics>

Na janela Propriedades, defina a propriedade Copiar para Diretório de Saída como Copiar sempre.

Conteúdo relacionado

Para saber mais sobre o registro em log de diagnósticos no Azure, consulte Habilitar o diagnóstico em máquinas virtuais e Serviços de Nuvem do Azure (suporte estendido) e Habilitar o registro em log de diagnóstico para aplicativos Web no Serviço de Aplicativo do Azure.