Creare una risorsa di Application Insights

Attenzione

Questo articolo si applica alle risorse classiche di Application Insights, che non sono più consigliate.

Le informazioni contenute in questo articolo non sono aggiornate e non verranno aggiornate.

Passare ad Application Insights basato sull'area di lavoro per sfruttare le nuove funzionalità.

Application Insights visualizza i dati sull'applicazione in una risorsa di Azure. La creazione di una nuova risorsa fa parte della configurazione di Application Insights per monitorare una nuova applicazione. Dopo aver creato la nuova risorsa, è possibile ottenere la chiave di strumentazione e usarla per configurare Application Insights SDK. La chiave di strumentazione collega i dati di telemetria alla risorsa.

Importante

Il 29 febbraio 2024,il supporto per Application Insights classico terminerà. Passare ad Application Insights basato sull'area di lavoro per sfruttare le nuove funzionalità. Le aree più recenti introdotte dopo febbraio 2021 non supportano la creazione di risorse classiche di Application Insights.

Nota

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

Accedere ad Azure

Se non si ha una sottoscrizione di Azure, creare un account gratuito prima di iniziare.

Creare una risorsa di Application Insights

Accedere al portale di Azure e creare una risorsa di Application Insights.

Impostazioni	Valore	Descrizione
Nome	Unique value	Nome che identifica l'app da monitorare.
Gruppo di risorse	myResourceGroup	Nome del gruppo di risorse nuovo o esistente per ospitare i dati di Application Insights.
Area	East US	Selezionare una località vicina alla posizione in cui è ospitata l'app.
Modalità risorsa	Classic o Workspace-based	Le risorse basate sull'area di lavoro consentono di inviare i dati di telemetria di Application Insights a un'area di lavoro Log Analytics comune. Per altre informazioni, vedere Risorse di Application Insights basate sull'area di lavoro.

Nota

È possibile usare lo stesso nome di risorsa in gruppi di risorse diversi, ma può essere utile usare un nome univoco globale. Se si prevede di eseguire query tra risorse, l'uso di un nome univoco globale semplifica la sintassi necessaria.

Immettere i valori appropriati nei campi obbligatori. Selezionare Rivedi e crea.

Dopo aver creato l'app, un nuovo riquadro visualizza i dati sulle prestazioni e sull'utilizzo relativi all'applicazione monitorata.

Eseguire una copia della chiave di strumentazione

La chiave di strumentazione identifica la risorsa da associare ai dati di telemetria. È necessario copiare la chiave di strumentazione e aggiungerla al codice dell'applicazione.

Installare l’SDK nell'app

Installare Application Insights SDK nell'app. Questo passaggio dipende dal tipo di applicazione.

Usare la chiave di strumentazione per configurare l'SDK installato nell'applicazione.

L'SDK include moduli standard che inviano dati di telemetria, quindi non è necessario scrivere altro codice. Per rilevare le azioni degli utenti o diagnosticare i problemi in modo più dettagliato, usare l'API per inviare dati di telemetria personalizzati.

Creare automaticamente una risorsa

Usare PowerShell o l'interfaccia della riga di comando di Azure per creare automaticamente una risorsa.

PowerShell

Creare una nuova risorsa di Application Insights.

New-AzApplicationInsights [-ResourceGroupName] <String> [-Name] <String> [-Location] <String> [-Kind <String>]
 [-Tag <Hashtable>] [-DefaultProfile <IAzureContextContainer>] [-WhatIf] [-Confirm] [<CommonParameters>]

Esempio

New-AzApplicationInsights -Kind java -ResourceGroupName testgroup -Name test1027 -location eastus

Risultati

Id                 : /subscriptions/{subid}/resourceGroups/testgroup/providers/microsoft.insights/components/test1027
ResourceGroupName  : testgroup
Name               : test1027
Kind               : web
Location           : eastus
Type               : microsoft.insights/components
AppId              : 8323fb13-32aa-46af-b467-8355cf4f8f98
ApplicationType    : web
Tags               : {}
CreationDate       : 10/27/2017 4:56:40 PM
FlowType           :
HockeyAppId        :
HockeyAppToken     :
InstrumentationKey : 00000000-aaaa-bbbb-cccc-dddddddddddd
ProvisioningState  : Succeeded
RequestSource      : AzurePowerShell
SamplingPercentage :
TenantId           : {subid}

Per la documentazione completa di PowerShell per questo cmdlet e per informazioni su come recuperare la chiave di strumentazione, vedere la documentazione di Azure PowerShell.

Interfaccia della riga di comando di Azure (anteprima)

Per accedere all'anteprima dell'interfaccia della riga di comando di Azure di Application Insights, è prima necessario eseguire:

 az extension add -n application-insights

Se non si esegue il az extension add comando, viene visualizzato un messaggio di errore che indica: az : ERROR: az monitor: 'app-insights' is not in the 'az monitor' command group. See 'az monitor --help'.

Eseguire il comando seguente per creare la risorsa di Application Insights:

az monitor app-insights component create --app
                                         --location
                                         --resource-group
                                         [--application-type]
                                         [--kind]
                                         [--tags]

Esempio

az monitor app-insights component create --app demoApp --location westus2 --kind web --resource-group demoRg --application-type web

Risultati

az monitor app-insights component create --app demoApp --location eastus --kind web --resource-group demoApp --application-type web
{
  "appId": "87ba512c-e8c9-48d7-b6eb-118d4aee2697",
  "applicationId": "demoApp",
  "applicationType": "web",
  "creationDate": "2019-08-16T18:15:59.740014+00:00",
  "etag": "\"0300edb9-0000-0100-0000-5d56f2e00000\"",
  "flowType": "Bluefield",
  "hockeyAppId": null,
  "hockeyAppToken": null,
  "id": "/subscriptions/{subid}/resourceGroups/demoApp/providers/microsoft.insights/components/demoApp",
  "instrumentationKey": "00000000-aaaa-bbbb-cccc-dddddddddddd",
  "kind": "web",
  "location": "eastus",
  "name": "demoApp",
  "provisioningState": "Succeeded",
  "requestSource": "rest",
  "resourceGroup": "demoApp",
  "samplingPercentage": null,
  "tags": {},
  "tenantId": {tenantID},
  "type": "microsoft.insights/components"
}

Per la documentazione completa dell'interfaccia della riga di comando di Azure per questo comando e per informazioni su come recuperare la chiave di strumentazione, vedere la documentazione dell'interfaccia della riga di comando di Azure.

Eseguire l'override degli endpoint predefiniti

Avviso

Non modificare gli endpoint. Transizione alle stringhe di connessione per semplificare la configurazione ed eliminare la necessità di modifica dell'endpoint.

Per inviare dati da Application Insights a determinate aree, è necessario eseguire l'override degli indirizzi endpoint predefiniti. Ogni SDK richiede modifiche leggermente diverse, tutte descritte in questo articolo.

Queste modifiche richiedono di modificare il codice di esempio e sostituire i valori segnaposto per QuickPulse_Endpoint_Address, TelemetryChannel_Endpoint_Addresse Profile_Query_Endpoint_address con gli indirizzi endpoint effettivi per l'area specifica. La fine di questo articolo contiene collegamenti agli indirizzi endpoint per le aree in cui è necessaria questa configurazione.

Nota

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

---

Modifiche al codice SDK

.NET

Nota

Il file applicationinsights.config viene sovrascritto automaticamente ogni volta che viene eseguito un aggiornamento dell'SDK. Dopo aver eseguito un aggiornamento dell'SDK, assicurarsi di immettere nuovamente i valori di endpoint specifici dell'area.

<ApplicationInsights>
  ...
  <TelemetryModules>
    <Add Type="Microsoft.ApplicationInsights.Extensibility.PerfCounterCollector.QuickPulse.QuickPulseTelemetryModule, Microsoft.AI.PerfCounterCollector">
      <QuickPulseServiceEndpoint>Custom_QuickPulse_Endpoint_Address</QuickPulseServiceEndpoint>
    </Add>
  </TelemetryModules>
   ...
  <TelemetrySinks>
    <Add Name = "default">
      <TelemetryChannel>
         <EndpointAddress>TelemetryChannel_Endpoint_Address</EndpointAddress>
      </TelemetryChannel>
    </Add>
  </TelemetrySinks>
  ...
  <ApplicationIdProvider Type="Microsoft.ApplicationInsights.Extensibility.Implementation.ApplicationId.ApplicationInsightsApplicationIdProvider, Microsoft.ApplicationInsights">
    <ProfileQueryEndpoint>Profile_Query_Endpoint_address</ProfileQueryEndpoint>
  </ApplicationIdProvider>
  ...
</ApplicationInsights>

.NET Core

Modificare il file appsettings.json nel progetto per modificare l'endpoint principale:

"ApplicationInsights": {
    "InstrumentationKey": "instrumentationkey",
    "TelemetryChannel": {
      "EndpointAddress": "TelemetryChannel_Endpoint_Address"
    }
  }

I valori per Live Metrics e l'endpoint profile Query possono essere impostati solo tramite codice. Per eseguire l'override dei valori predefiniti per tutti i valori dell'endpoint tramite codice, apportare le modifiche seguenti nel ConfigureServices metodo del Startup.cs file:

using Microsoft.ApplicationInsights.Extensibility.Implementation.ApplicationId;
using Microsoft.ApplicationInsights.Extensibility.PerfCounterCollector.QuickPulse; //Place at top of Startup.cs file

   services.ConfigureTelemetryModule<QuickPulseTelemetryModule>((module, o) => module.QuickPulseServiceEndpoint="QuickPulse_Endpoint_Address");

   services.AddSingleton<IApplicationIdProvider, ApplicationInsightsApplicationIdProvider>(_ => new ApplicationInsightsApplicationIdProvider() { ProfileQueryEndpoint = "Profile_Query_Endpoint_address" });

   services.AddSingleton<ITelemetryChannel>(_ => new ServerTelemetryChannel() { EndpointAddress = "TelemetryChannel_Endpoint_Address" });

    //Place in the ConfigureServices method. Place this before services.AddApplicationInsightsTelemetry("instrumentation key"); if it's present

Funzioni di Azure

Per Funzioni di Azure, è consigliabile usare le stringhe di connessione impostate nelle impostazioni dell'applicazione della funzione. Per accedere alle impostazioni dell'applicazione per la funzione dall'interno del riquadro funzioni, selezionare Impostazioni impostazioni>applicazione di configurazione>.

Nome: APPLICATIONINSIGHTS_CONNECTION_STRING
Valore: Connection String Value

Java

Modificare il file applicationinsights.xml per modificare l'indirizzo endpoint predefinito:

<?xml version="1.0" encoding="utf-8"?>
<ApplicationInsights xmlns="http://schemas.microsoft.com/ApplicationInsights/2013/Settings">
  <InstrumentationKey>ffffeeee-dddd-cccc-bbbb-aaaa99998888</InstrumentationKey>
  <TelemetryModules>
    <Add type="com.microsoft.applicationinsights.web.extensibility.modules.WebRequestTrackingTelemetryModule"/>
    <Add type="com.microsoft.applicationinsights.web.extensibility.modules.WebSessionTrackingTelemetryModule"/>
    <Add type="com.microsoft.applicationinsights.web.extensibility.modules.WebUserTrackingTelemetryModule"/>
  </TelemetryModules>
  <TelemetryInitializers>
    <Add type="com.microsoft.applicationinsights.web.extensibility.initializers.WebOperationIdTelemetryInitializer"/>
    <Add type="com.microsoft.applicationinsights.web.extensibility.initializers.WebOperationNameTelemetryInitializer"/>
    <Add type="com.microsoft.applicationinsights.web.extensibility.initializers.WebSessionTelemetryInitializer"/>
    <Add type="com.microsoft.applicationinsights.web.extensibility.initializers.WebUserTelemetryInitializer"/>
    <Add type="com.microsoft.applicationinsights.web.extensibility.initializers.WebUserAgentTelemetryInitializer"/>
  </TelemetryInitializers>
  <!--Add the following Channel value to modify the Endpoint address-->
  <Channel type="com.microsoft.applicationinsights.channel.concrete.inprocess.InProcessTelemetryChannel">
  <EndpointAddress>TelemetryChannel_Endpoint_Address</EndpointAddress>
  </Channel>
</ApplicationInsights>

Spring Boot

Modificare il application.properties file e aggiungere:

azure.application-insights.channel.in-process.endpoint-address= TelemetryChannel_Endpoint_Address

Node.js

var appInsights = require("applicationinsights");
appInsights.setup('INSTRUMENTATION_KEY');
appInsights.defaultClient.config.endpointUrl = "TelemetryChannel_Endpoint_Address"; // ingestion
appInsights.defaultClient.config.profileQueryEndpoint = "Profile_Query_Endpoint_address"; // appid/profile lookup
appInsights.defaultClient.config.quickPulseHost = "QuickPulse_Endpoint_Address"; //live metrics
appInsights.Configuration.start();

Gli endpoint possono essere configurati anche tramite variabili di ambiente:

**Instrumentation Key*: "APPINSIGHTS_INSTRUMENTATIONKEY"
*Profile endpoint*: "Profile_Query_Endpoint_address"
*Live Metrics endpoint*: "QuickPulse_Endpoint_Address"

JavaScript

Il frammento di codice corrente elencato di seguito è la versione 5. La versione è codificata nel frammento di codice come sv:"#". La versione corrente è disponibile anche in GitHub.

<script type="text/javascript">
!function(T,l,y){var S=T.location,k="script",D="instrumentationKey",C="ingestionendpoint",I="disableExceptionTracking",E="ai.device.",b="toLowerCase",w="crossOrigin",N="POST",e="appInsightsSDK",t=y.name||"appInsights";(y.name||T[e])&&(T[e]=t);var n=T[t]||function(d){var g=!1,f=!1,m={initialize:!0,queue:[],sv:"5",version:2,config:d};function v(e,t){var n={},a="Browser";return n[E+"id"]=a[b](),n[E+"type"]=a,n["ai.operation.name"]=S&&S.pathname||"_unknown_",n["ai.internal.sdkVersion"]="javascript:snippet_"+(m.sv||m.version),{time:function(){var e=new Date;function t(e){var t=""+e;return 1===t.length&&(t="0"+t),t}return e.getUTCFullYear()+"-"+t(1+e.getUTCMonth())+"-"+t(e.getUTCDate())+"T"+t(e.getUTCHours())+":"+t(e.getUTCMinutes())+":"+t(e.getUTCSeconds())+"."+((e.getUTCMilliseconds()/1e3).toFixed(3)+"").slice(2,5)+"Z"}(),iKey:e,name:"Microsoft.ApplicationInsights."+e.replace(/-/g,"")+"."+t,sampleRate:100,tags:n,data:{baseData:{ver:2}}}}var h=d.url||y.src;if(h){function a(e){var t,n,a,i,r,o,s,c,u,p,l;g=!0,m.queue=[],f||(f=!0,t=h,s=function(){var e={},t=d.connectionString;if(t)for(var n=t.split(";"),a=0;a<n.length;a++){var i=n[a].split("=");2===i.length&&(e[i[0][b]()]=i[1])}if(!e[C]){var r=e.endpointsuffix,o=r?e.location:null;e[C]="https://"+(o?o+".":"")+"dc."+(r||"services.visualstudio.com")}return e}(),c=s[D]||d[D]||"",u=s[C],p=u?u+"/v2/track":d.endpointUrl,(l=[]).push((n="SDK LOAD Failure: Failed to load Application Insights SDK script (See stack for details)",a=t,i=p,(o=(r=v(c,"Exception")).data).baseType="ExceptionData",o.baseData.exceptions=[{typeName:"SDKLoadFailed",message:n.replace(/\./g,"-"),hasFullStack:!1,stack:n+"\nSnippet failed to load ["+a+"] -- Telemetry is disabled\nHelp Link: https://go.microsoft.com/fwlink/?linkid=2128109\nHost: "+(S&&S.pathname||"_unknown_")+"\nEndpoint: "+i,parsedStack:[]}],r)),l.push(function(e,t,n,a){var i=v(c,"Message"),r=i.data;r.baseType="MessageData";var o=r.baseData;return o.message='AI (Internal): 99 message:"'+("SDK LOAD Failure: Failed to load Application Insights SDK script (See stack for details) ("+n+")").replace(/\"/g,"")+'"',o.properties={endpoint:a},i}(0,0,t,p)),function(e,t){if(JSON){var n=T.fetch;if(n&&!y.useXhr)n(t,{method:N,body:JSON.stringify(e),mode:"cors"});else if(XMLHttpRequest){var a=new XMLHttpRequest;a.open(N,t),a.setRequestHeader("Content-type","application/json"),a.send(JSON.stringify(e))}}}(l,p))}function i(e,t){f||setTimeout(function(){!t&&m.core||a()},500)}var e=function(){var n=l.createElement(k);n.src=h;var e=y[w];return!e&&""!==e||"undefined"==n[w]||(n[w]=e),n.onload=i,n.onerror=a,n.onreadystatechange=function(e,t){"loaded"!==n.readyState&&"complete"!==n.readyState||i(0,t)},n}();y.ld<0?l.getElementsByTagName("head")[0].appendChild(e):setTimeout(function(){l.getElementsByTagName(k)[0].parentNode.appendChild(e)},y.ld||0)}try{m.cookie=l.cookie}catch(p){}function t(e){for(;e.length;)!function(t){m[t]=function(){var e=arguments;g||m.queue.push(function(){m[t].apply(m,e)})}}(e.pop())}var n="track",r="TrackPage",o="TrackEvent";t([n+"Event",n+"PageView",n+"Exception",n+"Trace",n+"DependencyData",n+"Metric",n+"PageViewPerformance","start"+r,"stop"+r,"start"+o,"stop"+o,"addTelemetryInitializer","setAuthenticatedUserContext","clearAuthenticatedUserContext","flush"]),m.SeverityLevel={Verbose:0,Information:1,Warning:2,Error:3,Critical:4};var s=(d.extensionConfig||{}).ApplicationInsightsAnalytics||{};if(!0!==d[I]&&!0!==s[I]){var c="onerror";t(["_"+c]);var u=T[c];T[c]=function(e,t,n,a,i){var r=u&&u(e,t,n,a,i);return!0!==r&&m["_"+c]({message:e,url:t,lineNumber:n,columnNumber:a,error:i}),r},d.autoExceptionInstrumented=!0}return m}(y.cfg);function a(){y.onInit&&y.onInit(n)}(T[t]=n).queue&&0===n.queue.length?(n.queue.push(a),n.trackPageView({})):a()}(window,document,{
src: "https://js.monitor.azure.com/scripts/b/ai.2.min.js", // The SDK URL Source
// name: "appInsights", // Global SDK Instance name defaults to "appInsights" when not supplied.
// ld: 0, // Defines the load delay (in ms) before attempting to load the sdk. -1 = block page load and add to head (default) = 0ms load after timeout.
// useXhr: 1, // Use XHR instead of fetch to report failures (if available).
crossOrigin: "anonymous", // When supplied, this will add the provided value as the cross origin attribute on the script tag.
// onInit: null, // Once the Application Insights instance has loaded and initialized, this callback function will be called with 1 argument -- the sdk instance. (DO NOT ADD anything to the sdk.queue -- as they won't get called.)
cfg: { // Application Insights Configuration
    instrumentationKey:"INSTRUMENTATION_KEY",
    endpointUrl: "TelemetryChannel_Endpoint_Address"
}});
</script>

Nota

Per la leggibilità e per ridurre i possibili errori JavaScript, tutte le opzioni di configurazione possibili sono elencate in una nuova riga nel codice del frammento di codice precedente. Se non si desidera modificare il valore di una riga commentata, è possibile rimuoverlo.

Python

Per indicazioni sulla modifica dell'endpoint di inserimento per opencensus-python SDK, vedere il repository opencensus-python.

Aree che richiedono la modifica degli endpoint

Attualmente, le uniche aree che richiedono modifiche agli endpoint sono Azure per enti pubblici e Azure Cina.

Region	Nome dell'endpoint	Valore
Azure Cina	Canale di telemetria	https://dc.applicationinsights.azure.cn/v2/track
Azure Cina	QuickPulse (metriche attive)	https://live.applicationinsights.azure.cn/QuickPulseService.svc
Azure Cina	Query profilo	https://dc.applicationinsights.azure.cn/api/profiles/{0}/appId
Azure Government	Canale di telemetria	https://dc.applicationinsights.us/v2/track
Azure Government	QuickPulse (metriche attive)	https://quickpulse.applicationinsights.us/QuickPulseService.svc
Azure Government	Query profilo	https://dc.applicationinsights.us/api/profiles/{0}/appId

Se attualmente si usa l'API REST di Application Insights, a cui si accede normalmente tramite api.applicationinsights.io, è necessario usare un endpoint locale per l'area.

Region	Nome dell'endpoint	Valore
Azure Cina	API REST	api.applicationinsights.azure.cn
Azure Government	API REST	api.applicationinsights.us

Passaggi successivi

• Usare La ricerca diagnostica.
• Esplorare le metriche.
• Scrivere query di Log Analytics.
• Per altre informazioni sulle modifiche personalizzate per Azure per enti pubblici, vedere le linee guida dettagliate per il monitoraggio e la gestione di Azure.
• Per altre informazioni su Azure Cina, vedere Il playbook di Azure Cina.