Risoluzione dei problemi di Servizi Cloud tramite Application InsightsTroubleshoot Cloud Services using Application Insights

Con Azure SDK 2.8 e l'estensione Diagnostica di Azure 1.5 è possibile inviare i dati del servizio Diagnostica di Azure per il servizio cloud direttamente ad Application Insights.With Azure SDK 2.8 and Azure diagnostics extension 1.5, you can send Azure Diagnostics data for your Cloud Service directly to Application Insights. I log raccolti da Diagnostica di Azure, tra cui log applicazioni, registri eventi di Windows, log ETW e contatori delle prestazioni possono essere inviati ad Application Insights.The logs collected by Azure Diagnostics—including application logs, Windows Event Logs, ETW Logs, and performance counters—can be sent to Application Insights. È quindi possibile visualizzare queste informazioni nell'interfaccia utente del portale Application Insights.You can then visualize this information in the Application Insights portal UI. Si può poi usare Application Insights SDK per ottenere informazioni dettagliate sulle metriche e i log provenienti dall'applicazione, nonché sui dati del livello di sistema e dell'infrastruttura provenienti da Diagnostica di Azure.You can then use the Application Insights SDK to get insights into metrics and logs that come from your application, as well as the system and infrastructure-level data that comes from Azure Diagnostics.

Configurare Diagnostica di Azure per inviare dati ad Application InsightsConfigure Azure Diagnostics to send data to Application Insights

Seguire questi passaggi per configurare il progetto del servizio cloud per l'invio di dati del servizio Diagnostica di Azure ad Application Insights.Follow these steps to set up your cloud service project to send Azure Diagnostics data to Application Insights.

  1. In Esplora soluzioni di Visual Studio fare clic con il pulsante destro del mouse su un ruolo e scegliere Proprietà per aprire la finestra di progettazione dei ruoli.In Visual Studio Solution Explorer, right-click a role and select Properties to open the Role designer.

    Proprietà del ruolo di Esplora soluzioni

  2. Nella sezione Diagnostica della finestra di progettazione dei ruoli selezionare l'opzione Invia i dati di diagnostica ad Application Insights.In the Diagnostics section of the Role designer, select the Send diagnostics data to Application Insights option.

    La finestra di progettazione dei ruoli invia dati di diagnostica ad Application Insights

  3. Nella finestra di dialogo visualizzata selezionare la risorsa di Application Insights a cui si vogliono inviare i dati del servizio Diagnostica di Azure.In the dialog box that pops up, select the Application Insights resource that you want to send the Azure diagnostics data to. La finestra di dialogo consente di selezionare una risorsa di Application Insights esistente dalla sottoscrizione o di specificare manualmente una chiave di strumentazione per una risorsa di Application Insights.The dialog box allows you to select an existing Application Insights resource from your subscription or to manually specify an instrumentation key for an Application Insights resource. Per altre informazioni sulla creazione di una risorsa di Application Insights, vedere Creare una nuova risorsa di Application Insights.For more information on creating an Application Insights resource, see Create a new Application Insights resource.

    selezionare una risorsa di Application Insights

    Dopo aver aggiunto la risorsa di Application Insights, la chiave di strumentazione per la risorsa viene archiviata come impostazione di configurazione del servizio con il nome APPINSIGHTS_INSTRUMENTATIONKEY.Once you have added the Application Insights resource, the instrumentation key for that resource is stored as a service configuration setting with the name APPINSIGHTS_INSTRUMENTATIONKEY. È possibile modificare questa impostazione di configurazione per ogni configurazione del servizio o ambiente.You can change this configuration setting for each service configuration or environment. A tale scopo, selezionare una configurazione diversa nell'elenco Configurazione servizio e specificare una nuova chiave di strumentazione per la configurazione.To do so, select a different configuration from the Service Configuration list and specify a new instrumentation key for that configuration.

    selezionare una configurazione del servizio

    L'impostazione di configurazione APPINSIGHTS_INSTRUMENTATIONKEY viene usata da Visual Studio per configurare l'estensione di diagnostica con le informazioni appropriate sulle risorse di Application Insights durante la pubblicazione.The APPINSIGHTS_INSTRUMENTATIONKEY configuration setting is used by Visual Studio to configure the diagnostics extension with the appropriate Application Insights resource information during publishing. L'impostazione di configurazione è un modo pratico per definire chiavi di strumentazione diverse per configurazioni del servizio diverse.The configuration setting is a convenient way of defining different instrumentation keys for different service configurations. Visual Studio converte tale impostazione e la inserisce nella configurazione pubblica dell'estensione di diagnostica durante il processo di pubblicazione.Visual Studio will translate that setting and insert it into the diagnostics extension public configuration during the publish process. Per semplificare il processo di configurazione dell'estensione di diagnostica con PowerShell, l'output del pacchetto di Visual Studio contiene anche il codice XML di configurazione pubblica con la chiave di strumentazione corretta di Application Insights.To simplify the process of configuring the diagnostics extension with PowerShell, the package output from Visual Studio also contains the public configuration XML with the appropriate Application Insights instrumentation key. I file di configurazione pubblica vengono creati nella cartella Extensions e seguono il modello PaaSDiagnostics.<RoleName>.PubConfig.xml.The public config files are created in the Extensions folder and follow the pattern PaaSDiagnostics.<RoleName>.PubConfig.xml. Eventuali distribuzioni basate su PowerShell possono usare questo modello per il mapping di ogni configurazione a un ruolo.Any PowerShell-based deployments can use this pattern to map each configuration to a role.

4) Per configurare il servizio Diagnostica di Azure per inviare tutti i contatori delle prestazioni e i log a livello di errore raccolti dall'agente di Diagnostica di Azure ad Application Insights, abilitare l'opzione Invia i dati di diagnostica ad Application Insights.To configure Azure diagnostics to send all performance counters and error-level logs collected by the Azure diagnostics agent to Application Insights, enable the Send diagnostics data to Application Insights option.

<span data-ttu-id="d2cfb-129">Se si vogliono configurare ulteriormente i dati inviati ad Application Insights, è necessario modificare manualmente il file *diagnostics.wadcfgx* per ogni ruolo.</span><span class="sxs-lookup"><span data-stu-id="d2cfb-129">If you want to further configure what data is sent to Application Insights, you must manually edit the *diagnostics.wadcfgx* file for each role.</span></span> <span data-ttu-id="d2cfb-130">Per altre informazioni sull'aggiornamento manuale della configurazione, vedere l'articolo relativo alla [configurazione di Diagnostica di Azure per inviare dati ad Application Insights](#configure-azure-diagnostics-to-send-data-to-application-insights) .</span><span class="sxs-lookup"><span data-stu-id="d2cfb-130">See [Configure Azure Diagnostics to send data to Application Insights](#configure-azure-diagnostics-to-send-data-to-application-insights) to learn more about manually updating the configuration.</span></span>

Quando il servizio cloud è configurato per l'invio di dati del servizio Diagnostica di Azure ad Application Insights, è possibile distribuirlo in Azure normalmente, verificando che l'estensione della diagnostica di Azure sia abilitata.When the cloud service is configured to send Azure diagnostics data to application insights, you can deploy it to Azure normally, making sure the Azure diagnostics extension is enabled. Per altre informazioni, vedere Pubblicazione di un servizio cloud di Azure con Visual Studio.For more information, see Publishing a Cloud Service using Visual Studio.

Visualizzazione dei dati del servizio Diagnostica di Azure in Application InsightsViewing Azure diagnostics data in Application Insights

La telemetria diagnostica di Azure viene visualizzata nella risorsa di Application Insights configurata per il servizio cloud.The Azure diagnostic telemetry shows up in the Application Insights resource configured for your cloud service.

I tipi di log di Diagnostica di Azure vengono mappati ai concetti di Application Insights in questi modi:Azure diagnostics log types map to Application Insights concepts in these ways:

  • I contatori delle prestazioni vengono visualizzati come metriche personalizzate in Application Insights.Performance counters are displayed as Custom Metrics in Application Insights.
  • I registri eventi di Windows vengono visualizzati come tracce ed eventi personalizzati in Application Insights.Windows Event Logs are shown as Traces and Custom Events in Application Insights.
  • I log applicazioni, i log ETW e gli eventuali log dell'infrastruttura di diagnostica vengono visualizzati come tracce in Application Insights.Application logs, ETW logs, and any Diagnostics Infrastructure logs are shown as Traces in Application Insights.

Per visualizzare i dati del servizio Diagnostica di Azure in Application Insights, eseguire una delle operazioni seguenti:To view Azure diagnostics data in Application Insights, do one of the following:

  • Usare Esplora metriche per visualizzare tutti i contatori delle prestazioni personalizzati o i conteggi di diversi tipi di eventi del registro eventi di Windows.Use Metrics explorer to visualize any custom performance counters or counts of different types of Windows Event Log events.

    Metriche personalizzate in Esplora metriche

  • Usare Cerca per eseguire ricerche nei log di traccia inviati da Diagnostica di Azure.Use Search to search across the trace logs sent by Azure Diagnostics. Se un'eccezione non gestita ha causato l'arresto anomalo e il riciclo del ruolo, ad esempio, le informazioni sull'eccezione vengono visualizzate nel canale Applicazione del registro eventi di Windows.For example, if an unhandled exception has caused the role to crash and recycle, information about the exception shows up in the Application channel of Windows Event Log. È possibile usare la funzionalità di ricerca per esaminare l'errore del registro eventi di Windows e ottenere l'analisi dello stack completa per l'eccezione per trovare più facilmente la causa del problema.You can use search to look at the Windows Event Log error and get the full stack trace for the exception to help find the cause of the issue.

    Cerca tracce

Passaggi successiviNext Steps

  • Aggiungere Application Insights SDK al servizio cloud per inviare dati relativi a richieste, eccezioni, dipendenze ed eventuale telemetria personalizzata dall'applicazione.Add the Application Insights SDK to your cloud service to send data about requests, exceptions, dependencies, and any custom telemetry from your application. In combinazione con i dati del servizio Diagnostica di Azure, queste informazioni offriranno una visione completa dell'applicazione e del sistema nella stessa risorsa di Application Insight.When combined with the Azure Diagnostics data, this information you can get a complete view of your application and system, all in the same Application Insight resource.