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

Observação

Este artigo aplica-se aos Serviços de Nuvem do Azure Azure (suporte estendido). Os Serviços de Nuvem (clássicos) são desativados a partir de 31 de agosto de 2024. Para obter mais informações, consulte modelo de implantação de serviços de nuvem (clássico) será desativado em 31 de agosto de 2024. Para novos desenvolvimentos, recomendamos que você use um tipo de serviço mais recente projetado para sua finalidade específica, como do Serviço de Aplicativo do Azure, Azure Functionsou de Aplicativos de Contêiner do Azure. Para obter a lista mais recente de serviços disponíveis, consulte Directory of Azure products.

Quando precisar solucionar problemas de um serviço de Serviços de Nuvem do Azure (suporte estendido) ou máquina virtual, você poderá usar o Visual Studio para configurar mais facilmente o Diagnóstico do Azure. O diagnóstico captura dados do sistema e dados de registro em log nas máquinas virtuais e instâncias de máquinas virtuais 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 log de diagnóstico no Azure, consulte Habilitar o 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 depois que elas são coletadas.

Para configurar o Diagnóstico do Azure, altere as configurações de diagnóstico na caixa de diálogo de 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.

Advertência

No Visual Studio 2022, o preterido Emulador de Armazenamento do Azure foi substituído pelo emulador Azurite ao depurar os seus projetos dos Serviços de Nuvem. Este 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 precisar do plug-in para cenários locais de execução e teste, você pode 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 emulador de Armazenamento do Azure anterior. Na versão 17.10 do Visual Studio, o plug-in de Diagnóstico local do Azure está a ser descontinuado e desativado por padrão, com a possibilidade de ser ativado nessa versão. O plug-in foi removido no Visual Studio 17.11. Este plug-in foi usado apenas com o emulador de computação do Azure local e a desativaçã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 a seguinte configuração de propriedade a qualquer PropertyGroup em seu 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 ela gera 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 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 no .wadcfgx.

Para que serve a caixa de seleção "Atualizar cadeias de conexão de armazenamento de desenvolvimento..."?

A caixa de seleção Atualizar cadeias de conexão de armazenamento de desenvolvimento para Diagnóstico e Cache com credenciais de conta de armazenamento do Microsoft Azure ao publicar no Microsoft Azure é 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 foi especificada como a cadeia de ligação de diagnóstico, então essa conta é utilizada.

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 serão coletadas. As próximas seções descrevem as guias na caixa de diálogo de configuração do Diagnostics e os significados de cada opção de configuração.

Logs de aplicativos

Os logs de aplicativos têm informações de diagnóstico produzidas por um aplicativo Web. Se quiser capturar registos de aplicações, marque a caixa de seleção Ativar transferência de registos de aplicações. Para aumentar ou diminuir o intervalo entre a transferência de logs de aplicativos para a sua conta de armazenamento, altere o valor de Período de transferência (min). Você também pode alterar a quantidade de informações capturadas no log definindo o nível Log valor. Por exemplo, selecione Verboso para obter mais informações ou selecione Crítico para capturar apenas erros críticos. Se tiveres um fornecedor de diagnósticos específico que gera logs de aplicação, podes capturar os logs adicionando o identificador global exclusivo (GUID) do fornecedor na caixa GUID do Provedor.

Para obter mais informações sobre logs de aplicações, consulte Ativar o registo de diagnósticos para aplicações Web no Azure App Service.

Logs de eventos do Windows

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

Se desejar 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, marque 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 a sua conta de armazenamento, altere o valor de Período de Transferência ( min). Marque as caixas de seleção dos contadores de desempenho que você deseja acompanhar.

Contadores de desempenho

Para controlar um contador de desempenho que não está listado, insira o contador de desempenho usando a sintaxe sugerida. e, em seguida, selecione Adicionar. O sistema operacional na máquina virtual determina quais contadores de desempenho você pode rastrear. 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 Ativar transferência de logs de infraestrutura. Para aumentar ou diminuir o intervalo entre a transferência de logs de infraestrutura para a sua conta de armazenamento, altere o valor Período de Transferência (min).

Para obter mais informações, consulte Recolher dados de registo utilizando o Diagnóstico do Azure.

Diretórios de log

Os diretórios de log contêm dados coletados de diretórios de log para solicitações do IIS (Serviços de Informações da Internet), solicitações com falha ou pastas que escolher. Para capturar 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 a sua conta de armazenamento, altere o valor do Período de Transferência (min).

Marque as caixas de seleção dos logs que pretende recolher, como logs do IIS e logs de pedidos 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 de do Diretório Absoluto e selecione Adicionar Diretório. Os logs são capturados nos contentores especificados.

Registos ETW

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

Os eventos são capturados das fontes dos eventos e dos manifestos dos eventos que tu especificares. Para especificar uma fonte de evento, na seção Fontes de Eventos, insira um nome e selecione Adicionar Fonte de Evento . Da mesma forma, pode especificar um manifesto de evento na seção Manifestos de Eventos e, em seguida, selecionar Adicionar Manifesto de Evento.

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

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 de memória por falha. (Como ASP.NET lida com a maioria das exceções, isso geralmente é útil apenas para funções de trabalho.) Para aumentar ou diminuir a porcentagem de espaço de armazenamento dedicado aos despejos de memória, altere o valor de Cota de Diretório (%). Você pode alterar o contêiner de armazenamento onde os despejos de memória são armazenados e selecionar se deseja capturar um Full ou Mini dump.

Os processos atualmente sendo rastreados são listados na próxima captura de tela. Marque as caixas de seleção dos processos que você deseja capturar. Para adicionar outro processo à lista, insira o nome do processo e selecione Adicionar processo.

Para obter mais informações, veja Controle de registos 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 da plataforma Azure como serviço (PaaS).

Q & A

Qual é o tamanho do buffer e qual deve ser o seu tamanho?

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 funciona como uma cota individual para esse tipo de dados. Para determinar a cota geral e a quantidade de memória restante, consulte a parte inferior da caixa de diálogo para o tipo de dados de diagnóstico. Se especificar buffers maiores ou mais tipos de dados, aproximar-se-á da cota geral. Você pode alterar a cota geral modificando o diagnostics.wadcfgx arquivo de configuração. Os dados de diagnóstico são armazenados no mesmo sistema de arquivos que os dados do seu aplicativo. Se seu aplicativo usa uma grande quantidade de espaço em disco, você não deve aumentar a cota geral de diagnóstico.

Qual é o período de transferência e qual a sua duração?

O período de transferência é a quantidade de tempo que decorre entre as 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 os dados excedem o tamanho do buffer ou a cota geral, convém diminuir o período de transferência.

Em que fuso horário estão os carimbos de data/hora?

Os carimbos de data/hora estão no fuso horário local do datacenter que hospeda o seu serviço de nuvem. As três colunas de timestamp seguintes nas tabelas de log são utilizadas:

• PreciseTimeStamp: O carimbo de data/hora ETW do evento. Ou seja, a hora em que o evento é registado pelo cliente.
• TIMESTAMP: O valor de PreciseTimeStamp arredondado para baixo para o limite de frequência de upload. Por exemplo, se a frequência de carregamento for de 5 minutos e a hora do evento for 00:17:12, o 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 faço para gerenciar os 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) destinam-se a 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 o necessário e não se esqueça de desativar a coleta de dados quando não precisar mais deles. Você sempre pode habilitá-lo novamente, mesmo em tempo de execução, conforme descrito anteriormente neste artigo.

Como faço para 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 de 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 no IIS. As informações de configuração no web.config que normalmente habilita o rastreamento não se aplicam. Para resolver este problema, adicione um arquivo de .config ao seu projeto de função web e nomeie o arquivo de forma a corresponder ao assembly de saída que contém o código de 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 ficheiro:

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

Na janela Propriedades do, defina a propriedade Copy to Output Directory como Copy sempre.

Conteúdo relacionado

Para saber mais sobre o registo de diagnósticos no Azure, consulte Ativar diagnósticos nos Serviços de Nuvem do Azure (suporte alargado) e máquinas virtuais e Ativar o registo de diagnóstico para Aplicações Web no Serviço de Aplicaçõesdo Azure .