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

Nota

Este artigo se aplica aos Serviços de Nuvem do Azure (suporte estendido). Os Serviços de Nuvem (clássicos) estão desativados a partir de 31 de agosto de 2024. Para obter mais informações, confira O modelo de implantação de serviços de nuvem (clássico) será desativado em 31 de agosto de 2024. Para um novo desenvolvimento, recomendamos que você use um tipo de serviço mais recente projetado para sua finalidade específica, como o Serviço de Aplicativo do Azure , as Funções do Azure ou os Aplicativos de Contêiner do Azure . Para obter a lista mais recente de serviços disponíveis, consulte Diretório de produtos do Azure.

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

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

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 são salvas em um arquivo chamado diagnostics.wadcfgx. Você também pode modificar 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 de Diagnóstico do Azure, que fornece suporte para o Diagnóstico do Azure ao executar e testar localmente. Se você precisar do plug-in para cenários locais de execução e teste, você poderá atualizar a cadeia de conexão na configuração de serviço local (.cscfg) para uma conta de Armazenamento do Azure (consulte Gerenciar cadeias de conexão para contas de armazenamento) ou baixar o do emulador do Armazenamento do Azure anterior. Na versão 17.10 do Visual Studio, o plug-in local de Diagnóstico do Azure está sendo descontinuado e desabilitado por padrão, com a opção de ativá-lo nessa mesma versão. O plug-in foi removido no Visual Studio 17.11. Esse plug-in foi usado apenas 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 plugin de diagnóstico no Visual Studio 17.10, adicione a seguinte configuração de propriedade a 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 durante a publicação e quando 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 retornará ao uso da conta de armazenamento especificada no arquivo .wadcfgx para configurar a extensão de diagnóstico para publicação e para 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 especificada 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

Depois de habilitar a coleta de dados de diagnóstico, você pode escolher exatamente quais fontes de dados 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 aplicação

Os logs de aplicativo têm informações de diagnóstico produzidas por um aplicativo Web. Se você quiser capturar logs de aplicativos, selecione a caixa de seleção Habilitar transferência de logs de aplicativos. 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ê também pode alterar a quantidade de informações capturadas no log definindo o valor do 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á capturá-los adicionando o GUID (identificador global exclusivo) do provedor na caixa GUID do Provedor.

logs de aplicativos

Para obter mais informações sobre logs de aplicativo, confira 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 eventos 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 acompanhar.

logs de eventos

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 desempenho do sistema e do aplicativo. Para obter mais informações, consulte Criar e usar contadores de desempenho em um aplicativo do Azure. Para capturar contadores de desempenho, selecione a caixa de seleção Habilitar transferência de Contadores de Desempenho. Para aumentar ou diminuir o intervalo entre a transferência de logs de eventos para sua conta de armazenamento, altere o valor do Período de Transferência (minutos). Selecione as caixas de seleção para os contadores de desempenho que você deseja acompanhar.

contadores de desempenho

Para acompanhar um contador de desempenho que não está listado, insira o contador de desempenho usando a sintaxe sugerida. e 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

Os 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).

logs de infraestrutura de diagnósticos

Para saber mais, confira 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 diretórios de log, selecione a caixa de seleção Habilitar a 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 (minutos).

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 alterar os nomes.

Você pode capturar logs de qualquer pasta. Especifique o caminho na seção Log do Absolute Directory e 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 de fontes de evento e manifestos de evento especificadas por você. Para especificar uma fonte de evento, na seção Fontes de Eventos, insira um nome e selecione Adicionar Fonte de Evento. Da mesma forma, você pode especificar um manifesto de evento na seção manifestos de evento e selecionar Adicionar Manifesto de Evento.

A estrutura ETW tem suporte em ASP.NET por meio de classes no namespace System.Diagnostics.aspx. O namespace Microsoft.WindowsAzure.Diagnostics, que herda e estende as classes padrão de System.Diagnostics.aspx, permite o uso de System.Diagnostics.aspx como um framework de logging no ambiente Azure. Para obter mais informações, confira 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 falhas

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 acompanhados estão listados na próxima 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 selecione Adicionar Processo.

despejos de falhas

Para obter mais informações, consulte Assuma o controle dos logs e 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 que fica presa em um status "ocupado", recicla repetidamente ou lança um erro interno do servidor, há ferramentas e técnicas que você pode usar para diagnosticar e corrigir o problema. Para obter exemplos específicos de problemas e soluções comuns e para obter 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 quão grande ele deve ser?

Em cada instância de máquina virtual, as cotas limitam a quantidade de dados de diagnóstico que podem ser armazenados no sistema de arquivos local. Além disso, você especifica um tamanho de buffer para cada tipo de dados de diagnóstico disponíveis. Esse tamanho de buffer atua 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, estará próximo de atingir 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 mesmo sistema de arquivos que os dados do aplicativo. Se o aplicativo usar uma grande quantidade de espaço em disco, você não deverá aumentar a cota geral de diagnóstico.

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

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

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 ETW do evento. Ou seja, a hora em que o evento é registrado no cliente.
• TIMESTAMP: o valor de PreciseTimeStamp foi arredondado para baixo até o limite da frequência de upload. Por exemplo, se a frequência de carregamento for de 5 minutos e a hora do evento 00:17:12, TIMESTAMP será 00:15:00.
• Carimbo de data/hora: o carimbo de data/hora no qual 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. Seus custos de computação aumentam quando você coleta mais dados de diagnóstico ou se diminui o período de transferência. Não colete mais dados do que precisa e não se esqueça de desabilitar a coleta de dados quando você não precisar mais dela. Você sempre pode habilitá-lo novamente, mesmo em tempo de execução, conforme descrito anteriormente neste artigo.

Como 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 recebendo informações de rastreamento dos métodos RoleEntryPoint, como OnStart. Qual é o problema?

Os métodos de RoleEntryPoint são chamados no contexto de WAIISHost.exe, não no IIS. As informações de configuração em web.config que normalmente habilita o rastreamento não se aplicam. Para resolver esse problema, adicione um arquivo .config ao 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 este 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 log de diagnóstico no Azure, consulte Habilitar diagnóstico nos Serviços de Nuvem do Azure (suporte estendido) e máquinas virtuais e Habilitar o registro em log de diagnóstico para aplicativos Web no Serviço de Aplicativo do Azure.