Servizi WCF e traccia eventi per Windows

In questo esempio viene descritto come utilizzare la traccia analitica in Windows Communication Foundation (WCF) per generare eventi in Traccia eventi per Windows (ETW). Le tracce analitiche sono eventi generati in corrispondenza di punti chiave nello stack WCF che consentono risolvere i problemi relativi ai servizi WCF in un ambiente di produzione.

La funzionalità di tracci analitica nei servizi WCF consiste in una traccia che può essere attivata in un ambiente di produzione con impatto minimo sulle prestazioni. Queste tracce vengono inviate come eventi a una sessione ETW.

In questo esempio è incluso un servizio WCF di base in cui gli eventi vengono inviati dal servizio al registro eventi che può essere visualizzato tramite Visualizzatore eventi. È inoltre possibile avviare una sessione ETW dedicata che rimanga in ascolto degli eventi generati dal servizio WCF. Nell'esempio è incluso uno script che consente di creare una sessione ETW dedicata che archivia gli eventi in un file binario che può essere letto tramite Visualizzatore eventi.

Per utilizzare questo esempio

1. In Visual Studio 2010 aprire il file della soluzione EtwAnalyticTraceSample.sln.

2. Per compilare la soluzione, premere F6.

3. Per eseguire la soluzione, premere CTRL+F5.

   Nel browser Web fare clic su Calculator.svc. L'URI del documento WSDL per il servizio viene visualizzato nel browser. Copiare l'URI.

   Per impostazione predefinita, il servizio si pone in ascolto delle richieste sulla porta 1378 (https://localhost:1378/Calculator.svc).

4. Eseguire il client di prova WCF (WcfTestClient.exe).

   Il client di prova WCF (WcfTestClient.exe) si trova nella <directory di installazione di Visual Studio 2010>\Common7\IDE\ WcfTestClient.exe (la directory di installazione predefinita di Visual Studio 2010 è C:\Programmi\Microsoft Visual Studio 10.0).

5. All'interno del client di prova WCF aggiungere il servizio selezionando File, quindi Aggiungi servizio.

   Aggiungere l'indirizzo dell'endpoint nella casella di input. L'indirizzo predefinito è https://localhost:1378/Calculator.svc.

6. Aprire l'applicazione Visualizzatore eventi.

   Prima di richiamare il servizio, avviare Visualizzatore eventi e verificare che il registro eventi sia in ascolto per rilevare gli eventi generati dal servizio WCF.

7. Dal menu Start scegliere Strumenti di amministrazione, quindi Visualizzatore eventi. Abilitare i registri Analitico e Debug.

8. Nella visualizzazione struttura ad albero di Visualizzatore eventi passare a Visualizzatore eventi, Registri applicazioni e servizi, Microsoft, Windows, quindi Server applicazioni-Applicazioni. Fare clic con il pulsante destro del mouse su Server applicazioni-Applicazioni, scegliere Visualizza, quindi Visualizza registri analitici e di debug.

   Assicurarsi che l'opzione Visualizza registri analitici e di debug sia selezionata.

9. Abilitare il registro Analitico.

   Nella visualizzazione struttura ad albero di Visualizzatore eventi passare a Visualizzatore eventi, Registri applicazioni e servizi, Microsoft, Windows, quindi Server applicazioni-Applicazioni. Fare clic con il pulsante destro del mouse su Analitico e scegliere Attiva registro.

Per eseguire il test del servizio

1. Tornare a client di prova WCF, fare doppio clic su Divide e mantenere i valori predefiniti che specificano un valore per il denominatore pari a 0.

   Se il valore del denominatore è 0, il servizio genererà un errore.

2. Osservare gli eventi creati dal servizio.

   Tornare a Visualizzatore eventi e passare a Visualizzatore eventi, Registri applicazioni e servizi, Microsoft, WCF, WF-Sviluppo. Fare clic con il pulsante destro del mouse su Analitico e scegliere Aggiorna.

   Gli eventi di traccia analitici di WCF verranno visualizzati nel Visualizzatore eventi. Si noti che poiché un errore è stato generato dal servizio, nel Visualizzatori eventi viene visualizzato un evento traccia di errore.

3. Ripetere i passaggi 1 e 2 con valori di input validi. Il valore del parametro N2 deve essere un numero diverso da 0.

   Aggiornare il canale analitico per visualizzare gli eventi WCF e osservare come non includano alcun evento di errore.

Nell'esempio vengono illustrati gli eventi di traccia analitici creati da un servizio WCF.

Per eseguire la pulizia (facoltativo)

1. Aprire Visualizzatore eventi.

2. Passare a Visualizzatore eventi, Registri applicazioni e servizi, Microsoft, Windows, quindi Server applicazioni-Applicazioni. Fare clic con il pulsante destro del mouse su Analitico e scegliere Disattiva registro.

3. Passare a Visualizzatore eventi, Registri applicazioni e servizi, Microsoft, Windows, quindi Server applicazioni-Applicazioni. Fare clic con il pulsante destro del mouse su Analitico e scegliere Cancella registro.

4. Scegliere l'opzione Cancella per cancellare gli eventi.

Nota:

È possibile che gli esempi siano già installati nel computer. Verificare la directory seguente (impostazione predefinita) prima di continuare. <UnitàInstallazione>:\WF_WCF_Samples Se questa directory non esiste, vedere la pagina relativa agli esempi di Windows Communication Foundation (WCF) e Windows Workflow Foundation (WF) per .NET Framework 4 per scaricare tutti gli esempi Windows Communication Foundation (WCF) e WF. Questo esempio si trova nella directory seguente. <UnitàInstallazione>:\WF_WCF_Samples\WCF\Basic\Management\ETWTracing