Tracciare il flusso in un'applicazione di Servizi cloud con Diagnostica di AzureTrace the flow of a Cloud Services application with Azure Diagnostics

Tracciare è una delle azioni a cui è possibile ricorrere per monitorare l'esecuzione di un'applicazione mentre è attiva.Tracing is a way for you to monitor the execution of your application while it is running. È possibile usare le classi System.Diagnostics.Trace, System.Diagnostics.Debug e System.Diagnostics.TraceSource per registrare informazioni sull'esecuzione dell'applicazione ed eventuali errori in file di log, file di testo o altri dispositivi per un'analisi successiva.You can use the System.Diagnostics.Trace, System.Diagnostics.Debug, and System.Diagnostics.TraceSource classes to record information about errors and application execution in logs, text files, or other devices for later analysis. Per altre informazioni sulle funzionalità di traccia, vedere l'articolo sulle modalità per tracciare e instrumentare applicazioni.For more information about tracing, see Tracing and Instrumenting Applications.

Usare istruzioni e opzioni di tracciaUse trace statements and trace switches

Per implementare funzionalità di traccia in un'applicazione di Servizi cloud, è possibile aggiungere DiagnosticMonitorTraceListener alla configurazione dell'applicazione ed effettuare chiamate a System.Diagnostics.Trace o System.Diagnostics.Debug nel codice dell'applicazione.Implement tracing in your Cloud Services application by adding the DiagnosticMonitorTraceListener to the application configuration and making calls to System.Diagnostics.Trace or System.Diagnostics.Debug in your application code. Usare il file di configurazione app.config per i ruoli di lavoro e web.config per i ruoli Web.Use the configuration file app.config for worker roles and the web.config for web roles. Quando si crea un nuovo servizio ospitato usando un modello di Visual Studio, Diagnostica di Azure viene automaticamente aggiunto al progetto e DiagnosticMonitorTraceListener viene aggiunto al file di configurazione appropriato per i ruoli aggiunti.When you create a new hosted service using a Visual Studio template, Azure Diagnostics is automatically added to the project and the DiagnosticMonitorTraceListener is added to the appropriate configuration file for the roles that you add.

Per informazioni sull'inserimento di istruzioni di traccia, vedere la procedura per aggiungere istruzioni di traccia al codice di un'applicazione.For information on placing trace statements, see How to: Add Trace Statements to Application Code.

Inserendo opzioni di traccia nel codice, è possibile controllare se la traccia viene eseguita e con quale copertura.By placing Trace Switches in your code, you can control whether tracing occurs and how extensive it is. In questo modo, è possibile monitorare lo stato dell'applicazione in un ambiente di produzione.This lets you monitor the status of your application in a production environment. Questo aspetto è particolarmente importante in un'applicazione aziendale che usa più componenti in esecuzione su più computer.This is especially important in a business application that uses multiple components running on multiple computers. Per altre informazioni, vedere la procedura per configurare opzioni di traccia.For more information, see How to: Configure Trace Switches.

Configurare il listener di traccia in un'applicazione AzureConfigure the trace listener in an Azure application

Quando si usano le classi Traccia, Debug e TraceSource, è necessario impostare dei "listener" per raccogliere e registrare i messaggi inviati.Trace, Debug and TraceSource, require you set up "listeners" to collect and record the messages that are sent. I listener raccolgono, archiviano e indirizzano i messaggi di traccia,Listeners collect, store, and route tracing messages. quindi indirizzano l'output di traccia su una destinazione appropriata, ad esempio un log, una finestra o un file di testo.They direct the tracing output to an appropriate target, such as a log, window, or text file. Diagnostica di Azure usa la classe DiagnosticMonitorTraceListener.Azure Diagnostics uses the DiagnosticMonitorTraceListener class.

Prima di completare la procedura seguente, è necessario inizializzare il monitor di diagnostica di Azure.Before you complete the following procedure, you must initialize the Azure diagnostic monitor. A tale scopo, vedere Abilitazione di Diagnostica in Microsoft Azure.To do this, see Enabling Diagnostics in Microsoft Azure.

Se si usano i modelli disponibili in Visual Studio, la configurazione del listener viene aggiunta automaticamente.Note that if you use the templates that are provided by Visual Studio, the configuration of the listener is added automatically for you.

Aggiungere un listener di tracciaAdd a trace listener

  1. Aprire il file web.config o app.config, in base al ruolo selezionato.Open the web.config or app.config file for your role.
  2. Aggiungere il codice seguente al file.Add the following code to the file. Modificare l'attributo Version impostando il numero di versione dell'assembly a cui si fa riferimento.Change the Version attribute to use the version number of the assembly you are referencing. La versione dell'assembly non cambia necessariamente con ogni versione di Azure SDK a meno che non vengano resi disponibili aggiornamenti.The assembly version does not necessarily change with each Azure SDK release unless there are updates to it.

    <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

    Accertarsi di avere un riferimento progetto all'assembly Microsoft.WindowsAzure.Diagnostics.Make sure you have a project reference to the Microsoft.WindowsAzure.Diagnostics assembly. Aggiornare il numero di versione nel file xml precedente in base alla versione dell'assembly di riferimento Microsoft.WindowsAzure.Diagnostics.Update the version number in the xml above to match the version of the referenced Microsoft.WindowsAzure.Diagnostics assembly.

  3. Salvare il file di configurazione.Save the config file.

Per altre informazioni sui listener, vedere l'articolo sui listener di traccia.For more information about listeners, see Trace Listeners.

Dopo aver completato i passaggi necessari per aggiungere il listener, è possibile aggiungere istruzioni di traccia al codice.After you complete the steps to add the listener, you can add trace statements to your code.

Per aggiungere un'istruzione di traccia al codiceTo add trace statement to your code

  1. Aprire un file di origine per l'applicazione,Open a source file for your application. ad esempio il file .cs per il ruolo di lavoro o il ruolo Web.For example, the .cs file for the worker role or web role.
  2. Aggiungere l'istruzione using seguente, se non è già presente:Add the following using statement if it has not already been added: using System.Diagnostics;
  3. Aggiungere istruzioni di traccia nei punti in cui si desidera acquisire informazioni sullo stato dell'applicazione.Add Trace statements where you want to capture information about the state of your application. È possibile usare vari metodi per formattare l'output dell'istruzione di traccia.You can use a variety of methods to format the output of the Trace statement. Per altre informazioni, vedere la procedura per aggiungere istruzioni di traccia al codice dell'applicazione.For more information, see How to: Add Trace Statements to Application Code.
  4. Salvare il file di origine.Save the source file.