Création d’une ressource Application Insights dans Azure

Azure Application Insights affiche les données relatives à votre application dans une ressource Microsoft Azure. La création d’une nouvelle ressource fait, par conséquent, partie de la configuration d’Application Insights pour surveiller une nouvelle application. Après avoir créé votre nouvelle 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 de la version classique d’Application Insights se termine. Transition vers Application Insights basé sur l’espace de travail pour tirer parti des nouvelles fonctionnalités. Les régions plus récentes introduites après février 2021 ne prennent pas en charge la création de ressources Application Insights classiques.

Notes

Le 31 mars 2025, la prise en charge de l’ingestion de clé d’instrumentation prendra fin. 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.

Se connecter à Microsoft 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 :

Click the + sign in the upper left corner. Select Developer Tools followed by Application Insights

Paramètres Valeur Description
Nom Unique value Nom identifiant l’application que vous analysez.
Groupe de ressources myResourceGroup Nom du nouveau groupe de ressources ou existant pour héberger les données Application Insights.
Région East US Choisissez un emplacement près de chez vous ou proche 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 l'article relatif aux ressources basées sur l'espace de travail.

Notes

Bien que vous puissiez utiliser le même nom de ressource dans différents groupes de ressources, il est préférable d’utiliser un nom global unique. Ce dernier peut s’avérer utile si vous envisagez d’exécuter des requêtes de ressources croisées, car cela simplifie la syntaxe nécessaire.

Entrez les valeurs appropriées dans les champs obligatoires, puis sélectionnez Vérifier + créer.

Enter values into required fields, and then select

Une fois votre application créée, un nouveau volet s’ouvre. Dans ce volet, vous trouverez des données relatives à l’utilisation et aux performances de votre application analysée.

Copie de la clé d’instrumentation

La clé d’instrumentation identifie la ressource à laquelle vous souhaitez 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 de développement logiciel (SDK) inclut des modules standard qui envoient des données de télémétrie sans 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éation automatique d’une ressource

PowerShell

Créer une ressource Application Insights dans Azure

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 applet de commande 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 verrez un message d’erreur qui indique : az : ERROR: az monitor: 'app-insights' is not in the 'az monitor' command group. See 'az monitor --help'..

Vous pouvez maintenant exécuter 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 -g demoRg --application-type web

Résultats

az monitor app-insights component create --app demoApp --location eastus --kind web -g 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 complète Azure CLI de cette commande et savoir comment récupérer la clé d’instrumentation, consultez la documentation Azure CLI.

Étapes suivantes