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

Quando você precisa solucionar problemas de uma máquina virtual ou serviço de nuvem do Azure, pode usar o Visual Studio para configurar mais facilmente o Diagnóstico do Azure. 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 usar o Visual Studio para ativar e configurar o Diagnóstico do Azure, tanto antes quanto depois da implantação. 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.

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.

Por exemplo, se você marcar essa caixa de seleção e a cadeia de conexão de diagnóstico especificar UseDevelopmentStorage=true, quando você publicar o projeto no Azure, o Visual Studio automaticamente atualizará 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.

Ativar o diagnóstico em projetos de serviço de nuvem antes de implantá-los

No Visual Studio, você pode coletar dados de diagnóstico para funções executadas no Azure quando executa o serviço no emulador antes da implantação. Todas as alterações às configurações de diagnóstico no Visual Studio são salvas no arquivo de configuração diagnostics.wadcfgx. Essas configurações especificam a conta de armazenamento na qual os dados de diagnóstico são salvos quando você implanta seu serviço de nuvem.

Para habilitar o diagnóstico no Visual Studio antes da implantação

1. No menu de atalho para a função, selecione Propriedades. Na caixa de diálogo Propriedades da função, selecione a guia Configuração.

2. Na seção Diagnóstico, verifique se a caixa de seleção Habilitar Diagnóstico está selecionada.

   

3. Para especificar a conta de armazenamento para os dados de diagnóstico, selecione o botão de reticências (…).

   

4. Na caixa de diálogo Criar Cadeia de Conexão de Armazenamento, especifique se você deseja se conectar usando o Emulador de Armazenamento do Azure, uma assinatura do Azure ou credenciais inseridas manualmente.

   

   • Se você selecionar Emulador de Armazenamento do Microsoft Azure, a cadeia de conexão será definida como UseDevelopmentStorage=true.
   • Se você selecionar Sua assinatura, você poderá selecionar a assinatura do Azure que você deseja usar e digitar um nome de conta. Para gerenciar suas assinaturas do Azure, selecione Gerenciar Contas.
   • Se você selecionar Credenciais inseridas manualmente, digite o nome e a chave da conta do Azure que você deseja usar.

5. Para exibir a caixa de diálogo Configuração de diagnóstico, selecione Configurar. Exceto por Geral e Diretórios de log, cada guia representa uma fonte de dados de diagnóstico que você pode coletar. A guia padrão Geral oferece as seguintes opções de coleta de dados de diagnóstico: Somente erros, Todas as informações e Plano personalizado. A opção padrão Somente erros usa a menor quantidade de armazenamento porque não transfere avisos nem mensagens de rastreamento. A opção Todas as informações transfere a maioria das informações, usa o máximo de armazenamento e, portanto, é a opção mais cara.

   Observação

   O tamanho mínimo compatível com "Cota de Disco em MB" é de 50 MB e o tamanho padrão é 4 GB. No entanto, se você estiver coletando os despejos de memória, aumente isso para um valor mais alto, como 10 GB.

   

6. Para este exemplo, selecione a opção Plano personalizado para que você possa personalizar os dados coletados.

7. Na caixa Cota de disco em MB, você pode definir quanto espaço alocar na sua conta de armazenamento para dados de diagnóstico. Você pode alterar ou aceitar o valor padrão.

8. Em cada guia de dados de diagnóstico que você deseja coletar, marque a caixa de seleção Habilitar Transferência do <tipo de log>. Por exemplo, se você quiser coletar logs de aplicativo, na guia Logs de aplicativo, marque a caixa de seleção Habilitar transferência de Logs de Aplicativos. Além disso, especifique todas as outras informações necessárias para cada tipo de dados de diagnóstico. Para obter informações de configuração para cada guia, consulte a seção Configurar fontes de dados de diagnóstico posteriormente neste artigo.

9. Depois de habilitar a coleção de todos os dados de diagnóstico que você desejar, selecione OK.

10. Execute seu projeto de serviço de nuvem do Azure no Visual Studio, como de costume. Conforme você usa seu aplicativo, as informações de log habilitadas são salvas na conta de Armazenamento do Azure especificada.

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á capturá-los 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.

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 do serviço de nuvem do Azure

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 e Habilitar o registro em log de diagnóstico para aplicativos Web no Serviço de Aplicativo do Azure.