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.

Suchen der 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: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: 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: 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

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

Umgebungsvariable

Verbindungszeichenfolge: APPLICATIONINSIGHTS_CONNECTION_STRING

Codebeispiele

Häufig gestellte Fragen

Dieser Abschnitt enthält Antworten auf häufig gestellte Fragen.

Erfordern neue Azure-Regionen die Verwendung von Verbindungszeichenfolgen?

Neue Azure-Regionen erfordern die Verwendung von Verbindungszeichenfolgen anstelle von Instrumentierungsschlüsseln. Eine Verbindungszeichenfolge identifiziert die Ressource, die Sie Ihren Telemetriedaten zuordnen möchten. Hier können Sie die Endpunkte ändern, die Ihre Ressource als Ziel für die Telemetrie verwendet. Kopieren Sie die Verbindungszeichenfolge, und fügen Sie sie dem Code Ihrer Anwendung oder einer Umgebungsvariable hinzu.

Sollte ich Verbindungszeichenfolgen oder Instrumentierungsschlüssel verwenden?

Es wird empfohlen, Verbindungszeichenfolgen anstelle von Instrumentierungsschlüsseln zu verwenden.

Nächste Schritte

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