Ressources Application Insights basées sur l’espace de travail

  • Article

Les ressources basées sur l’espace de travail Azure MonitorApplication Insights intègrent Application Insights et Log Analytics.

Grâce aux ressources basées sur l’espace de travail, Application Insights envoie les données de télémétrie à un espace de travail Log Analytics commun, ce qui vous permet d’accéder à toutes les fonctionnalités de Log Analytics tout en conservant les journaux des applications, des infrastructures et des plateformes dans un emplacement consolidé unique. Cette intégration permet de disposer d’un contrôle d’accès en fonction du rôle Azure commun sur vos ressources et élimine le besoin de requêtes entre des applications ou des espaces de travail.

Notes

L’ingestion et la conservation des données pour les ressources Application Insights basées sur un espace de travail sont facturées dans l’espace de travail Log Analytics où se trouvent les données. Pour en savoir plus sur la facturation des ressources Application Insights basées sur un espace de travail, consultez Informations sur les tarifs des Journaux Azure Monitor.

Nouvelles fonctionnalités

Avec les Application Insights basées sur un espace de travail, vous pouvez tirer profit des dernières fonctionnalités d’Azure Monitor et de Log Analytics. Par exemple :

Créer une ressource basée sur un espace de travail

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

Capture d’écran montrant une ressource Application Insights basée sur un espace de travail.

Si vous ne disposez pas d’un espace de travail Log Analytics, consultez la documentation relative à la création d’un espace de travail Log Analytics.

*Les ressources basées sur l’espace de travail sont actuellement disponibles dans toutes les régions commerciales et Azure Government. Le fait d’avoir Application Insights et Log Analytics dans deux régions différentes peut avoir un impact sur la latence et réduire la fiabilité générale de la solution de monitoring. *

Après avoir créé votre ressource, vous verrez les informations de l’espace de travail correspondant dans le volet Vue d’ensemble.

Capture d’écran montrant le nom d’un espace de travail.

Sélectionnez texte du lien bleu pour accéder à l’espace de travail Log Analytics associé dans lequel vous pouvez tirer parti du nouvel environnement de requête de l’espace de travail unifié.

Notes

Nous proposons toujours une compatibilité descendante complète pour vos requêtes de ressources, classeurs et alertes basées sur un journal Application Insights classiques. Pour interroger ou afficher le nouveau schéma ou la nouvelle structure de table basée sur un espace de travail, vous devez d’abord accéder à votre espace de travail Log Analytics. Sélectionnez Journaux (Analytics) dans les volets d’Application Insights pour accéder à l’expérience de requête Application Insights classique.

Copier la chaîne de connexion

La chaîne de connexion identifie la ressource à laquelle vous souhaitez associer vos données de télémétrie. Vous pouvez également l’utiliser pour modifier les points de terminaison que votre ressource utilise comme destination pour votre télémétrie. Vous devez copier la chaîne de connexion et l’ajouter au code de votre application ou à une variable d’environnement.

Configuration de l’analyse

Une fois que vous avez créé une ressource Application Insights basée sur un espace de travail, vous configurez la supervision.

Supervision des applications basée sur du code

Pour la supervision des applications basée sur du code, vous installez le kit de développement logiciel (SDK) Application Insights approprié et pointez la chaîne de connexion vers la ressource que vous venez de créer.

Pour plus d’informations sur la configuration d’un Kit de développement logiciel (SDK) Application Insights pour la supervision basée sur du code, consultez la documentation suivante spécifique au langage ou à l’infrastructure :

Supervision sans code et création de ressources Visual Studio

Pour la supervision sans code de services tels qu’Azure Functions et Azure App Services, vous créez tout d’abord votre ressource Application Insights basée sur un espace de travail. Ensuite, vous pointez vers cette ressource lorsque vous configurez la supervision.

Ces services offrent la possibilité de créer une nouvelle ressource Application Insights dans leur propre processus de création de ressources. Toutefois, les ressources créées via ces options d’interface utilisateur sont actuellement limitées à l’expérience Application Insights classique.

La même restriction s’applique à l’expérience de création de ressources Application Insights dans Visual Studio pour ASP.NET et ASP.NET Core. Vous devez sélectionner une ressource basée sur un espace de travail existante dans l’interface utilisateur de Visual Studio où vous activez la supervision. La sélection de Créer une ressource dans Visual Studio vous limite à la création d’une ressource Application Insights classique.

Créer une ressource automatiquement

Azure CLI

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

Vous pouvez maintenant exécuter le code suivant pour créer votre ressource Application Insights :

az monitor app-insights component create --app
                                         --location
                                         --resource-group
                                         [--application-type]
                                         [--ingestion-access {Disabled, Enabled}]
                                         [--kind]
                                         [--only-show-errors]
                                         [--query-access {Disabled, Enabled}]
                                         [--tags]
                                         [--workspace]

Exemple

az monitor app-insights component create --app demoApp --location eastus --kind web -g my_resource_group --workspace "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/test1234/providers/microsoft.operationalinsights/workspaces/test1234555"

Pour obtenir la documentation Azure CLI complète pour cette commande, consultez la documentation Azure CLI.

Azure PowerShell

Créez une nouvelle ressource Application Insights basée sur un espace de travail.

New-AzApplicationInsights -Name <String> -ResourceGroupName <String> -Location <String> -WorkspaceResourceId <String>
   [-SubscriptionId <String>]
   [-ApplicationType <ApplicationType>]
   [-DisableIPMasking]
   [-DisableLocalAuth]
   [-Etag <String>]
   [-FlowType <FlowType>]
   [-ForceCustomerStorageForProfiler]
   [-HockeyAppId <String>]
   [-ImmediatePurgeDataOn30Day]
   [-IngestionMode <IngestionMode>]
   [-Kind <String>]
   [-PublicNetworkAccessForIngestion <PublicNetworkAccessType>]
   [-PublicNetworkAccessForQuery <PublicNetworkAccessType>]
   [-RequestSource <RequestSource>]
   [-RetentionInDays <Int32>]
   [-SamplingPercentage <Double>]
   [-Tag <Hashtable>]
   [-DefaultProfile <PSObject>]
   [-Confirm]
   [-WhatIf]
   [<CommonParameters>]

Exemple

New-AzApplicationInsights -Kind java -ResourceGroupName testgroup -Name test1027 -location eastus -WorkspaceResourceId "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/test1234/providers/microsoft.operationalinsights/workspaces/test1234555"

Pour obtenir la documentation PowerShell complète de cette cmdlet et apprendre à récupérer la chaîne de connexion, consultez la documentation Azure PowerShell.

Modèles Microsoft Azure Resource Manager

Pour créer une ressource basée sur un espace de travail, utilisez les modèles Azure Resource Manager suivants et déployez-les à l’aide de PowerShell.

Fichier de modèle

{
    "$schema": "http://schema.management.azure.com/schemas/2014-04-01-preview/deploymentTemplate.json#",
    "contentVersion": "1.0.0.0",
    "parameters": {
        "name": {
            "type": "string"
        },
        "type": {
            "type": "string"
        },
        "regionId": {
            "type": "string"
        },
        "tagsArray": {
            "type": "object"
        },
        "requestSource": {
            "type": "string"
        },
        "workspaceResourceId": {
            "type": "string"
        }
    },
    "resources": [
        {
            "name": "[parameters('name')]",
            "type": "microsoft.insights/components",
            "location": "[parameters('regionId')]",
            "tags": "[parameters('tagsArray')]",
            "apiVersion": "2020-02-02-preview",
            "properties": {
                "ApplicationId": "[parameters('name')]",
                "Application_Type": "[parameters('type')]",
                "Flow_Type": "Bluefield",
                "Request_Source": "[parameters('requestSource')]",
                "WorkspaceResourceId": "[parameters('workspaceResourceId')]"
            }
        }
    ]
}

Notes

Pour plus d’informations sur les propriétés des ressources, consultez Valeurs de propriété. Flow_Type et Request_Source ne sont pas utilisés, mais sont inclus dans cet exemple à des fins d’exhaustivité.

Fichier de paramètres

{
    "$schema": "https://schema.management.azure.com/schemas/2015-01-01/deploymentParameters.json#",
    "contentVersion": "1.0.0.0",
    "parameters": {
        "type": {
            "value": "web"
        },
        "name": {
            "value": "customresourcename"
        },
        "regionId": {
            "value": "eastus"
        },
        "tagsArray": {
            "value": {}
        },
        "requestSource": {
            "value": "Custom"
        },
        "workspaceResourceId": {
            "value": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/my_resource_group/providers/microsoft.operationalinsights/workspaces/myworkspacename"
        }
    }
}

Modifier l’espace de travail associé

Après avoir créé une ressource Application Insights basée sur un espace de travail, vous pouvez modifier l’espace de travail Log Analytics associé.

Dans le volet des ressources Application Insights, sélectionnez Propriétés>Modifier l’espace de travail>Espaces de travail Log Analytics.

Exporter la télémétrie

La fonctionnalité héritée d’exportation continue n’est pas prise en charge pour les ressources basées sur un espace de travail. Au lieu de cela, sélectionnez Paramètres de diagnostic>Ajouter un paramètre de diagnostic dans votre ressource Application Insights. Vous pouvez sélectionner toutes les tables ou un sous-ensemble de tables à archiver dans un compte de stockage. Vous pouvez également diffuser en continu vers un Azure Event Hub.

Notes

L’exportation des paramètres de diagnostic peut augmenter les coûts. Pour plus d’informations, consultez Exporter les données de télémétrie à partir d’Application Insights. Pour plus d’informations sur la tarification de cette fonctionnalité, consultez la page de tarification d’Azure Monitor. Avant le début de la facturation, des notifications seront envoyées. Si vous continuez à utiliser l’exportation de la télémétrie après la période de préavis, vous serez facturé au tarif applicable.

Étapes suivantes