Verbindungszeichenfolgen in Application Insights

Artikel
10/31/2024

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.

Wichtig

Die Verbindungszeichenfolge enthält einen ikey, einen eindeutigen Bezeichner, der vom Erfassungsdienst verwendet wird, um Telemetriedaten einer bestimmten Application Insights-Ressource zuzuordnen. eindeutige IKey-IDs sind keine Sicherheitstoken oder Sicherheitsschlüssel und gelten nicht als geheime Schlüssel.

Wenn Sie Ihre Application Insights-Ressource vor Missbrauch schützen möchten, bietet der Erfassungsendpunkt authentifizierte Telemetrieerfassungsoptionen basierend auf Microsoft Entra ID.

Hinweis

Am 31. März 2025 wird der Support für die auf Instrumentierungsschlüsseln basierende Erfassung eingestellt. Die Erfassung von Instrumentierungsschlüsseln funktioniert zwar weiterhin, wir stellen jedoch keine Updates und keinen Support mehr für das Feature bereit. Wechseln Sie zu Verbindungszeichenfolgen, damit Sie neue Funktionen nutzen können.

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

Tipp

Konfigurierbare Schlüsselwertpaare werden in diesem Dokument behandelt. Einige Schlüsselwertpaare sind nicht konfigurierbar und werden automatisch festgelegt, z. B. ApplicationId. Diese können sicher ignoriert werden, wenn sie in Ihrer Umgebung entdeckt werden.

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

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

Sprache	Classic API	OpenTelemetry
ASP.NET Core	Application Insights SDK	AzMon OTel Distro
.NET Framework	Application Insights SDK	AzMon Exporter
Java	N/V	Java-Agent
JavaScript	JavaScript (Web) SDK Loader-Skript	N/V
Node.js	Application Insights SDK	AzMon OTel Distro
Python	OpenCensus Python SDK	AzMon OTel Distro

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:

Beginnen mit der Entwicklungszeitmethode mit:

Freigeben über