Monitoraggio delle prestazioni applicative per i servizi app di Azure e ASP.NET Core.

  • Articolo

L'abilitazione del monitoraggio sulle applicazioni Web basate su core ASP.NET in esecuzione in app Azure Service è ora più semplice che mai. In precedenza, era necessario instrumentare manualmente l'app. A questo punto, l'estensione o l'agente più recente è integrato nell'immagine servizio app per impostazione predefinita. Questo articolo illustra come abilitare il monitoraggio di Application Insights di Monitoraggio di Azure. Fornisce inoltre indicazioni preliminari per automatizzare il processo per le distribuzioni su larga scala.

Nota

Il 31 marzo 2025, il supporto per l'inserimento delle chiavi di strumentazione terminerà. L'inserimento di chiavi di strumentazione continuerà a funzionare, ma non forniamo più aggiornamenti o supporto per la funzionalità. Passare alle stringa di connessione per sfruttare le nuove funzionalità.

Abilitare il monitoraggio della strumentazione automatica

Per un elenco completo degli scenari di strumentazione automatica supportati, vedere Ambienti, lingue e provider di risorse supportati.

Importante

Solo il supporto a lungo termine di .NET Core è supportato per l'strumentazione automatica in Windows.

Le distribuzioni autonome di trim non sono supportate. Usare la strumentazione manuale tramite codice.

Nota

Strumentazione automatica usata per essere nota come "collegamento senza codice" prima di ottobre 2021.

Vedere la sezione Abilitare il monitoraggio seguente per iniziare a configurare Application Insights con la risorsa servizio app.

Abilitare il monitoraggio

  1. Selezionare Application Insights nel riquadro sinistro per il servizio app. Selezionare quindi Abilita.

    Screenshot che mostra la scheda Application Insights con l'opzione Abilita selezionata.

  2. Creare una nuova risorsa o selezionare una risorsa di Application Insights esistente per questa applicazione.

    Nota

    Quando si seleziona OK per creare una nuova risorsa, viene richiesto di applicare le impostazioni di monitoraggio. Selezionando Continua si collega la nuova risorsa di Application Insights al servizio app. Il servizio app viene quindi riavviato.

    Screenshot che mostra l'elenco a discesa Cambia risorsa.

  3. Dopo aver specificato la risorsa da usare, è possibile scegliere come si vuole che Application Insights raccolga i dati per ogni piattaforma per l'applicazione. ASP.NET opzioni di raccolta core sono consigliate o disabilitate.

    Screenshot che mostra la sezione strumentazione dell'applicazione.

Abilitare il monitoraggio lato client

Il monitoraggio lato client è abilitato per impostazione predefinita per ASP.NET app Core con raccolta consigliata , indipendentemente dal fatto che l'impostazione APPINSIGHTS_JAVASCRIPT_ENABLED dell'app sia presente.

Se si vuole disabilitare il monitoraggio lato client:

  1. Selezionare Impostazioni>Configurazione.

  2. In Impostazioni applicazione creare un'impostazione Nuova applicazione con le informazioni seguenti:

    • Nome: APPINSIGHTS_JAVASCRIPT_ENABLED
    • Valore: false

  3. Fare clic su Save (Salva) per salvare le impostazioni. Riavviare l'app.

Automatizzare il monitoraggio

Per abilitare la raccolta di dati di telemetria con Application Insights, è necessario impostare solo le impostazioni dell'applicazione.

Screenshot che mostra servizio app impostazioni dell'applicazione con le impostazioni di Application Insights.

Definizioni delle impostazioni dell'applicazione

Nome impostazione app Definizione Valore
ApplicationInsightsAgent_EXTENSION_VERSION Estensione principale, che controlla il monitoraggio del runtime. ~2 per Windows o ~3 per Linux
XDT_MicrosoftApplicationInsights_Mode In modalità predefinita sono abilitate solo le funzionalità essenziali per garantire prestazioni ottimali. disabled o recommended.
XDT_MicrosoftApplicationInsights_PreemptSdk Solo per le app core di ASP.NET. Abilita l'interoperabilità (interoperabilità) con Application Insights SDK. Carica l'estensione side-by-side con l'SDK e la usa per inviare i dati di telemetria. Disabilita Application Insights SDK. 1

servizio app impostazioni dell'applicazione con Azure Resource Manager

Le impostazioni dell'applicazione per app Azure Servizio possono essere gestite e configurate con i modelli di Azure Resource Manager. È possibile usare questo metodo quando si distribuiscono nuove risorse servizio app con l'automazione di Resource Manager o si modificano le impostazioni delle risorse esistenti.

Struttura di base del codice JSON delle impostazioni dell'applicazione per una risorsa servizio app:

      "resources": [
        {
          "name": "appsettings",
          "type": "config",
          "apiVersion": "2015-08-01",
          "dependsOn": [
            "[resourceId('Microsoft.Web/sites', variables('webSiteName'))]"
          ],
          "tags": {
            "displayName": "Application Insights Settings"
          },
          "properties": {
            "key1": "value1",
            "key2": "value2"
          }
        }
      ]

Per un esempio di modello di Resource Manager con le impostazioni dell'applicazione configurate per Application Insights, questo modello può essere utile. In particolare, vedere la sezione che inizia alla riga 238.

Per creare un modello di Resource Manager con le impostazioni predefinite di Application Insights, iniziare il processo come se si intendesse creare una nuova app Web con Application Insights abilitato.

  1. Creare una nuova risorsa servizio app con le informazioni desiderate sull'app Web. Abilitare Application Insights nella scheda Monitoraggio .

  2. Selezionare Rivedi e crea. Selezionare quindi Scarica un modello per l'automazione.

    Screenshot che mostra il menu di creazione dell'app Web servizio app.

    Questa opzione genera il modello di Resource Manager più recente con tutte le impostazioni necessarie configurate.

    Screenshot che mostra un modello di app Web servizio app.

Nell'esempio seguente sostituire tutte le istanze di con il nome del AppMonitoredSite sito:

Nota

Se si usa Windows, impostare su ApplicationInsightsAgent_EXTENSION_VERSION~2. Se si usa Linux, impostare su ApplicationInsightsAgent_EXTENSION_VERSION~3.

{
    "resources": [
        {
            "name": "[parameters('name')]",
            "type": "Microsoft.Web/sites",
            "properties": {
                "siteConfig": {
                    "appSettings": [
                        {
                            "name": "APPINSIGHTS_INSTRUMENTATIONKEY",
                            "value": "[reference('microsoft.insights/components/AppMonitoredSite', '2015-05-01').InstrumentationKey]"
                        },
                        {
                            "name": "APPLICATIONINSIGHTS_CONNECTION_STRING",
                            "value": "[reference('microsoft.insights/components/AppMonitoredSite', '2015-05-01').ConnectionString]"
                        },
                        {
                            "name": "ApplicationInsightsAgent_EXTENSION_VERSION",
                            "value": "~2"
                        }
                    ]
                },
                "name": "[parameters('name')]",
                "serverFarmId": "[concat('/subscriptions/', parameters('subscriptionId'),'/resourcegroups/', parameters('serverFarmResourceGroup'), '/providers/Microsoft.Web/serverfarms/', parameters('hostingPlanName'))]",
                "hostingEnvironment": "[parameters('hostingEnvironment')]"
            },
            "dependsOn": [
                "[concat('Microsoft.Web/serverfarms/', parameters('hostingPlanName'))]",
                "microsoft.insights/components/AppMonitoredSite"
            ],
            "apiVersion": "2016-03-01",
            "location": "[parameters('location')]"
        },
        {
            "apiVersion": "2016-09-01",
            "name": "[parameters('hostingPlanName')]",
            "type": "Microsoft.Web/serverfarms",
            "location": "[parameters('location')]",
            "properties": {
                "name": "[parameters('hostingPlanName')]",
                "workerSizeId": "[parameters('workerSize')]",
                "numberOfWorkers": "1",
                "hostingEnvironment": "[parameters('hostingEnvironment')]"
            },
            "sku": {
                "Tier": "[parameters('sku')]",
                "Name": "[parameters('skuCode')]"
            }
        },
        {
            "apiVersion": "2015-05-01",
            "name": "AppMonitoredSite",
            "type": "microsoft.insights/components",
            "location": "West US 2",
            "properties": {
                "ApplicationId": "[parameters('name')]",
                "Request_Source": "IbizaWebAppExtensionCreate"
            }
        }
    ],
    "parameters": {
        "name": {
            "type": "string"
        },
        "hostingPlanName": {
            "type": "string"
        },
        "hostingEnvironment": {
            "type": "string"
        },
        "location": {
            "type": "string"
        },
        "sku": {
            "type": "string"
        },
        "skuCode": {
            "type": "string"
        },
        "workerSize": {
            "type": "string"
        },
        "serverFarmResourceGroup": {
            "type": "string"
        },
        "subscriptionId": {
            "type": "string"
        }
    },
    "$schema": "https://schema.management.azure.com/schemas/2014-04-01-preview/deploymentTemplate.json#",
    "contentVersion": "1.0.0.0"
}

Abilitare tramite PowerShell

Per abilitare il monitoraggio delle applicazioni tramite PowerShell, è necessario modificare solo le impostazioni dell'applicazione sottostanti. L'esempio seguente abilita il monitoraggio delle applicazioni per un sito Web denominato AppMonitoredSite nel gruppo AppMonitoredRGdi risorse . Configura i dati da inviare alla chiave di 012345678-abcd-ef01-2345-6789abcd strumentazione.

Nota

È consigliabile usare il modulo Azure Az PowerShell per interagire con Azure. Per iniziare, vedere Installare Azure PowerShell. Per informazioni su come eseguire la migrazione al modulo AZ PowerShell, vedere Eseguire la migrazione di Azure PowerShell da AzureRM ad Az.

Nota

Se si usa Windows, impostare ApplicationInsightsAgent_EXTENSION_VERSION su ~2. Se si usa Linux, impostare ApplicationInsightsAgent_EXTENSION_VERSION su ~3.

$app = Get-AzWebApp -ResourceGroupName "AppMonitoredRG" -Name "AppMonitoredSite" -ErrorAction Stop
$newAppSettings = @{} # case-insensitive hash map
$app.SiteConfig.AppSettings | %{$newAppSettings[$_.Name] = $_.Value} # preserve non Application Insights application settings.
$newAppSettings["APPINSIGHTS_INSTRUMENTATIONKEY"] = "012345678-abcd-ef01-2345-6789abcd"; # set the Application Insights instrumentation key
$newAppSettings["APPLICATIONINSIGHTS_CONNECTION_STRING"] = "InstrumentationKey=012345678-abcd-ef01-2345-6789abcd"; # set the Application Insights connection string
$newAppSettings["ApplicationInsightsAgent_EXTENSION_VERSION"] = "~2"; # enable the ApplicationInsightsAgent
$app = Set-AzWebApp -AppSettings $newAppSettings -ResourceGroupName $app.ResourceGroup -Name $app.Name -ErrorAction Stop

Aggiornare l'estensione/agente di monitoraggio - .NET

Per aggiornare l'estensione/agente di monitoraggio, seguire la procedura descritta nelle sezioni successive.

Eseguire l'aggiornamento dalle versioni 2.8.9 e successive

L'aggiornamento dalla versione 2.8.9 viene eseguito automaticamente, senza azioni aggiuntive. I nuovi bit di monitoraggio vengono recapitati in background al servizio app di destinazione e al riavvio dell'applicazione verranno prelevati.

Per verificare la versione dell'estensione in esecuzione, passare a https://yoursitename.scm.azurewebsites.net/ApplicationInsights.

Screenshot che mostra il percorso URL per controllare la versione dell'estensione in esecuzione.

Eseguire l'aggiornamento dalle versioni 1.0.0 - 2.6.5

A partire dalla versione 2.8.9, viene usata l'estensione del sito preinstallata. Se si usa una versione precedente, è possibile eseguire l'aggiornamento tramite uno dei due modi seguenti:

Se l'aggiornamento viene eseguito da una versione precedente alla 2.5.1, verificare che le ApplicationInsights DLL vengano rimosse dalla cartella bin dell'applicazione. Per altre informazioni, vedere Procedura di risoluzione dei problemi.

Risoluzione dei problemi

Nota

Quando si crea un'app Web con i ASP.NET Core runtime in servizio app, viene distribuita una singola pagina HTML statica come sito Web iniziale. Non è consigliabile risolvere un problema con il modello predefinito. Distribuire un'applicazione prima di risolvere un problema.

Di seguito è disponibile la guida dettagliata alla risoluzione dei problemi per il monitoraggio basato su estensione/agente per le applicazioni basate su core ASP.NET in esecuzione in servizio app.

  1. Verificare che l'impostazione dell'app ApplicationInsightsAgent_EXTENSION_VERSION sia impostata su un valore .~2

  2. Passa a https://yoursitename.scm.azurewebsites.net/ApplicationInsights.

    Screenshot che mostra il collegamento sopra la pagina dei risultati.

    • Verificare che lo stato dell'estensione di Application Insights sia Pre-Installed Site Extension, version 2.8.x.xxxx, is running.

      Se non è in esecuzione, seguire le istruzioni nella sezione Abilitare il monitoraggio di Application Insights.

    • Verificare che l'origine di stato esista e abbia un aspetto simile a Status source D:\home\LogFiles\ApplicationInsights\status\status_RD0003FF0317B6_4248_1.json.

      Se non è presente un valore simile, significa che l'applicazione non è attualmente in esecuzione o non è supportata. Per assicurarsi che l'applicazione sia in esecuzione, provare a visitare manualmente l'URL dell'applicazione/gli endpoint dell'applicazione, che consentirà la disponibilità delle informazioni di runtime.

    • Verificare che IKeyExists sia True. Se è False, aggiungere APPINSIGHTS_INSTRUMENTATIONKEY e APPLICATIONINSIGHTS_CONNECTION_STRING con il GUID di ikey alle impostazioni dell'applicazione.

    • Se l'applicazione fa riferimento a qualsiasi pacchetto di Application Insights, l'abilitazione dell'integrazione servizio app potrebbe non essere effettiva e i dati potrebbero non essere visualizzati in Application Insights. Un esempio è se hai instrumentato o tentato di instrumentare l'app con ASP.NET Core SDK. Per risolvere il problema, nel portale attivare Interoperabilità con Application Insights SDK. Si inizierà a visualizzare i dati in Application Insights.

      Importante

      Questa funzionalità è in anteprima.

      Screenshot che mostra l'impostazione di interoperabilità abilitata.

      I dati verranno ora inviati usando un approccio senza codice, anche se Application Insights SDK è stato originariamente usato o ha tentato di usarli.

      Importante

      Se l'applicazione usa Application Insights SDK per inviare dati di telemetria, i dati di telemetria verranno disabilitati. In altre parole, i dati di telemetria personalizzati (ad esempio, qualsiasi Track*() metodo) e le impostazioni personalizzate (ad esempio il campionamento) verranno disabilitate.

Il sito Web predefinito distribuito con le app Web non supporta il monitoraggio lato client automatico

Quando si crea un'app Web con i runtime di ASP.NET Core in servizio app, viene distribuita una singola pagina HTML statica come sito Web iniziale. La pagina Web statica carica anche un ASP. Web part gestita da NET in IIS. Questo comportamento consente di testare il monitoraggio lato server senza codice, ma non supporta il monitoraggio lato client automatico.

Per testare il server senza codice e il monitoraggio lato client per ASP.NET Core in un'app Web servizio app, è consigliabile seguire le guide ufficiali per la creazione di un'app Web ASP.NET Core. Usare quindi le istruzioni nell'articolo corrente per abilitare il monitoraggio.

Qual è la differenza tra le metriche standard di Application Insights e le metriche del servizio app Azure?

Application Insights raccoglie i dati di telemetria per le richieste inviate all'applicazione. Se l'errore si verifica in WebApps/WebServer e la richiesta non ha raggiunto l'applicazione utente, Application Insights non dispone di dati di telemetria su di esso.

La durata per serverresponsetime calcolata da Application Insights non corrisponde necessariamente al tempo di risposta del server osservato da App Web. Questo comportamento è dovuto al fatto che Application Insights conta solo la durata quando la richiesta raggiunge effettivamente l'applicazione utente. Se la richiesta è bloccata o in coda in WebServer, il tempo di attesa viene incluso nelle metriche di App Web ma non nelle metriche di Application Insights.

Testare la connettività tra l'host dell'applicazione e il servizio di inserimento

Gli SDK e gli agenti di Application Insights inviano dati di telemetria per essere inseriti come chiamate REST agli endpoint di inserimento. È possibile testare la connettività dal server Web o dal computer host dell'applicazione agli endpoint del servizio di inserimento usando client REST non elaborati da PowerShell o comandi curl. Vedere Risolvere i problemi di telemetria delle applicazioni mancanti in Application Insights di Monitoraggio di Azure.

PHP e WordPress non sono supportati

I siti PHP e WordPress non sono supportati. Attualmente non è disponibile alcun SDK/agente supportato ufficialmente per il monitoraggio lato server di questi carichi di lavoro. Per instrumentare manualmente le transazioni sul lato client in un sito PHP o WordPress aggiungendo javaScript sul lato client alle pagine Web, usare JavaScript SDK.

La tabella seguente fornisce una spiegazione del significato di questi valori, delle cause sottostanti e delle correzioni consigliate.

Valore del problema Spiegazione Fix
AppAlreadyInstrumented:true Questo valore indica che l'estensione ha rilevato che alcuni aspetti dell'SDK sono già presenti nell'applicazione e che verranno nuovamente disattivati. Può essere dovuto a un riferimento a Microsoft.ApplicationInsights.AspNetCore o Microsoft.ApplicationInsights. Rimuovere i riferimenti. Alcuni di questi riferimenti vengono aggiunti per impostazione predefinita da determinati modelli di Visual Studio. Le versioni precedenti di Visual Studio fanno riferimento Microsoft.ApplicationInsightsa .
AppAlreadyInstrumented:true Questo valore può anche essere causato dalla presenza di Microsoft.ApplicationsInsights DLL nella cartella dell'app da una distribuzione precedente. Pulire la cartella dell'app per assicurarsi che queste DLL vengano rimosse. Controllare sia la directory bin dell'app locale che la directory wwwroot nel servizio app. Per controllare la directory wwwroot dell'app Web servizio app, selezionare Strumenti avanzati (Kudu)> Console di debug>CMD>home\site\wwwroot.
IKeyExists:false Questo valore indica che la chiave di strumentazione non è presente nell'impostazione APPINSIGHTS_INSTRUMENTATIONKEYdell'app . Le possibili cause includono la rimozione accidentale dei valori o la dimenticanza di impostare i valori nello script di automazione. Assicurarsi che l'impostazione sia presente nelle impostazioni dell'applicazione servizio app.

Note sulla versione

Per gli aggiornamenti e le correzioni di bug più recenti, vedere le note sulla versione.

Passaggi successivi