Migrer vers des ressources de Application Insights basées sur un espace de travail

Cet article vous guide tout au long de la migration d’une ressource Application Insights classique vers une ressource basée sur un espace de travail.

Ressources basées sur l’espace de travail :

Important

  • L’exportation continue a été mise hors service le 29 février 2024 en même temps que la mise hors service de la ressource Application Insights classique.

  • Les ressources Application Insights basées sur un espace de travail ne sont pas compatibles avec l’exportation continue. Nous vous recommandons de migrer vers les paramètres de diagnostic des ressources Application Insights classiques avant de passer à une ressource Application Insights basée sur un espace de travail. Cela garantit la continuité et la compatibilité de vos paramètres de diagnostic.

  • L’exportation des paramètres de diagnostic peut augmenter les coûts. Pour plus d’informations, consultez Exportation basée sur les paramètres de diagnostic.

Nouvelles fonctionnalités

Les ressources Application Insights basées sur un espace de travail vous permettent de tirer parti des dernières fonctionnalités d’Azure Monitor et de Log Analytics :

  • Les clés gérées par le client permettent un chiffrement au repos de vos données à l’aide de clés de chiffrement auxquelles vous seul avez accès.
  • Azure Private Link vous permet de lier de manière sécurisée l’offre PaaS (platform as a service) Azure à votre réseau virtuel à l’aide de points de terminaison privés.
  • BYOS (Bring Your Own Storage) pour Profiler et le Débogueur de capture instantanée vous donne un contrôle total sur les éléments suivants :
    • Stratégie de chiffrement au repos.
    • Stratégie de gestion de la durée de vie.
    • Accès réseau pour toutes les données associées à Application Insights Profiler et au Débogueur de capture instantanée.
  • Les niveaux d’engagement vous permettent d’économiser jusqu’à 30 % par rapport au tarif du paiement à l’utilisation. Sinon, la facturation de l’ingestion de données avec paiement à l’utilisation et de la conservation des données dans Log Analytics est similaire à la facturation dans Application Insights.
  • Les données sont ingérées plus rapidement via l’ingestion en streaming Log Analytics.

Notes

Une fois que vous avez migré vers une ressource Application Insights basée sur un espace de travail, vous pouvez stocker la télémétrie de plusieurs ressources Application Insights dans un espace de travail Log Analytics commun. Vous pouvez toujours tirer des données d’une ressource Application Insights spécifique, comme indiqué dans la section Comprendre les requêtes de journal.

Processus de migration

Lorsque vous migrez vers une ressource basée sur un espace de travail, aucune donnée n’est transférée du stockage de votre ressource classique vers le nouveau stockage basé sur l’espace de travail. La migration change l’emplacement d’écriture des nouvelles données pour qu’elles soient écrites dans un espace de travail Log Analytics, tout en préservant l’accès aux données de vos ressources classiques.

Vos données de ressource classiques sont conservées, puis soumises aux paramètres de rétention de votre ressource Application Insights classique. Toutes les nouvelles données ingérées après migration sont soumises aux paramètres de rétention de l’espace de travail Log Analytics associé, qui prend également en charge différents paramètres de rétention par type de données.

Le processus de migration est permanent et ne peut pas être inversé. Une fois que vous avez migré une ressource vers une ressource Application Insights basée sur un espace de travail, elle devient pour toujours une ressource basée sur un espace de travail. Une fois la migration effectuée, vous pouvez changer l’espace de travail cible aussi souvent que nécessaire.

Si vous n’avez pas besoin de migrer une ressource existante et si vous souhaitez créer à la place une ressource Application Insights basée sur un espace de travail, consultez le Guide de création de ressources basées sur un espace de travail.

Remarque

Le processus de migration ne doit introduire aucun temps d’arrêt ou redémarrage de l’application ni modifier votre clé d’instrumentation ou votre chaîne de connexion existante.

Prérequis

  • Un espace de travail Log Analytics dont le mode de contrôle d’accès est défini à l’aide du paramètre Utiliser les autorisations de ressource ou d’espace de travail :

  • L’exportation continue est incompatible avec les ressources basées sur un espace de travail, et doit être désactivée. Une fois la migration effectuée, vous pouvez utiliser les paramètres de diagnostic pour configurer l’archivage des données sur un compte de stockage ou le streaming vers Azure Event Hubs.

    Attention

    • Les paramètres de diagnostic utilisent un format/schéma d’exportation différent de celui de l’exportation continue. La migration interrompt toutes les intégrations existantes à Azure Stream Analytics.
    • 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.
  • Vérifiez vos paramètres de conservation actuels sous Paramètres>Utilisation et coûts estimés>Conservation des données pour votre espace de travail Log Analytics. Ce paramètre affecte la durée de stockage des nouvelles données ingérées après la migration de votre ressource Application Insights.

    Notes

    • Si vous stockez actuellement des données Application Insights au-delà des 90 jours par défaut et que vous voulez conserver ce délai, ajustez les paramètres de conservation de l’espace de travail.
    • Si vous avez sélectionné une conservation des données supérieure à 90 jours pour les données ingérées dans la ressource Application Insights classique avant la migration, la conservation des données continue d’être facturée via cette ressource Application Insights jusqu’à ce que les données dépassent la période de conservation.
    • Si le paramètre de conservation de votre instance d’Application Insights sous Configurer>Utilisation et coûts estimés>Conservation des données est activé, utilisez-le pour contrôler le nombre de jours de conservation des données de télémétrie toujours enregistrées dans le stockage de votre ressource classique.
  • Découvrez l’utilisation et les coûts des ressources Application Insights basées sur un espace de travail.

Migrer votre ressource

Pour migrer une ressource Application Insights classique vers une ressource basée sur un espace de travail :

  1. À partir de votre ressource Application Insights, sélectionnez Propriétés sous le titre Configurer dans le menu de gauche.

    Screenshot that shows Properties under the Configure heading.

  2. Sélectionnez Migrer vers le mode Basé sur un espace de travail.

    Screenshot that shows the Migrate to Workspace-based button.

  3. Sélectionnez l’espace de travail Log Analytics dans lequel vous voulez stocker toutes les données de télémétrie Application Insights à ingérer. Il peut s’agir d’un espace de travail Log Analytics dans le même abonnement ou dans un autre abonnement qui partage le même locataire Microsoft Entra. L’espace de travail Log Analytics n’a pas besoin d’être dans le même groupe de ressources que la ressource Application Insights.

    Notes

    La migration vers une ressource basée sur un espace de travail peut prendre jusqu’à 24 heures, mais le processus est généralement plus rapide. Vous pouvez accéder aux données via votre ressource Application Insights pendant que vous attendez la fin du processus de migration. Une fois l’opération effectuée, vous verrez les nouvelles données stockées dans les tables de l’espace de travail Log Analytics.

    Screenshot that shows the Migration wizard UI with the option to select target workspace.

    Une fois votre ressource migrée, vous voyez les informations de l’espace de travail correspondant dans le volet Vue d’ensemble.

    Screenshot that shows the Workspace name.

    Si vous sélectionnez le texte du lien en bleu, vous accédez à l’espace de travail Log Analytics associé, où vous pouvez tirer parti du nouvel environnement de requête de l’espace de travail unifié.

Conseil

Une fois que vous avez migré vers une ressource Application Insights basée sur un espace de travail, utilisez la limite quotidienne de l’espace de travail pour limiter l’ingestion et les coûts, au lieu de la limite définie dans Application Insights.

Présentation des requêtes de journal

Nous fournissons toujours une compatibilité descendante complète pour vos workbooks, alertes basées sur les journaux et requêtes de ressources Application Insights classiques au sein de l’expérience Application Insights.

Pour écrire des requêtes portant sur la nouvelle structure/le nouveau schéma de table basé sur un espace de travail, vous devez d’abord accéder à votre espace de travail Log Analytics.

Pour garantir la réussite de l’exécution des requêtes, vérifiez que les champs de la requête s’alignent sur les champs du nouveau schéma.

Vous pouvez avoir plusieurs ressources Application Insights qui stockent la télémétrie dans un seul espace de travail Log Analytics, et vouloir interroger les données d’une ressource Application Insights spécifique. Deux options s'offrent à vous :

  • Accédez à votre ressource Application Insights et sélectionnez l’onglet Journaux. Toutes les requêtes de cet onglet tirent automatiquement les données de la ressource Application Insights sélectionnée.
  • Accédez à l’espace de travail Log Analytics que vous avez configuré comme destination de votre télémétrie Application Insights et sélectionnez l’onglet Journaux. Pour interroger les données d’une ressource Application Insights spécifique, filtrez sur la propriété _ResourceId intégrée disponible dans toutes les tables propres à l’application.

Quand vous lancez l’interrogation directement depuis l’espace de travail Log Analytics, seules les données ingérées après la migration apparaissent. Pour voir à la fois vos données de Application Insights classiques et les nouvelles données ingérées après la migration dans une expérience de requête unifiée, utilisez la vue de requête Logs à partir de votre ressource Application Insights migrée.

Notes

Si vous renommez votre ressource Application Insights après avoir migré vers le modèle basé sur un espace de travail, l’onglet Journaux d’Application Insights n’affiche plus la télémétrie collectée avant le renommage. Vous pouvez voir toutes les anciennes et nouvelles données sous l’onglet Journaux de la ressource Log Analytics associée.

Identification des ressources Application Insights par type d’ingestion

Utilisez le script suivant pour identifier vos ressources Application Insights par type d’ingestion.

Exemple

Get-AzApplicationInsights -SubscriptionId 'Your Subscription ID' | Format-Table -Property Name, IngestionMode, Id, @{label='Type';expression={
    if ([string]::IsNullOrEmpty($_.IngestionMode)) {
        'Unknown'
    } elseif ($_.IngestionMode -eq 'LogAnalytics') {
        'Workspace-based'
    } elseif ($_.IngestionMode -eq 'ApplicationInsights' -or $_.IngestionMode -eq 'ApplicationInsightsWithDiagnosticSettings') {
        'Classic'
    } else {
        'Unknown'
    }
}}

Migration de ressources par programme

Cette section vous aide à migrer vos ressources.

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 update --app
                                         --resource-group
                                         [--ingestion-access {Disabled, Enabled}]
                                         [--kind]
                                         [--query-access {Disabled, Enabled}]
                                         [--retention-time]
                                         [--workspace]

Exemple

az monitor app-insights component update --app your-app-insights-resource-name -g your_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

À compter de la version 8.0 (ou une version ultérieure) d’Azure PowerShell, vous pouvez utiliser la commande PowerShell Update-AzApplicationInsights pour effectuer la migration d’une ressource Application Insights classique vers un espace de travail.

Pour utiliser cet applet de commande, vous devez spécifier le nom et le groupe de la ressource Application Insights que vous souhaitez mettre à jour. Utilisez les paramètres IngestionMode et WorkspaceResoruceId pour effectuer une migration de votre instance classique vers l’espace de travail. Pour plus d’informations sur les paramètres et la syntaxe de cet applet de commande, consultez Update-AzApplicationInsights.

Exemple

# Get the resource ID of the Log Analytics workspace
$workspaceResourceId = (Get-AzOperationalInsightsWorkspace -ResourceGroupName "rgName" -Name "laName").ResourceId

# Update the Application Insights resource with the workspace parameter
Update-AzApplicationInsights -Name "aiName" -ResourceGroupName "rgName" -IngestionMode LogAnalytics -WorkspaceResourceId $workspaceResourceId

Modèles Microsoft Azure Resource Manager

Cette section fournit des modèles.

Attention

Vérifiez que vous avez supprimé tous les paramètres d’exportation continue de votre ressource avant d’exécuter les modèles de migration. Consulter les prérequis

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": "Redfield",
                "Request_Source": "[parameters('requestSource')]",
                "WorkspaceResourceId": "[parameters('workspaceResourceId')]"
            }
        }
    ]
}

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.

Forum aux questions

Cette section fournit des réponses aux questions fréquentes.

Que se passe-t-il si je ne migre pas ma ressource Application Insights classique vers une ressource basée sur un espace de travail ?

Microsoft commencera une approche progressive automatique pour migrer des ressources classiques vers des ressources basées sur un espace de travail à compter de mai 2024 et cette migration s’étendra sur plusieurs mois. Nous ne pouvons pas fournir de dates approximatives pour la migration de ressources, d’abonnements ou de régions spécifiques.

Nous encourageons vivement la migration manuelle vers des ressources basées sur l’espace de travail, qui est initiée en sélectionnant la bannière d’avis de mise hors service dans le volet classique d’aperçu des ressources Application Insights du Portail Azure. Ce processus implique généralement une étape de choix pas à pas de l’espace de travail Log Analytics qui sera utilisé pour stocker les données de votre application. Si vous utilisez l’exportation continue, vous devez effectuer une migration supplémentaire vers les paramètres de diagnostic ou désactiver la fonctionnalité en premier.

Si vous ne souhaitez pas que votre ressource classique soit automatiquement migrée vers une ressource basée sur un espace de travail, vous pouvez supprimer ou migrer manuellement la ressource.

Existe-t-il une implication sur le coût de la migration ?

Il n’existe généralement aucune différence, sauf une exception : les ressources Application Insights qui recevaient 1 Go par mois gratuitement via le modèle tarifaire Application Insights hérité ne recevront plus les données gratuites.

La migration vers Application Insights basée sur l’espace de travail offre plusieurs options pour optimiser davantage le coût, notamment les niveaux d’engagement Log Analytics, les clusters dédiés et les journaux de base.

Comment fonctionnera la limitation des données de télémétrie ?

Vous pouvez définir une limite quotidienne sur l’espace de travail Log Analytics.

Il n’existe aucune limitation de facturation stricte.

Comment fonctionnera l’échantillonnage basé sur l’ingestion ?

L’échantillonnage basé sur l’ingestion n’est pas modifié.

Y a-t-il des lacunes dans les données collectées pendant la migration ?

Non. Nous fusionnons les données au moment de la requête.

Les anciennes requêtes de journal continuent-elles à fonctionner ?

Oui, leur fonctionnement reste inchangé.

Mes tableaux de bord qui ont des métriques et des graphiques de journaux épinglés continueront-ils de fonctionner après la migration ?

Oui, leur fonctionnement reste inchangé.

La migration affecte-t-elle l’accès aux données pour l’API AppInsights ?

Non. La migration n’affecte pas l’accès des API existantes aux données. Après la migration, vous pouvez accéder aux données directement à partir d’un espace de travail en utilisant un schéma légèrement différent.

Y a-t-il un impact sur les métriques en temps réel ou d’autres expériences de supervision ?

Non. Il n’existe aucun impact sur les métriques temps réel ou toute autre expérience de monitoring.

Qu’en est-il de l’exportation continue après la migration ?

Pour continuer avec les exportations automatisées, vous devez migrer vers les paramètres de diagnostic avant de migrer vers une ressource basée sur une espace de travail. Les paramètres de diagnostic sont reportés dans la migration vers la ressource Application Insights basée sur une espace de travail.

Comment garantir une migration réussie de ma ressource App Insights avec Terraform ?

Si vous utilisez Terraform pour gérer vos ressources Azure, il est important d’utiliser la dernière version du fournisseur Terraform azurerm avant de tenter de mettre à niveau votre ressource App Insights. L’utilisation d’une version antérieure du fournisseur, telle que la version 3.12, peut entraîner la suppression du composant classique avant de créer la ressource Application Insights basée sur l’espace de travail de remplacement. Cela peut entraîner la perte des données précédentes et vous contraindre à mettre à jour la configuration de vos applications surveillées avec les nouvelles valeurs de chaîne de connexion et de clé d’instrumentation.

Pour éviter ce problème, veillez à utiliser la dernière version du fournisseur Terraform azurerm, version 3.89 ou ultérieure, qui effectue les étapes de migration appropriées en émettant l’appel ARM approprié pour mettre à niveau la ressource classique App Insights vers une ressource basée sur un espace de travail tout en conservant toutes les anciennes valeurs de clé de connexion et de chaîne de connexion/clé d’instrumentation.

Puis-je encore utiliser l’ancienne API pour créer des ressources Application Insights par programmation ?

Pour la compatibilité descendante, les appels à l’ancienne API pour la création de ressources Application Insights continueront de fonctionner. Chacun de ces appels finira par créer à la fois une ressource Application Insights basée sur un espace de travail et un espace de travail Log Analytics pour stocker les données.

Nous encourageons vivement la mise à jour vers la nouvelle API pour mieux contrôler la création de ressources.

Dois-je migrer les paramètres de diagnostic de ressource Application Insights classiques avant de passer à une IA basée sur un espace de travail ?

Oui, nous vous recommandons de migrer vers les paramètres de diagnostic des ressources Application Insights classiques avant de passer à une ressource Application Insights basée sur un espace de travail. Cela garantit la continuité et la compatibilité de vos paramètres de diagnostic.

Dépannage

Cette section fournit des conseils pour la résolution des problèmes courants.

Mode d’accès

Message d’erreur : « L’espace de travail sélectionné est configuré avec le mode d’accès basé sur l’espace de travail. Certaines fonctionnalités d’analyse des performances des applications (APM) peuvent être affectées. Sélectionnez un autre espace de travail ou autorisez l’accès en fonction des ressources dans les paramètres de l’espace de travail. Vous pouvez corriger cette erreur à l’aide de l’interface CLI. »

Pour que votre ressource Application Insights basée sur un espace de travail fonctionne correctement, vous devez remplacer le mode de contrôle d’accès de l’espace de travail Log Analytics cible en définissant le paramètre Utiliser les autorisations de ressource ou d’espace de travail. Ce paramètre se trouve dans l’interface utilisateur de l’espace de travail Log Analytics sous Propriétés>Mode de contrôle d’accès. Pour obtenir des instructions, consultez les conseils d’aide sur la configuration du mode de contrôle d’accès de Log Analytics. Si votre mode de contrôle d’accès est défini sur le paramètre exclusif Exiger des autorisations d’espace de travail, la migration via l’expérience de migration du portail reste bloquée.

Si vous ne pouvez pas changer le mode de contrôle d’accès de votre espace de travail cible actuel pour des raisons de sécurité, créez un espace de travail Log Analytics à utiliser pour la migration.

Exportation continue

Message d’erreur : « L’exportation continue doit être désactivée avant de continuer. Après la migration, utilisez les paramètres de diagnostic pour l’exportation. »

La fonctionnalité héritée d’exportation continue n’est pas prise en charge pour les ressources basées sur un espace de travail. Avant de migrer, vous devez activer les paramètres de diagnostic et désactiver l’exportation continue.

  1. Activez les paramètres de diagnostic au niveau de votre ressource Application Insights classique.

  2. Dans l’affichage des ressources Application Insights, sous le titre Configurer, sélectionnez Exportation continue.

    Screenshot that shows the Continuous export menu item.

  3. Sélectionnez Désactiver.

    Screenshot that shows the Continuous export Disable button.

    • Une fois que vous avez sélectionné Désactiver, vous pouvez revenir à l’IU de migration. Si la page Modifier l’exportation continue vous indique que vos paramètres ne sont pas enregistrés, sélectionnez OK. Cette invite ne concerne pas la désactivation ou l’activation de l’exportation continue.

    • Une fois que vous avez réussi à migrer votre ressource Application Insights vers une ressource basée sur un espace de travail, vous pouvez utiliser les paramètres de diagnostic pour remplacer les fonctionnalités qui étaient fournies par l’exportation continue. 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, pour les archiver dans un compte de stockage ou les envoyer en streaming vers Azure Event Hubs. Pour plus d’informations sur les paramètres de diagnostic, consultez les conseils d’aide relatifs aux paramètres de diagnostic d’Azure Monitor.

Paramètres de rétention

Message d’avertissement : « Vos paramètres de conservation Application Insights personnalisés ne s’appliquent pas aux données envoyées à l’espace de travail. Vous devez les reconfigurer séparément. »

Vous n’avez pas besoin d’apporter de modifications avant de migrer. Ce message vous avertit que vos paramètres de conservation Application Insights actuels ne sont pas définis sur la période de conservation par défaut de 90 jours. Ce message d’avertissement signifie que vous pouvez être amené à modifier les paramètres de conservation de votre espace de travail Log Analytics avant la migration et le début de l’ingestion de nouvelles données.

Vous pouvez vérifier vos paramètres de conservation actuels pour Log Analytics sous Paramètres>Utilisation et coûts estimés>Conservation des données dans l’interface utilisateur Log Analytics. Ce paramètre affecte la durée de stockage des nouvelles données ingérées après la migration de votre ressource Application Insights.

Modifications des ressources basées sur un espace de travail

Avant l’introduction des ressources Application Insights basées sur un espace de travail, les données Application Insights étaient stockées séparément des autres données de journal dans Azure Monitor. Ces deux services sont basés sur Azure Data Explorer et utilisent le même langage de requête Kusto (KQL). Les données de ressources Application Insights basées sur l’espace de travail sont stockées dans un espace de travail Log Analytics ainsi qu’avec d’autres données d’analyse et données d’application. Cette disposition simplifie votre configuration. Vous pouvez analyser les données de plusieurs solutions plus facilement et utiliser les fonctionnalités des espaces de travail.

Structure de données classique

La structure d’un espace de travail Log Analytics est décrite dans Présentation de l’espace de travail Log Analytics. Pour une application classique, les données ne sont pas stockées dans un espace de travail Log Analytics. Il utilise le même langage de requête. Vous créez et exécutez des requêtes en utilisant le même outil Log Analytics dans le portail Azure. Les données des applications classiques sont stockées séparément les unes des autres. La structure générale est la même que celle des applications basées sur un espace de travail, bien que les noms de table et de colonne soient différents.

Notes

L’expérience classique Application Insights comprend la compatibilité descendante de vos requêtes de ressources, classeurs et alertes basées sur un journal. Pour interroger ou voir le nouveau schéma ou la nouvelle structure de table basée sur un espace de travail, accédez d’abord à votre espace de travail Log Analytics. Pendant la préversion, la sélection de Journaux dans le volet Application Insights vous donne accès à l’expérience de requête Application Insights classique. Pour plus d’informations, consultez Étendue de requête.

Diagram that shows the Azure Monitor Logs structure for Application Insights.

Structure de table

Nom de la table héritée Nouveau nom de table Description
availabilityResults AppAvailabilityResults Données de synthèse de tests de disponibilité.
browserTimings AppBrowserTimings Données sur les performances du client, comme le temps nécessaire pour traiter les données entrantes.
dependencies AppDependencies Appels depuis l’application à destination d’autres composants (notamment externes) enregistrés via TrackDependency(). Il s’agit, par exemple, d’appels à l’API REST, à une base de données ou à un système de fichiers.
customEvents AppEvents Événements personnalisés créés par votre application.
customMetrics AppMetrics Mesures personnalisées créées par votre application.
pageViews AppPageViews Données sur l’affichage de chaque site web avec des informations du navigateur.
performanceCounters AppPerformanceCounters Mesures de performances à partir des ressources de calcul qui prennent en charge l’application. Les compteurs de performances Windows en sont un bon exemple.
requêtes AppRequests Requêtes que votre application reçoit. Par exemple, un enregistrement de demande distinct est journalisé pour chaque requête HTTP que reçoit votre application web.
exceptions AppExceptions Exceptions levées par l’exécution de l’application. Capture les exceptions côté serveur et côté client (navigateurs).
traces AppTraces Journaux détaillés (traces) émis via le code d’application/les frameworks de journalisation enregistrés via TrackTrace().

Attention

Attendez que de nouvelles données de télémétrie dans Log Analytics s’appuient dessus. Après avoir démarré la migration, la télémétrie passe d’abord à Application Insights classique. L’ingestion de télémétrie est passée à Log Analytics dans les 24 heures. Une fois l’opération terminée, Log Analytics capture uniquement de nouvelles données de télémétrie.

Schémas de table

Les sections suivantes répertorient les mappages entre les noms de propriétés classiques et les nouveaux noms de propriété de Application Insights basés sur l’espace de travail. Utilisez ces informations pour convertir toutes les requêtes avec des tables héritées.

La plupart des colonnes ont presque le même nom : seules leurs majuscules changent. Comme KQL respecte la casse, vous devez changer chaque nom de colonne en même temps que les noms de tables dans les requêtes existantes. Les colonnes contenant d’autres modifications que les changements de majuscules sont mises en surbrillance. Vous pouvez toujours utiliser vos requêtes Application Insights classiques dans le volet Logs (Journaux) de votre ressource Application Insights, même s’il s’agit d’une ressource basée sur un espace de travail. Les nouveaux noms de propriétés sont obligatoires quand vous effectuez une requête dans le contexte de l’expérience d’un espace de travail Log Analytics.

AppAvailabilityResults

Table héritée : availabilityResults

ApplicationInsights Type LogAnalytics Type
appId string ResourceGUID string
application_Version string AppVersion string
appName string _ResourceId string
client_Browser string ClientBrowser string
client_City string ClientCity string
client_CountryOrRegion string ClientCountryOrRegion string
client_IP string ClientIP string
client_Model string ClientModel string
client_OS string ClientOS string
client_StateOrProvince string ClientStateOrProvince string
client_Type string ClientType string
cloud_RoleInstance string AppRoleInstance string
cloud_RoleName string AppRoleName string
customDimensions dynamique Propriétés Dynamique
customMeasurements dynamique Mesures Dynamique
duration real DurationMs real
id string Id string
iKey string IKey string
itemCount int ItemCount int
itemId string _ItemId string
itemType string Type String
location string Emplacement string
message string Message string
name string Nom string
operation_Id string OperationId string
operation_Name string NomOpération string
operation_ParentId string ParentId string
operation_SyntheticSource string OperationSyntheticSource string
performanceBucket string PerformanceBucket string
sdkVersion string SDKVersion string
session_Id string SessionId string
taille real Taille real
success string Succès Bool
timestamp DATETIME TimeGenerated DATETIME
user_AccountId string UserAccountId string
user_AuthenticatedId string UserAuthenticatedId string
user_Id string UserId string

AppBrowserTimings

Table héritée : browserTimings

ApplicationInsights Type LogAnalytics Type
appId string ResourceGUID string
application_Version string AppVersion string
appName string _ResourceId string
client_Browser string ClientBrowser string
client_City string ClientCity string
client_CountryOrRegion string ClientCountryOrRegion string
client_IP string ClientIP string
client_Model string ClientModel string
client_OS string ClientOS string
client_StateOrProvince string ClientStateOrProvince string
client_Type string ClientType string
cloud_RoleInstance string AppRoleInstance string
cloud_RoleName string AppRoleName string
customDimensions dynamique Propriétés Dynamique
customMeasurements dynamique Mesures Dynamique
iKey string IKey string
itemCount int ItemCount int
itemId string _ItemId string
itemType string Type string
name string Nom DATETIME
networkDuration real NetworkDurationMs real
operation_Id string OperationId string
operation_Name string NomOpération string
operation_ParentId string ParentId string
operation_SyntheticSource string OperationSyntheticSource string
performanceBucket string PerformanceBucket string
processingDuration real ProcessingDurationMs real
receiveDuration real ReceiveDurationMs real
sdkVersion string SDKVersion string
sendDuration real SendDurationMs real
session_Id string SessionId string
timestamp DATETIME TimeGenerated DATETIME
totalDuration real TotalDurationMs real
url string Url string
user_AccountId string UserAccountId string
user_AuthenticatedId string UserAuthenticatedId string
user_Id string UserId string

AppDependencies

Table héritée : dependencies

ApplicationInsights Type LogAnalytics Type
appId string ResourceGUID string
application_Version string AppVersion string
appName string _ResourceId string
client_Browser string ClientBrowser string
client_City string ClientCity string
client_CountryOrRegion string ClientCountryOrRegion string
client_IP string ClientIP string
client_Model string ClientModel string
client_OS string ClientOS string
client_StateOrProvince string ClientStateOrProvince string
client_Type string ClientType string
cloud_RoleInstance string AppRoleInstance string
cloud_RoleName string AppRoleName string
customDimensions dynamique Propriétés Dynamique
customMeasurements dynamique Mesures Dynamique
data string Données string
duration real DurationMs real
id string Id string
iKey string IKey string
itemCount int ItemCount int
itemId string _ItemId string
itemType string Type String
name string Nom string
operation_Id string OperationId string
operation_Name string NomOpération string
operation_ParentId string ParentId string
operation_SyntheticSource string OperationSyntheticSource string
performanceBucket string PerformanceBucket string
resultCode string ResultCode string
sdkVersion string SDKVersion string
session_Id string SessionId string
success string Succès Bool
target string Cible string
timestamp DATETIME TimeGenerated DATETIME
type string DependencyType string
user_AccountId string UserAccountId string
user_AuthenticatedId string UserAuthenticatedId string
user_Id string UserId string

AppEvents

Table héritée : customEvents

ApplicationInsights Type LogAnalytics Type
appId string ResourceGUID string
application_Version string AppVersion string
appName string _ResourceId string
client_Browser string ClientBrowser string
client_City string ClientCity string
client_CountryOrRegion string ClientCountryOrRegion string
client_IP string ClientIP string
client_Model string ClientModel string
client_OS string ClientOS string
client_StateOrProvince string ClientStateOrProvince string
client_Type string ClientType string
cloud_RoleInstance string AppRoleInstance string
cloud_RoleName string AppRoleName string
customDimensions dynamique Propriétés Dynamique
customMeasurements dynamique Mesures Dynamique
iKey string IKey string
itemCount int ItemCount int
itemId string _ItemId string
itemType string Type string
name string Nom string
operation_Id string OperationId string
operation_Name string NomOpération string
operation_ParentId string ParentId string
operation_SyntheticSource string OperationSyntheticSource string
sdkVersion string SDKVersion string
session_Id string SessionId string
timestamp DATETIME TimeGenerated DATETIME
user_AccountId string UserAccountId string
user_AuthenticatedId string UserAuthenticatedId string
user_Id string UserId string

AppMetrics

Table héritée : customMetrics

ApplicationInsights Type LogAnalytics Type
appId string ResourceGUID string
application_Version string AppVersion string
appName string _ResourceId string
client_Browser string ClientBrowser string
client_City string ClientCity string
client_CountryOrRegion string ClientCountryOrRegion string
client_IP string ClientIP string
client_Model string ClientModel string
client_OS string ClientOS string
client_StateOrProvince string ClientStateOrProvince string
client_Type string ClientType string
cloud_RoleInstance string AppRoleInstance string
cloud_RoleName string AppRoleName string
customDimensions dynamique Propriétés Dynamique
iKey string IKey string
itemId string _ItemId string
itemType string Type string
name string Nom string
operation_Id string OperationId string
operation_Name string NomOpération string
operation_ParentId string ParentId string
operation_SyntheticSource string OperationSyntheticSource string
sdkVersion string SDKVersion string
session_Id string SessionId string
timestamp DATETIME TimeGenerated DATETIME
user_AccountId string UserAccountId string
user_AuthenticatedId string UserAuthenticatedId string
user_Id string UserId string
value real (supprimé)
valueCount int ItemCount int
valueMax real ValueMax real
valueMin real ValueMin real
valueSum real ValueSum real

Notes

Les versions antérieures des SDK Application Insights permettaient de signaler l’écart type (valueStdDev) dans la préagrégation des métriques. En raison de sa faible adoption dans l’analyse des métriques, le champ a été supprimé et n’est plus agrégé par les kits SDK. Si le point de terminaison de collecte de données Application Insights reçoit la valeur, elle est supprimée durant l’ingestion et n’est pas envoyée à l’espace de travail Log Analytics. Si vous voulez utiliser l’écart type dans votre analyse, utilisez des requêtes sur des événements bruts Application Insights.

AppPageViews

Table héritée : pageViews

ApplicationInsights Type LogAnalytics Type
appId string ResourceGUID string
application_Version string AppVersion string
appName string _ResourceId string
client_Browser string ClientBrowser string
client_City string ClientCity string
client_CountryOrRegion string ClientCountryOrRegion string
client_IP string ClientIP string
client_Model string ClientModel string
client_OS string ClientOS string
client_StateOrProvince string ClientStateOrProvince string
client_Type string ClientType string
cloud_RoleInstance string AppRoleInstance string
cloud_RoleName string AppRoleName string
customDimensions dynamique Propriétés Dynamique
customMeasurements dynamique Mesures Dynamique
duration real DurationMs real
id string Id string
iKey string IKey string
itemCount int ItemCount int
itemId string _ItemId string
itemType string Type String
name string Nom string
operation_Id string OperationId string
operation_Name string NomOpération string
operation_ParentId string ParentId string
operation_SyntheticSource string OperationSyntheticSource string
performanceBucket string PerformanceBucket string
sdkVersion string SDKVersion string
session_Id string SessionId string
timestamp DATETIME TimeGenerated DATETIME
url string Url string
user_AccountId string UserAccountId string
user_AuthenticatedId string UserAuthenticatedId string
user_Id string UserId string

AppPerformanceCounters

Table héritée : performanceCounters

ApplicationInsights Type LogAnalytics Type
appId string ResourceGUID string
application_Version string AppVersion string
appName string _ResourceId string
catégorie string Category string
client_Browser string ClientBrowser string
client_City string ClientCity string
client_CountryOrRegion string ClientCountryOrRegion string
client_IP string ClientIP string
client_Model string ClientModel string
client_OS string ClientOS string
client_StateOrProvince string ClientStateOrProvince string
client_Type string ClientType string
cloud_RoleInstance string AppRoleInstance string
cloud_RoleName string AppRoleName string
counter string (supprimé)
customDimensions dynamique Propriétés Dynamique
iKey string IKey string
instance string Instance string
itemId string _ItemId string
itemType string Type string
name string Nom string
operation_Id string OperationId string
operation_Name string NomOpération string
operation_ParentId string ParentId string
operation_SyntheticSource string OperationSyntheticSource string
sdkVersion string SDKVersion string
session_Id string SessionId string
timestamp DATETIME TimeGenerated DATETIME
user_AccountId string UserAccountId string
user_AuthenticatedId string UserAuthenticatedId string
user_Id string UserId string
value real Valeur real

AppRequests

Table héritée : requests

ApplicationInsights Type LogAnalytics Type
appId string ResourceGUID string
application_Version string AppVersion string
appName string _ResourceId string
client_Browser string ClientBrowser string
client_City string ClientCity string
client_CountryOrRegion string ClientCountryOrRegion string
client_IP string ClientIP string
client_Model string ClientModel string
client_OS string ClientOS string
client_StateOrProvince string ClientStateOrProvince string
client_Type string ClientType string
cloud_RoleInstance string AppRoleInstance string
cloud_RoleName string AppRoleName string
customDimensions dynamique Propriétés Dynamique
customMeasurements dynamique Mesures Dynamique
duration real DurationMs Real
id string Id String
iKey string IKey string
itemCount int ItemCount int
itemId string _ItemId string
itemType string Type String
name string Nom String
operation_Id string OperationId string
operation_Name string NomOpération string
operation_ParentId string ParentId string
operation_SyntheticSource string OperationSyntheticSource string
performanceBucket string PerformanceBucket String
resultCode string ResultCode String
sdkVersion string SDKVersion string
session_Id string SessionId string
source string Source String
success string Succès Bool
timestamp DATETIME TimeGenerated DATETIME
url string Url String
user_AccountId string UserAccountId string
user_AuthenticatedId string UserAuthenticatedId string
user_Id string UserId string

AppExceptions

Table héritée : exceptions

ApplicationInsights Type LogAnalytics Type
appId string ResourceGUID string
application_Version string AppVersion string
appName string _ResourceId string
assembly string Assembly string
client_Browser string ClientBrowser string
client_City string ClientCity string
client_CountryOrRegion string ClientCountryOrRegion string
client_IP string ClientIP string
client_Model string ClientModel string
client_OS string ClientOS string
client_StateOrProvince string ClientStateOrProvince string
client_Type string ClientType string
cloud_RoleInstance string AppRoleInstance string
cloud_RoleName string AppRoleName string
customDimensions dynamique Propriétés dynamique
customMeasurements dynamique Mesures dynamique
details dynamique Détails dynamique
handledAt string HandledAt string
iKey string IKey string
innermostAssembly string InnermostAssembly string
innermostMessage string InnermostMessage string
innermostMethod string InnermostMethod string
innermostType string InnermostType string
itemCount int ItemCount int
itemId string _ItemId string
itemType string Type string
message string Message string
method string Méthode string
operation_Id string OperationId string
operation_Name string NomOpération string
operation_ParentId string ParentId string
operation_SyntheticSource string OperationSyntheticSource string
outerAssembly string OuterAssembly string
outerMessage string OuterMessage string
outerMethod string OuterMethod string
outerType string OuterType string
problemId string ProblemId string
sdkVersion string SDKVersion string
session_Id string SessionId string
severityLevel int SeverityLevel int
timestamp DATETIME TimeGenerated DATETIME
type string ExceptionType string
user_AccountId string UserAccountId string
user_AuthenticatedId string UserAuthenticatedId string
user_Id string UserId string

AppTraces

Table héritée : traces

ApplicationInsights Type LogAnalytics Type
appId string ResourceGUID string
application_Version string AppVersion string
appName string _ResourceId string
client_Browser string ClientBrowser string
client_City string ClientCity string
client_CountryOrRegion string ClientCountryOrRegion string
client_IP string ClientIP string
client_Model string ClientModel string
client_OS string ClientOS string
client_StateOrProvince string ClientStateOrProvince string
client_Type string ClientType string
cloud_RoleInstance string AppRoleInstance string
cloud_RoleName string AppRoleName string
customDimensions dynamique Propriétés dynamique
customMeasurements dynamique Mesures dynamique
iKey string IKey string
itemCount int ItemCount int
itemId string _ItemId string
itemType string Type string
message string Message string
operation_Id string OperationId string
operation_Name string NomOpération string
operation_ParentId string ParentId string
operation_SyntheticSource string OperationSyntheticSource string
sdkVersion string SDKVersion string
session_Id string SessionId string
severityLevel int SeverityLevel int
timestamp DATETIME TimeGenerated DATETIME
user_AccountId string UserAccountId string
user_AuthenticatedId string UserAuthenticatedId string
user_Id string UserId string

Étapes suivantes