Compartilhar via

WCF Services e Rastreamento de Eventos para Windows

O exemplo ETWTracing demonstra como usar o rastreamento analítico no WCF (Windows Communication Foundation) para emitir eventos no ETW (Rastreamento de Eventos para Windows). Os rastreamentos analíticos são eventos emitidos em pontos-chave na pilha do WCF que permitem a solução de problemas de serviços WCF no ambiente de produção.

O rastreamento analítico nos serviços do WCF é um rastreamento que pode ser ativado em um ambiente de produção com impacto mínimo no desempenho. Esses rastreamentos são emitidos como eventos para uma sessão ETW.

Este exemplo inclui um serviço WCF básico no qual os eventos são emitidos do serviço para o log de eventos, que pode ser exibido usando o Visualizador de Eventos. Também é possível iniciar uma sessão de ETW dedicada que escuta eventos do serviço WCF. O exemplo inclui um script para criar uma sessão de ETW dedicada que armazena eventos em um arquivo binário que pode ser lido usando o Visualizador de Eventos.

Para usar este exemplo

  1. Usando o Visual Studio, abra o arquivo de solução EtwAnalyticTraceSample.sln.

  2. Para criar a solução, pressione Ctrl+Shift+B.

  3. Para executar a solução, pressione Ctrl+F5.

    No navegador da Web, clique em Calculator.svc. O URI do documento WSDL para o serviço deve aparecer no navegador. Copie esse URI.

    Por padrão, o serviço começa a escutar solicitações na porta 1378 http://localhost:1378/Calculator.svc.

  4. Execute o cliente de teste do WCF (WcfTestClient.exe).

    O cliente de teste do WCF (WcfTestClient.exe) está localizado em \<Visual Studio Install Dir>\Common7\IDE\WcfTestClient.exe.

  5. No cliente de teste do WCF, adicione o serviço selecionando Arquivo e, em seguida, Adicione Serviço.

    Adicione o endereço do endpoint na caixa de entrada. O padrão é http://localhost:1378/Calculator.svc.

  6. Abra o aplicativo Visualizador de Eventos.

    Antes de invocar o serviço, inicie o Visualizador de Eventos e verifique se o log de eventos está escutando os eventos de rastreamento emitidos do serviço WCF.

  7. No menu Iniciar , selecione Ferramentas Administrativas e, em seguida, Visualizador de Eventos. Habilite os logs de Análise e Depuração .

  8. No modo de exibição de árvore no Visualizador de Eventos, navegue até o Visualizador de Eventos, Logs de Aplicativos e Serviços, Microsoft, Windows e, em seguida, Application Server-Applications. Clique com o botão direito do mouse em Servidor de Aplicativos-Aplicações, selecione Exibir e, em seguida, Mostrar registros analíticos e de depuração.

    Verifique se a opção Mostrar Logs de Análise e Depuração está marcada.

  9. Habilite o log Analítico.

    No modo de exibição de árvore no Visualizador de Eventos, navegue até o Visualizador de Eventos, Logs de Aplicativos e Serviços, Microsoft, Windows e, em seguida, Application Server-Applications. Clique com o botão direito do mouse Analítico e selecione Habilitar Log.

Para testar o serviço

  1. Volte para o cliente de teste do WCF e clique Divide duas vezes e mantenha os valores padrão, que especificam um denominador de 0.

    Se o denominador for 0, o serviço gerará uma falha.

  2. Observe os eventos emitidos pelo serviço.

    Volte para o Visualizador de Eventos e navegue até o Visualizador de Eventos, Logs de Aplicativos e Serviços, Microsoft, Windows e, em seguida, Application Server-Applications. Clique com o botão direito do mouse em Análise e selecione Atualizar.

    Os eventos de rastreamento analítico do WCF são exibidos no visualizador de eventos. Observe que, como uma falha foi gerada pelo serviço, um evento de rastreamento de erro é exibido no visualizador de eventos.

  3. Repita as etapas 1 e 2, mas com entradas válidas. O valor do N2 parâmetro pode ser qualquer número diferente de 0.

    Atualize o canal analítico para ver os eventos do WCF e não incluir nenhum evento de erro.

O exemplo demonstra os eventos de rastreamento analítico emitidos de um serviço WCF.

Para limpar (opcional)

  1. Abra o Visualizador de Eventos.

  2. Navegue até o Visualizador de Eventos, Logs de Aplicativos e Serviços, Microsoft, Windows e, em seguida, Application-Server-Applications. Clique com o botão direito do mouse em Análise e selecione Desabilitar Log.

  3. Navegue até o Visualizador de Eventos, Logs de Aplicativos e Serviços, Microsoft, Windows e, em seguida, Application-Server-Applications. Clique com o botão direito do mouse em Análise e selecione Limpar Log.

  4. Escolha a opção Limpar para limpar os eventos.

Consulte também

  • Last updated on