Rastrear o fluxo de um aplicativo de Serviços de Nuvem (clássico) com o Diagnóstico do Azure

Importante

Os Serviços na Nuvem (clássicos) foram preteridos para todos os clientes a partir de 1º de setembro de 2024. Todas as implantações em execução existentes serão interrompidas e encerradas pela Microsoft e os dados serão perdidos permanentemente a partir de outubro de 2024. Novas implantações devem usar o novo modelo de implantação baseado no Azure Resource Manager Serviços de Nuvem do Azure (suporte estendido).

O rastreio é uma forma de monitorizar a execução da aplicação enquanto esta ocorre. Você pode usar as classes System.Diagnostics.Trace, System.Diagnostics.Debug e System.Diagnostics.TraceSource para registrar informações sobre erros e execução de aplicativos em logs, arquivos de texto ou outros dispositivos para análise posterior. Para obter mais informações sobre rastreamento, consulte Aplicativos de rastreamento e instrumentação.

Usar instruções de rastreamento e opções de rastreamento

Implemente o rastreamento em seu aplicativo de Serviços de Nuvem adicionando o DiagnosticMonitorTraceListener à configuração do aplicativo e fazendo chamadas para System.Diagnostics.Trace ou System.Diagnostics.Debug no código do aplicativo. Use o arquivo de configuração app.config para funções de trabalho e o web.config para funções Web. Quando você cria um novo serviço hospedado usando um modelo do Visual Studio, o Diagnóstico do Azure é adicionado automaticamente ao projeto e o DiagnosticMonitorTraceListener é adicionado ao arquivo de configuração apropriado para as funções adicionadas.

Para obter informações sobre como colocar instruções de rastreamento, consulte Como adicionar instruções de rastreamento ao código do aplicativo.

Ao colocar Opções de Rastreamento em seu código, você pode controlar se o rastreamento ocorre e quão extenso ele é. O rastreamento permite monitorar o status do seu aplicativo em um ambiente de produção. O monitoramento do status do aplicativo é especialmente importante em um aplicativo de negócios que usa vários componentes em execução em vários computadores. Para obter mais informações, consulte Como configurar opções de rastreamento.

Configurar o ouvinte de rastreamento em um aplicativo do Azure

Trace, Debug e TraceSource exigem que você configure "ouvintes" para coletar e gravar as mensagens enviadas. Os ouvintes coletam, armazenam e encaminham mensagens de rastreamento. Eles direcionam a saída de rastreamento para um destino apropriado, como um log, janela ou arquivo de texto. O Diagnóstico do Azure usa a classe DiagnosticMonitorTraceListener .

Antes de concluir o procedimento a seguir, você deve inicializar o monitor de diagnóstico do Azure. Para inicializar o monitor de diagnóstico do Azure, consulte Habilitando diagnósticos no Microsoft Azure.

Nota

Se você usar os modelos fornecidos pelo Visual Studio, a configuração do ouvinte será adicionada automaticamente para você.

Adicionar um ouvinte de rastreamento

1. Abra o arquivo web.config ou app.config para sua função.

2. Adicione o seguinte código ao ficheiro . Altere o atributo Version para usar o número da versão do assembly ao qual você está fazendo referência. A versão do assembly não muda necessariamente com cada versão do SDK do Azure, a menos que haja atualizações para ela.

   <system.diagnostics>
       <trace>
           <listeners>
               <add type="Microsoft.WindowsAzure.Diagnostics.DiagnosticMonitorTraceListener,
                 Microsoft.WindowsAzure.Diagnostics,
                 Version=2.8.0.0,
                 Culture=neutral,
                 PublicKeyToken=31bf3856ad364e35"
                 name="AzureDiagnostics">
                   <filter type="" />
               </add>
           </listeners>
       </trace>
   </system.diagnostics>
   

   Importante

   Verifique se você tem uma referência de projeto para o assembly Microsoft.WindowsAzure.Diagnostics. Atualize o número da versão no xml anterior para corresponder à versão do assembly Microsoft.WindowsAzure.Diagnostics referenciado.

3. Salve o arquivo de configuração.

Para obter mais informações sobre ouvintes, consulte Rastrear ouvintes.

Depois de concluir as etapas para adicionar o ouvinte, você pode adicionar instruções de rastreamento ao seu código.

Para adicionar instrução de rastreamento ao seu código

1. Abra um arquivo de origem para seu aplicativo. Por exemplo, o <arquivo RoleName>.cs para a função de trabalho ou função Web.
2. Adicione a seguinte diretiva using se ela não estiver presente:

       using System.Diagnostics;
   

3. Adicione instruções Trace onde você deseja capturar informações sobre o estado do seu aplicativo. Você pode usar vários métodos para formatar a saída da instrução Trace. Para obter mais informações, consulte Como adicionar instruções de rastreamento ao código do aplicativo.
4. Salve o arquivo de origem.