Migrer les clés d’instrumentation de Application Insights vers des chaînes de connexion

Application Insights passe des points de terminaison d’ingestion globaux aux points de terminaison régionaux qui utilisent des chaînes de connexion, qui fournissent des fonctionnalités supplémentaires.

Scénarios les plus affectés par cette modification :

Exceptions de pare-feu ou redirections de proxy : dans les cas où la surveillance du serveur web intranet est requise, notre solution précédente vous a demandé d’ajouter des points de terminaison de service individuels à votre configuration. Pour plus d'informations, reportez-vous à Puis-je surveiller un serveur web intranet ? Les chaînes de connexion offrent une meilleure alternative en réduisant cet effort à un seul paramètre. La simple modification d’un préfixe et d’un suffixe permet de renseigner automatiquement tous les points de terminaison et de les rediriger vers les services appropriés.
Environnements cloud souverains ou hybrides : les utilisateurs peuvent envoyer des données à une région Azure Government définie. À l’aide de chaînes de connexion, vous avez la possibilité de définir des paramètres de point de terminaison pour vos serveurs intranet ou des paramètres cloud hybrides.

Cet article décrit la migration des clés d’instrumentation vers des chaînes de connexion.

Conditions préalables

Une version du SDK prise en charge
Ressource Application Insights existante

Migration

Accédez au panneau Vue d’ensemble de votre ressource Application Insights.
Recherchez votre 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 Kit de développement logiciel (SDK) Application Insights en suivant comment définir des chaînes de connexion.

Important

N’utilisez pas à la fois une chaîne de connexion et une clé d’instrumentation. Ce dernier jeu remplace l’autre et pourrait entraîner la non-apparition des données de télémétrie sur le portail. Voir les données manquantes.

Migration à grande échelle

Utilisez des variables d’environnement pour passer une chaîne de connexion au Kit de développement logiciel (SDK) Ou à l’agent Application Insights.

Pour définir une chaîne de connexion via une variable d’environnement, placez la valeur de la chaîne de connexion dans une variable d’environnement nommé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 correcte avec un déploiement Azure App Service. Veillez à inclure les autres paramètres 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')]"
            }
        }
    ]
}

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+

Résolution des problèmes

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 décrites dans 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 d’Application Insights dans une autre offre de produit Azure, consultez sa documentation sur la façon de configurer correctement une chaîne de connexion.
Vérifiez que vous ne définissez pas à la fois 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.
Vérifiez que votre chaîne de connexion est exactement telle que fournie dans le portail Azure.

Les variables d’environnement ne fonctionnent pas

Si vous codez en dur une clé d’instrumentation dans votre code d’application, cette programmation peut être prioritaire avant les variables d’environnement.

Questions fréquentes

Cette section fournit des réponses aux questions courantes.

Où puis-je trouver ma chaîne de connexion ?

La chaîne de connexion est également incluse dans les propriétés de ressource du Gestionnaire de ressources de votre ressource Application Insights, sous le nom du champ ConnectionString.

Comment cela affecte-t-il l’autoinstrumentation ?

Les scénarios d’autoinstrumentation ne sont pas affectés.

Puis-je utiliser l’authentification Microsoft Entra avec l’autoinstrumentation ?

Vous ne pouvez pas activer l’authentification Microsoft Entra pour les scénarios d’autoinstrumentation . Nous avons des plans pour résoudre cette limitation à l’avenir.

Quelle est la différence entre l’ingestion mondiale et régionale ?

L’ingestion globale envoie toutes les données de télémétrie à un point de terminaison unique, quel que soit l’emplacement où ces données seront 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.

Comment les chaînes de connexion affectent-elles la facturation ?

La facturation n’est pas affectée.

Microsoft Q&A

Publiez des questions sur le forum des réponses.

Last updated on 2024-10-10

Partager via