Chaîne de connexion dans Application Insights
Les chaînes de connexion spécifient la ressource Application Insights à laquelle votre application instrumentée doit envoyer des données de télémétrie. Une chaîne de connexion est composée de plusieurs paramètres, chacun représenté sous la forme d’une paire clé-valeur et séparé par des points-virgules. Cette méthode de configuration consolidée simplifie le processus d’installation en éliminant la nécessité de plusieurs paramètres proxy.
Important
La chaîne de connexion contient une clé ikey, un identificateur unique utilisé par le service d’ingestion pour associer la télémétrie à une ressource Application Insights spécifique. Les identificateurs uniques Ikey ne sont pas des jetons de sécurité ni des clés de sécurité et ne sont pas considérés comme des secrets.
Si vous souhaitez protéger votre ressource Application Insights contre une mauvaise utilisation, le point de terminaison d’ingestion fournit des options d’ingestion de télémétrie authentifiées basées sur Microsoft Entra ID.
Remarque
Le support de l’ingestion de clé d’instrumentation prendra fin le 31 mars 2025. 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.
Fonctionnalités de la chaîne de connexion
- 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.
Rechercher votre chaîne de connexion
Votre chaîne de connexion s’affiche dans la section Vue d’ensemble de votre ressource Application Insights.
schéma
Les éléments de schéma sont expliqués dans les sections suivantes.
Longueur maximale
La longueur maximale prise en charge pour la connexion s’élève à 4 096 caractères.
Paires clé-valeur
Une chaîne de connexion se compose d’une liste de paramètres représentés sous forme de paires clé-valeur séparées par un point-virgule : key1=value1;key2=value2;key3=value3.
Conseil
Les paires clé-valeur configurables sont abordées dans ce document. Certaines paires clé-valeur ne sont pas configurables et sont définies automatiquement, telles que ApplicationId. Celles-ci peuvent être ignorées en toute sécurité si vous les observez dans votre environnement.
Syntaxe
InstrumentationKey(par exemple 00000000-0000-0000-0000-000000000000).InstrumentationKeyest un champ obligatoire.Authorization(par exemple ikey). Ce paramètre est facultatif, car seule l’autorisation ikey est prise en charge à l’heure actuelle.EndpointSuffix(par exemple applicationinsights.azure.cn). La définition du suffixe du point de terminaison indique au SDK à quel cloud Azure se connecter. Le SDK assemble le reste du point de terminaison pour les services individuels.Points de terminaison explicites. Tout service peut être substitué explicitement dans la chaîne de connexion :
IngestionEndpoint(par exemple,https://dc.applicationinsights.azure.com)LiveEndpoint(par exemple,https://live.applicationinsights.azure.com)ProfilerEndpoint(par exemple,https://profiler.monitor.azure.com)SnapshotEndpoint(par exemple,https://snapshot.monitor.azure.com)
Schéma de point de terminaison
<prefix>.<suffix>
- Préfixe : Définit un service.
- Suffixe : Définit le nom de domaine commun.
Suffixes valides
- applicationinsights.azure.cn
- applicationinsights.us
Pour plus d’informations, consultez Régions qui exigent une modification du point de terminaison.
Préfixes valides
- Ingestion de données de télémétrie :
dc - Métriques temps réel :
live - Profileur pour .NET :
profiler - Capture instantanée :
snapshot
Exemples de chaînes de connexion courantes
Voici quelques exemples de chaînes de connexion.
Chaîne de connexion avec suffixe de point de terminaison
InstrumentationKey=00000000-0000-0000-0000-000000000000;EndpointSuffix=ai.contoso.com;
Dans cet exemple, la chaîne de connexion spécifie le suffixe du point de terminaison et le SDK construit des points de terminaison de service :
- Le schéma d’autorisation est défini par défaut sur « ikey »
- Clé d’instrumentation : 00000000-0000-0000-0000-000000000000
- Les URI (Uniform Resource Identifiers) de services régionaux se basent sur le suffixe du point de terminaison fourni :
- Ingestion :
https://dc.ai.contoso.com - Métriques en temps réel :
https://live.ai.contoso.com - Profileur pour .NET :
https://profiler.ai.contoso.com - Débogueur :
https://snapshot.ai.contoso.com
- Ingestion :
Chaîne de connexion avec des substitutions de points de terminaison explicites
InstrumentationKey=00000000-0000-0000-0000-000000000000;IngestionEndpoint=https://custom.com:111/;LiveEndpoint=https://custom.com:222/;ProfilerEndpoint=https://custom.com:333/;SnapshotEndpoint=https://custom.com:444/;
Dans cet exemple, la chaîne de connexion spécifie des substitutions explicites pour chaque service. Le SDK utilise les points de terminaison exacts fournis sans modification :
- Le schéma d’autorisation est défini par défaut sur « ikey »
- Clé d’instrumentation : 00000000-0000-0000-0000-000000000000
- Les URI de services régionaux se basent sur les valeurs de remplacement explicites :
- Ingestion :
https://custom.com:111/ - Métriques en temps réel :
https://custom.com:222/ - Profileur pour .NET :
https://custom.com:333/ - Débogueur :
https://custom.com:444/
- Ingestion :
Chaîne de connexion avec région explicite
InstrumentationKey=00000000-0000-0000-0000-000000000000;IngestionEndpoint=https://southcentralus.in.applicationinsights.azure.com/
Dans cet exemple, la chaîne de connexion spécifie la région USA Centre Sud :
- Le schéma d’autorisation est défini par défaut sur « ikey »
- Clé d’instrumentation : 00000000-0000-0000-0000-000000000000
- Les URI de services régionaux se basent sur les valeurs de remplacement explicites :
- Ingestion :
https://southcentralus.in.applicationinsights.azure.com/
- Ingestion :
Pour obtenir la liste des régions disponibles, exécutez la commande suivante dans Azure CLI :
az account list-locations -o table
Définition d’une chaîne de connexion
Toutes nos offres OpenTelemetry et les versions suivantes du Kit de développement logiciel (SDK) prennent en charge les chaînes de connexion :
- .NET v2.12.0
- JavaScript v2.3.0
- NodeJS v1.5.0
- Python v1.0.0
Il est possible de définir une chaîne de connexion dans du code à l’aide d’une variable d’environnement ou d’un fichier de configuration.
Variable d’environnement
Chaîne de connexion : APPLICATIONINSIGHTS_CONNECTION_STRING
Exemples de code
| Langue | API classique | OpenTelemetry |
|---|---|---|
| ASP.NET Core | Kit de développement logiciel (SDK) Application Insights | AzMon OTel Distro |
| .NET Framework | Kit de développement logiciel (SDK) Application Insights | Exportateur AzMon |
| Java | N/A | Agent Java |
| JavaScript | Script de chargement du kit de développement logiciel (SDK) JavaScript (web) | N/A |
| Node.JS | Kit de développement logiciel (SDK) Application Insights | AzMon OTel Distro |
| Python | SDK OpenCensus pour Python | AzMon OTel Distro |
Forum aux questions
Cette section fournit des réponses aux questions fréquentes.
Les nouvelles régions Azure exigent-elles l’utilisation de chaînes de connexion ?
Les nouvelles régions Azure exigent l’utilisation de chaînes de connexion au lieu de clés d’instrumentation. Une chaîne de connexion identifie la ressource que vous voulez associer à vos données de télémétrie. Elle vous permet également de modifier les points de terminaison que votre ressource utilisera comme destination pour votre télémétrie. Copiez la chaîne de connexion et ajoutez-la au code de votre application ou à une variable d’environnement.
Dois-je utiliser des chaînes de connexion ou des clés d’instrumentation ?
Nous vous recommandons d’utiliser des chaînes de connexion plutôt que des clés d’instrumentation.
Étapes suivantes
Prise en main lors de l’exécution avec :
- Applications hébergées par IIS sur une machine virtuelle Azure et Azure Virtual Machine Scale Sets
- Serveur IIS (Internet Information Server)
- Fonctionnalité Web Apps d’Azure App Service
Prise en main pendant le développement avec :