Migrer à partir de clés d'instrumentation Application Insights vers des chaînes de connexion
Cet article vous guide tout au long de la migration des clés d’instrumentation aux chaînes de connexion.
Prérequis
- Une version du SDK prise en charge
- Une ressource Application Insights existante
Migration
Accédez au panneau Vue d’ensemble de votre ressource Application Insights.
Recherchez la Chaîne de connexion affichée à droite.
Pointez sur la chaîne de connexion et sélectionnez l’icône Copier dans le Presse-papiers.
Configurez le SDK Application Insights en suivant la procédure de définition des chaînes de connexion.
Important
N'utilisez pas à la fois une chaîne de connexion et une clé d'instrumentation. Ce dernier ensemble remplace l'autre et pourrait entraîner la non-apparition de la télémétrie sur le portail. Consultez les données manquantes.
Migration à l’échelle
Utilisez des variables d’environnement pour transmettre une chaîne de connexion au Kit de développement logiciel (SDK) Application Insights ou à l’agent.
Pour définir une chaîne de connexion par le biais d’une variable d’environnement, placez la valeur de la chaîne de connexion dans une variable d’environnement appelée APPLICATIONINSIGHTS_CONNECTION_STRING.
Ce processus peut être automatisé dans vos déploiements Azure. Par exemple, le modèle Azure Resource Manager suivant montre comment inclure automatiquement la chaîne de connexion appropriée avec un déploiement Azure App Service. Veillez à inclure tout autre paramètre d’application dont votre application a besoin :
{
"$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
"contentVersion": "1.0.0.0",
"parameters": {
"appServiceName": {
"type": "string",
"metadata": {
"description": "Name of the App Services resource"
}
},
"appServiceLocation": {
"type": "string",
"metadata": {
"description": "Location to deploy the App Services resource"
}
},
"appInsightsName": {
"type": "string",
"metadata": {
"description": "Name of the existing Application Insights resource to use with this App Service. Expected to be in the same Resource Group."
}
}
},
"resources": [
{
"apiVersion": "2016-03-01",
"name": "[parameters('appServiceName')]",
"type": "microsoft.web/sites",
"location": "[parameters('appServiceLocation')]",
"properties": {
"siteConfig": {
"appSettings": [
{
"name": "APPLICATIONINSIGHTS_CONNECTION_STRING",
"value": "[reference(concat('microsoft.insights/components/', parameters('appInsightsName')), '2015-05-01').ConnectionString]"
}
]
},
"name": "[parameters('appServiceName')]"
}
}
]
}
Nouvelles fonctionnalités
Les chaînes de connexion fournissent un paramètre de configuration unique et éliminent la nécessité de disposer de plusieurs paramètres de proxy.
- Fiabilité : Les chaînes de connexion rendent l’ingestion de la télémétrie plus fiable en supprimant les dépendances sur les points de terminaison d’ingestion globaux.
- Sécurité : les chaînes de connexion permettent l’ingestion des données de télémétrie authentifiées en utilisant l’authentification Microsoft Entra pour Application Insights.
- Points de terminaison personnalisés (environnements cloud souverains ou hybrides) : Les paramètres de point de terminaison permettent d’envoyer des données à une région Azure Government spécifique. (Consultez des exemples.)
- Confidentialité (points de terminaison régionaux) : Les chaînes de connexion allègent les problèmes de confidentialité en envoyant des données à des points de terminaison régionaux, ce qui garantit que les données ne sortent pas d’une région géographique.
Versions prises en charge du kit de développement logiciel (SDK)
- .NET et .NET Core v2.12.0+
- Java v2.5.1 et Java 3.0+
- JavaScript v2.3.0+
- NodeJS v1.5.0+
- Python v1.0.0+
Dépannage
Cette section fournit des solutions de dépannage.
Alerte : « Transition vers l’utilisation de chaînes de connexion pour l’ingestion de données »
Suivez les étapes de migration de cet article pour résoudre cette alerte.
Données manquantes
- Vérifiez que vous utilisez une version du Kit de développement logiciel (SDK) prise en charge. Si vous utilisez l’intégration Application Insights dans une autre offre de produit Azure, consultez sa documentation pour savoir comment configurer correctement une chaîne de connexion.
- Vérifiez que vous ne définissez pas une clé d’instrumentation et une chaîne de connexion en même temps. Les paramètres de clé d’instrumentation doivent être supprimés de votre configuration.
- Confirmez que votre chaîne de connexion est exactement la même que celle fournie dans le Portail Azure.
Les variables d’environnement ne fonctionnent pas
Si vous codez en dur une clé d’instrumentation dans le code de votre application, cette programmation risque d’être prioritaire sur les variables d’environnement.
Forum aux questions
Cette section fournit des réponses aux questions fréquentes.
Où puis-je trouver ma chaîne de connexion ?
La chaîne de connexion est également incluse dans les propriétés Resource Manager pour votre ressource Application Insights, sous le nom de champ ConnectionString.
Comment cela affecte-t-il l’instrumentation automatique ?
Les scénarios d’instrumentation automatique ne sont pas affectés.
Puis-je utiliser l’authentification Microsoft Entra avec l’instrumentation automatique ?
Vous ne pouvez pas activer l’authentification Microsoft Entra pour les scénarios d’instrumentation automatique. Nous avons l’intention de répondre à cette limitation à l’avenir.
Quelle est la différence entre l’ingestion mondiale et l’ingestion régionale ?
L’ingestion mondiale envoie toutes les données de télémétrie à un seul point de terminaison, quel que soit l’emplacement où ces données sont stockées. L’ingestion régionale vous permet de définir des points de terminaison spécifiques par région pour l’ingestion de données. Cette fonctionnalité garantit que les données restent dans une région spécifique pendant le traitement et le stockage.
Dans quelle mesure les chaînes de connexion affectent-elles la facturation ?
La facturation n’est pas affectée.
Microsoft Q&A
Posez des questions sur le forum.