Verbindungszeichenfolgen in Application Insights

Verbindungszeichenfolgen geben an, an welche Application Insights-Ressource Ihre instrumentierte Anwendung Telemetriedaten senden soll. Eine Verbindungszeichenfolge besteht aus mehreren Einstellungen, die jeweils als Schlüsselwertpaar dargestellt und durch Semikolons getrennt sind. Diese konsolidierte Konfigurationsmethode vereinfacht den Einrichtungsprozess, indem die Notwendigkeit mehrerer Proxyeinstellungen eliminiert wird.

Verbindungszeichenfolgenfunktionen

• Zuverlässigkeit: Verbindungszeichenfolgen machen die Erfassung von Telemetriedaten zuverlässiger, indem Abhängigkeiten von globalen Erfassungsendpunkten entfallen.
• Sicherheit: Verbindungszeichenfolgen ermöglichen die Erfassung authentifizierter Telemetriedaten mithilfe der Microsoft Entra-Authentifizierung für Application Insights.
• Benutzerdefinierte Endpunkte (Sovereign Cloud- oder Hybrid Cloud-Umgebungen): Endpunkteinstellungen ermöglichen das Senden von Daten an eine bestimmte Azure Government-Region. (Beispiele finden Sie hier.)
• Datenschutz (regionale Endpunkte): Verbindungszeichenfolgen tragen Datenschutzbedenken Rechnung, indem sie Daten an regionale Endpunkte senden und so sicherstellen, dass Daten die geografische Region nicht verlassen.

Finden Sie Ihre Verbindungszeichenfolge

Ihre Verbindungszeichenfolge wird im Abschnitt Übersicht Ihrer Application Insights-Ressource angezeigt.

Schema

Schemaelemente werden in den folgenden Abschnitten erläutert.

Max. Länge

Die Verbindung hat eine maximal unterstützte Länge von 4.096 Zeichen.

Schlüssel-Wert-Paare

Eine Verbindungszeichenfolge besteht aus einer Liste von Einstellungen, die als durch Semikolon getrennte Schlüssel-Wert-Paare dargestellt werden: key1=value1;key2=value2;key3=value3

Syntax

• InstrumentationKey (Beispiel: 00000000-0000-0000-0000-000000000000) InstrumentationKey ist ein vorgegebenes Feld.

• Authorization (z. B. ikey). Diese Einstellung ist optional, da wir derzeit nur die ikey-Autorisierung unterstützen.

• EndpointSuffix(z. B. applicationinsights.azure.cn). Das Festlegen des Endpunktsuffix weist das SDK an, mit welcher Azure-Cloud eine Verbindung hergestellt werden soll. Das SDK stellt den Rest des Endpunkts für die einzelnen Dienste zusammen.

• Explizite Endpunkte. Jeder Dienst kann explizit in der Verbindungszeichenfolge überschrieben werden:

  • IngestionEndpoint (z. B. https://dc.applicationinsights.azure.com)
  • LiveEndpoint (z. B. https://live.applicationinsights.azure.com)
  • ProfilerEndpoint (z. B. https://profiler.monitor.azure.com)
  • SnapshotEndpoint (z. B. https://snapshot.monitor.azure.com)

Endpunktschema

<prefix>.<suffix>

• Präfix: Definiert einen Dienst.
• Suffix: Definiert den allgemeinen Domänennamen.

Gültige Suffixe

• applicationinsights.azure.cn
• applicationinsights.us

Weitere Informationen finden Sie in Regionen, in denen Endpunktänderungen erforderlich sind.

Gültige Präfixe

• Telemetriedatenerfassung:dc
• Livemetriken:live
• Profiler für .NET:profiler
• Momentaufnahme:snapshot

Beispiele für Verbindungszeichenfolgen

Hier sind einige Beispiele für Verbindungszeichenfolgen.

Verbindungszeichenfolge mit einem Endpunktsuffix

InstrumentationKey=00000000-0000-0000-0000-000000000000;EndpointSuffix=ai.contoso.com;

In diesem Beispiel gibt die Verbindungszeichenfolge das Endpunktsuffix an und das SDK erstellt Dienstendpunkte:

• Das Autorisierungsschema ist standardmäßig „ikey“.
• Instrumentierungsschlüssel: 00000000-0000-0000-0000-000000000000
• Die regionalen Dienst-URIs (Uniform Resource Identifier) basieren auf dem bereitgestellten Endpunktsuffix:
  • Erfassung: https://dc.ai.contoso.com
  • Livemetriken: https://live.ai.contoso.com
  • Profiler für .NET: https://profiler.ai.contoso.com
  • Debugger: https://snapshot.ai.contoso.com

Verbindungszeichenfolge mit expliziten Endpunktüberschreibungen

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/;

In diesem Beispiel gibt diese Verbindungszeichenfolge explizite Überschreibungen für jeden Dienst an. Das SDK verwendet die genauen Endpunkte, die ohne Änderung bereitgestellt werden:

• Das Autorisierungsschema ist standardmäßig „ikey“.
• Instrumentierungsschlüssel: 00000000-0000-0000-0000-000000000000
• Die regionalen Dienst-URIs basieren auf den expliziten Überschreibungswerten:
  • Erfassung: https://custom.com:111/
  • Livemetriken: https://custom.com:222/
  • Profiler für .NET: https://custom.com:333/
  • Debugger: https://custom.com:444/

Verbindungszeichenfolge mit einer expliziten Region

InstrumentationKey=00000000-0000-0000-0000-000000000000;IngestionEndpoint=https://southcentralus.in.applicationinsights.azure.com/

In diesem Beispiel gibt die Verbindungszeichenfolge die Region „USA, Süden, Mitte“ an:

• Das Autorisierungsschema ist standardmäßig „ikey“.
• Instrumentierungsschlüssel: 00000000-0000-0000-0000-000000000000
• Die regionalen Dienst-URIs basieren auf den expliziten Überschreibungswerten:
  • Erfassung: https://southcentralus.in.applicationinsights.azure.com/

Führen Sie den folgenden Befehl in der Azure CLI aus, um verfügbare Regionen aufzulisten:

az account list-locations -o table

Festlegen einer Verbindungszeichenfolge

Alle unsere OpenTelemetry-Angebote und die folgenden SDK-Versionen unterstützen Verbindungszeichenfolgen:

• .NET v2.12.0
• JavaScript v2.3.0
• NodeJS v1.5.0
• Python v1.0.0
• Java v3.1.1

Sie können eine Verbindungszeichenfolge im Code oder mithilfe einer Umgebungsvariablen oder einer Konfigurationsdatei festlegen.

Umgebungsvariable

Verbindungszeichenfolge: APPLICATIONINSIGHTS_CONNECTION_STRING

Codebeispiele

Nächste Schritte

So überprüfen Sie häufig gestellte Fragen (FAQ):

• Häufig gestellte Fragen zu Verbindungszeichenfolgen in Application Insights

Beginnen mit der Laufzeitmethode mit:

• Azure Virtual Machine (VM) und Azure Virtual Machine Scale Sets von IIS gehosteten Apps
• Internet Information Server (IIS)-Server
• Web-Apps-Funktion von Azure App Service

Beginnen mit der Entwicklungszeitmethode mit:

• ASP.NET Core
• ASP.NET
• Java
• Node.js
• Python