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

Importante

Os Serviços de Nuvem (clássicos) estão obsoletos para todos os clientes desde 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. As 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 rastreamento é uma maneira de monitorar a execução do seu aplicativo enquanto ele está em execução. Você pode usar as classes System.Diagnostics.Trace, System.Diagnostics.Debug e System.Diagnostics.TraceSource para registrar informações sobre erros e execução do aplicativo em logs, arquivos de texto ou outros dispositivos para análise posterior. Para obter mais informações sobre rastreamento, consulte Rastreamento e instrumentação de aplicativos.

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

Implemente o rastreamento em seu aplicativo de Serviços de Nuvem adicionando DiagnosticMonitorTraceListener à configuração do aplicativo e fazendo chamadas a 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 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 DiagnosticMonitorTraceListener é adicionado ao arquivo de configuração apropriado para as funções que você adiciona.

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

Incluindo Opções de Rastreamento em seu código, você pode controlar se o rastreamento ocorre e qual a sua extensão. O rastreamento permite monitorar o status do aplicativo em um ambiente de produção. Monitorar o status do aplicativo é particularmente 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

Rastreamento, depuração e TraceSource exigem que você configure "ouvintes" para coletar e registrar as mensagens que são enviadas. Os ouvintes coletam, armazenam e roteiam mensagens de rastreamento. Eles direcionam a saída de rastreamento para um destino apropriado, como um log, uma janela ou um 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 Habilitar o Diagnóstico no Microsoft Azure.

Observação

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 arquivo. Altere o atributo Version para usar o número de versão do assembly que está sendo referenciado. A versão do assembly não é alterada, necessariamente, com cada versão do SDK do Azure, a menos que existam 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 ao assembly Microsoft.WindowsAzure.Diagnostics. Atualize o número de versão no xml anterior para corresponder à versão do assembly referenciado Microsoft.WindowsAzure.Diagnostics.

3. Salve o arquivo de configuração.

Para obter mais informações sobre ouvintes, veja Ouvintes de rastreamento.

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

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

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

       using System.Diagnostics;
   

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