Création d’une ressource Application Insights dans Azure

Attention

Cet article s’applique aux ressources Application Insights Classic, qui ne sont plus recommandées.

Les informations contenues dans cet article sont obsolètes et ne seront pas mises à jour.

Transition vers Application Insights basé sur l’espace de travail pour tirer parti des nouvelles fonctionnalités.

Application Insights affiche les données relatives à votre application dans une ressource Azure. La création d’une ressource fait partie de la configuration d’Application Insights pour surveiller une nouvelle application. Une fois que vous avez créé votre ressource, vous pouvez obtenir sa clé d’instrumentation et l’utiliser pour configurer le kit de développement logiciel (SDK) Application Insights. La clé d’instrumentation lie vos données de télémétrie à la ressource.

Important

Le 29 février 2024, la prise en charge d’Application Insights classique se terminera. Transition vers Application Insights basé sur l’espace de travail pour tirer parti des nouvelles fonctionnalités. Les régions introduites après février 2021 n’acceptent pas la création de ressources Application Insights classiques.

Notes

Le support de l’ingestion de clé d’instrumentation prendra fin le 31 mars 2025. L’ingestion de clé d’instrumentation continuera de fonctionner, mais nous ne fournirons plus de mises à jour ni de support pour la fonctionnalité. Passez aux chaînes de connexion pour tirer parti des nouvelles fonctionnalités.

Connexion à Azure

Si vous n’avez pas d’abonnement Azure, créez un compte gratuit avant de commencer.

Création d’une ressource Application Insights dans Azure

Connectez-vous au Portail Azure et créez une ressource Application Insights.

Paramètres	Valeur	Description
Nom	Unique value	Nom identifiant l’application que vous supervisez.
Groupe de ressources	myResourceGroup	Nom du groupe de ressources, actuel ou nouveau, dans lequel seront hébergées les données Application Insights.
Région	East US	Sélectionnez un emplacement proche de vous ou de l’endroit où votre application est hébergée.
Mode de ressources	Classic ou Workspace-based	Les ressources basées sur l’espace de travail vous permettent d’envoyer votre télémétrie Application Insights à un espace de travail Log Analytics commun. Pour plus d’informations, consultez Ressources Application Insights basées sur un espace de travail.

Notes

Vous pouvez utiliser le même nom de ressource dans différents groupes de ressources. Il reste néanmoins préférable d’opter pour un nom global unique. Si vous envisagez d’effectuer des requêtes sur plusieurs ressources, le nom global unique simplifie la syntaxe nécessaire.

Entrez les valeurs appropriées dans les champs obligatoires. Sélectionnez Revoir + créer.

Une fois votre application créée, un nouveau volet affiche les données de performances et d’utilisation de votre application surveillée.

Copie de la clé d’instrumentation

La clé d’instrumentation identifie la ressource à associer à vos données de télémétrie. Vous devez copier la clé d’instrumentation et l’ajouter au code de votre application.

Installation du Kit SDK dans votre application

Installez le Kit SDK Application Insights dans votre application. Cette étape repose en grande partie sur votre type d’application.

La clé d’instrumentation permet de configurer le kit de développement logiciel (SDK) que vous avez installé dans votre application.

Le kit SDK inclut des modules standard qui envoient des données de télémétrie, ce qui vous évite d’avoir à écrire du code supplémentaire. Pour suivre les actions des utilisateurs ou diagnostiquer des problèmes plus en détail, utilisez l'API pour envoyer votre propre télémétrie.

Créer une ressource automatiquement

Utilisez PowerShell ou Azure CLI pour créer automatiquement une ressource.

PowerShell

Créez une ressource Application Insights.

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

Exemple

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

Résultats

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}

Pour obtenir la documentation PowerShell complète de cette cmdlet et apprendre à récupérer la clé d’instrumentation, consultez la documentation Azure PowerShell.

Azure CLI (préversion)

Pour accéder à la préversion des commandes Azure CLI pour Application Insights, vous devez d’abord exécuter :

 az extension add -n application-insights

Si vous n’exécutez pas la commande az extension add, vous voyez un message d’erreur indiquant : az : ERROR: az monitor: 'app-insights' is not in the 'az monitor' command group. See 'az monitor --help'.

Exécutez la commande suivante pour créer votre ressource Application Insights :

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

Exemple

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

Résultats

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"
}

Pour obtenir la documentation Azure CLI complète de cette commande et savoir comment récupérer la clé d’instrumentation, consultez la documentation Azure CLI.

Remplacement des points de terminaison par défaut

Avertissement

Ne modifiez pas les points de terminaison. Passez aux chaînes de connexion pour simplifier la configuration et éliminer la nécessité de modifier le point de terminaison.

Pour pouvoir envoyer des données Application Insights vers certaines régions, vous devez remplacer les adresses des points de terminaison par défaut. Chaque SDK nécessite des modifications légèrement différentes, qui sont toutes décrites dans cet article.

Ces modifications obligent à adapter l’exemple de code et à remplacer la valeur des espaces réservés QuickPulse_Endpoint_Address, TelemetryChannel_Endpoint_Address et Profile_Query_Endpoint_address par l’adresse réelle des points de terminaison de votre région. Vous trouverez à la fin de cet article des liens vers les adresses des points de terminaison pour les régions où cette configuration est requise.

Notes

Le support de l’ingestion de clé d’instrumentation prendra fin le 31 mars 2025. L’ingestion de clé d’instrumentation continuera de fonctionner, mais nous ne fournirons plus de mises à jour ni de support pour la fonctionnalité. Passez aux chaînes de connexion pour tirer parti des nouvelles fonctionnalités.

---

Modification du code des SDK

.NET

Notes

Le fichier applicationinsights.config est automatiquement remplacé à chaque mise à niveau d’un kit SDK. N’oubliez pas, après avoir mis à niveau un kit SDK, d’entrer à nouveau les valeurs de points de terminaison propres à votre région.

<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

Modifiez le fichier appsettings.json dans votre projet pour adapter le point de terminaison principal :

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

La valeur des points de terminaison Live Metrics et Profile Query ne peut être définie que dans le code. Pour remplacer les valeurs par défaut de tous les points de terminaison en modifiant le code, apportez les modifications suivantes dans la méthode ConfigureServices du fichier Startup.cs :

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

Azure Functions

Pour Azure Functions, nous vous recommandons d’utiliser des chaînes de connexion définies dans les paramètres d’application de la fonction. Pour accéder aux paramètres d’application de votre fonction dans le volet des fonctions, sélectionnez Paramètres>Configuration>Paramètre d’application.

Nom : APPLICATIONINSIGHTS_CONNECTION_STRING
Valeur : Connection String Value

Java

Modifiez le fichier applicationinsights.xml pour changer l’adresse du point de terminaison par défaut :

<?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

Modifiez le fichier application.properties en ajoutant ce qui suit :

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();

Les points de terminaison peuvent également être configurés à l’aide de variables d’environnement :

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

JavaScript

L’extrait de code suivant correspond à la version 5. La version y est encodée sous la forme sv:"#". La version actuelle est également disponible sur 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>

Notes

Pour des raisons de lisibilité et pour réduire les éventuelles erreurs JavaScript, toutes les options de configuration possibles sont énumérées sur une nouvelle ligne dans le code de l’extrait précédent. Si vous ne souhaitez pas modifier la valeur d’une ligne commentée, elle peut être supprimée.

Python

Pour savoir comment modifier le point de terminaison d’ingestion dans le kit SDK opencensus-python, consultez le référentiel opencensus-python.

Régions nécessitant une modification des points de terminaison

Actuellement, seules les régions Azure Government et Azure Chine nécessitent des modifications de leurs points de terminaison.

Région	Nom du point de terminaison	Valeur
Azure Chine	Canal de télémétrie	https://dc.applicationinsights.azure.cn/v2/track
Azure Chine	QuickPulse (Live Metrics)	https://live.applicationinsights.azure.cn/QuickPulseService.svc
Azure Chine	Profile Query	https://dc.applicationinsights.azure.cn/api/profiles/{0}/appId
Azure Government	Canal de télémétrie	https://dc.applicationinsights.us/v2/track
Azure Government	QuickPulse (Live Metrics)	https://quickpulse.applicationinsights.us/QuickPulseService.svc
Azure Government	Profile Query	https://dc.applicationinsights.us/api/profiles/{0}/appId

Si vous utilisez actuellement l’API REST Application Insights (normalement accessible à l’adresse api.applicationinsights.io), il vous faut un point de terminaison local par rapport à votre région.

Région	Nom du point de terminaison	Valeur
Azure Chine	API REST	api.applicationinsights.azure.cn
Azure Government	API REST	api.applicationinsights.us

Étapes suivantes

• Utilisez la Recherche de diagnostic.
• Explorez les métriques.
• Écrivez des requêtes Log Analytics.
• Pour plus d’informations sur les modifications personnalisées relatives à la région Azure Government, consultez les instructions détaillées sur la surveillance et gestion Azure.
• Pour plus d’informations sur la région Azure China, consultez le playbook Azure China.