Verbindungszeichenfolgen
Dieser Artikel zeigt, wie Verbindungszeichenfolgen verwendet werden.
Übersicht
Hinweis
Die folgende Dokumentation basiert auf der klassischen Application Insights-API. Der langfristige Plan für Application Insights besteht darin, Daten mithilfe von OpenTelemetry zu sammeln. Weitere Informationen finden Sie unter Aktivieren von Azure Monitor OpenTelemetry für .NET-, Node.js-, Python- und Java-Anwendungen.
Verbindungszeichenfolgen definieren, wohin Telemetriedaten gesendet werden sollen.
Schlüssel-Wert-Paare bieten Benutzern eine einfache Möglichkeit, eine Präfix-Suffix-Kombination für jeden Application Insights-Dienst oder jedes Produkt zu definieren.
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.
Übersicht über das Szenario
Szenarien, die von dieser Änderung am stärksten betroffen sind:
Firewall-Ausnahmen oder Proxy-Umleitungen:
In Fällen, in denen eine Überwachung für Intranet-Webserver erforderlich ist, forderte unsere frühere Lösung Sie auf, Ihrer Konfiguration einzelne Dienstendpunkte hinzuzufügen. Weitere Informationen finden Sie unter Kann ich einen Intranetwebserver überwachen?. Verbindungszeichenfolgen stellen eine bessere Alternative dar, da der gesamte Aufwand auf eine einzige Einstellung reduziert wird. Eine einfache Präfix- und Suffix-Änderung ermöglicht die automatische Bestückung und Umleitung aller Endpunkte zu den richtigen Diensten.
Sovereign Cloud- oder Hybrid Cloud-Umgebungen:
Benutzer können Daten an eine definierte Azure Government-Region senden. Durch die Verwendung von Verbindungszeichenfolgen können Sie Endpunkteinstellungen für Ihre Intranetserver oder Hybrid Cloud-Einstellungen definieren.
Erste Schritte
Lesen Sie die folgenden Abschnitte, um zu beginnen.
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
Ist die Verbindungszeichenfolge ein Geheimnis?
Die Verbindungszeichenfolge enthält einen ikey, einen eindeutigen Bezeichner, der vom Erfassungsdienst verwendet wird, um Telemetriedaten einer bestimmten Application Insights-Ressource zuzuordnen. Diese eindeutigen iKey-Bezeichner sind keine Sicherheitstoken oder Sicherheitsschlüssel. Wenn Sie Ihre KI-Ressource vor Missbrauch schützen möchten, bietet der Erfassungsendpunkt authentifizierte Telemetrieerfassungsoptionen basierend auf Microsoft Entra ID.
Hinweis
Das Application Insights JavaScript SDK erfordert, dass die Verbindungszeichenfolge während der Initialisierung und Konfiguration übergeben wird. Es kann in Client-Browsern im Klartext angezeigt werden. Es gibt keine einfache Möglichkeit, die Microsoft Entra ID-basierte Authentifizierung für Browsertelemetrie zu verwenden. Wir empfehlen Ihnen, eine separate Application Insights-Ressource für Browsertelemetrie zu erstellen, wenn Sie die Diensttelemetrie sichern müssen.
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 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
- Erfassung:
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/
- Erfassung:
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/
- Erfassung:
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
Verbindungszeichenfolgen werden in den folgenden SDK-Versionen unterstützt:
- .NET v2.12.0
- Java v2.5.1 und Java 3.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
Legen Sie die Verbindungszeichenfolge in der
appsettings.json
-Datei fest:{ "ApplicationInsights": { "ConnectionString" : "InstrumentationKey=00000000-0000-0000-0000-000000000000;IngestionEndpoint=https://{region}.in.applicationinsights.azure.com/;LiveEndpoint=https://{region}.livediagnostics.monitor.azure.com/" } }
Rufen Sie die Verbindungszeichenfolge in
Program.cs
ab, wenn Sie denApplicationInsightsTelemetry
-Dienst registrieren:var options = new ApplicationInsightsServiceOptions { ConnectionString = app.Configuration["ApplicationInsights:ConnectionString"] }; builder.Services.AddApplicationInsightsTelemetry(options: options);
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 VM und Azure Virtual Machine Scale Sets von IIS gehosteten Apps
- IIS-Server
- Web-Apps-Funktion von Azure App Service
Beginnen mit der Entwicklungszeitmethode mit: