Verbindungszeichenfolgen

Dieser Artikel zeigt, wie Verbindungszeichenfolgen verwendet werden.

Übersicht

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

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

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

.NET 5.0+

1. 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/"
       }
   }
   

2. Rufen Sie die Verbindungszeichenfolge in Program.cs ab, wenn Sie den ApplicationInsightsTelemetry-Dienst registrieren:

   var options = new ApplicationInsightsServiceOptions { ConnectionString = app.Configuration["ApplicationInsights:ConnectionString"] };
   builder.Services.AddApplicationInsightsTelemetry(options: options);
   

.NET Framework

Legen Sie die Eigenschaft TelemetryConfiguration.ConnectionString oder ApplicationInsightsServiceOptions.ConnectionString fest.

So legen Sie die Verbindungszeichenfolge explizit im Code fest:

var configuration = new TelemetryConfiguration
{
    ConnectionString = "InstrumentationKey=00000000-0000-0000-0000-000000000000;IngestionEndpoint=https://{region}.in.applicationinsights.azure.com/;LiveEndpoint=https://{region}.livediagnostics.monitor.azure.com/"
};

Festlegen der Verbindungszeichenfolge mithilfe einer Konfigurationsdatei:

<?xml version="1.0" encoding="utf-8"?>
<ApplicationInsights xmlns="http://schemas.microsoft.com/ApplicationInsights/2013/Settings">
    <ConnectionString>InstrumentationKey=00000000-0000-0000-0000-000000000000;IngestionEndpoint=https://{region}.in.applicationinsights.azure.com/;LiveEndpoint=https://{region}.livediagnostics.monitor.azure.com/</ConnectionString>
</ApplicationInsights>

Java

Sie können die Verbindungszeichenfolge in der Konfigurationsdatei applicationinsights.json festlegen:

{
  "connectionString": "InstrumentationKey=00000000-0000-0000-0000-000000000000;IngestionEndpoint=https://{region}.in.applicationinsights.azure.com/;LiveEndpoint=https://{region}.livediagnostics.monitor.azure.com/"
}

Weitere Informationen finden Sie unter Konfiguration der Verbindungszeichenfolge.

JavaScript

JavaScript unterstützt die Verwendung von Umgebungsvariablen nicht. Sie haben zwei Möglichkeiten:

• Weitere Informationen zur Verwendung des JavaScript (Web) SDK Loader-Skript finden Sie unter JavaScript (Web) SDK Loader-Skript.
• Manuelle Einrichtung:

  import { ApplicationInsights } from '@microsoft/applicationinsights-web'
  
  const appInsights = new ApplicationInsights({ config: {
     connectionString: 'InstrumentationKey=00000000-0000-0000-0000-000000000000;'
     /* ...Other Configuration Options... */
  } });
  appInsights.loadAppInsights();
  appInsights.trackPageView();
  

Node.js

const appInsights = require("applicationinsights");
appInsights.setup("InstrumentationKey=00000000-0000-0000-0000-000000000000;IngestionEndpoint=https://{region}.in.applicationinsights.azure.com/;LiveEndpoint=https://{region}.livediagnostics.monitor.azure.com/");
appInsights.start();

Python

Wir empfehlen, dass Benutzer die Umgebungsvariable festlegen.

So legen Sie die Verbindungszeichenfolge explizit fest

from opencensus.ext.azure.trace_exporter import AzureExporter
from opencensus.trace.samplers import ProbabilitySampler
from opencensus.trace.tracer import Tracer

tracer = Tracer(exporter=AzureExporter(connection_string='InstrumentationKey=00000000-0000-0000-0000-000000000000;IngestionEndpoint=https://{region}.in.applicationinsights.azure.com/;LiveEndpoint=https://{region}.livediagnostics.monitor.azure.com/'), sampler=ProbabilitySampler(1.0))

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:

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