Migrieren von Application Insights-Instrumentierungsschlüsseln zu Verbindungszeichenfolgen

  • Artikel

Dieser Artikel beschreibt die Migration von Instrumentierungsschlüsseln zu Verbindungszeichenfolgen.

Voraussetzungen

Migration

Screenshot that shows Application Insights overview and connection string.

  1. Wechseln Sie zum Bereich Übersicht Ihrer Application Insights-Ressource.

  2. Suchen Sie die Verbindungszeichenfolge, die auf der rechten Seite angezeigt wird.

  3. Zeigen Sie mit der Maus auf die Verbindungszeichenfolge, und wählen Sie das Symbol In Zwischenablage kopieren aus.

  4. Konfigurieren Sie das Application Insights SDK wie unter Festlegen von Verbindungszeichenfolgen beschrieben.

Wichtig

Verwenden Sie nicht sowohl eine Verbindungszeichenfolge wie einen Instrumentierungsschlüssel. Das letztere Set ersetzt das andere und kann dazu führen, dass Telemetriedaten nicht im Portal angezeigt werden. Siehe fehlende Daten.

Migration im großen Stil

Verwenden Sie Umgebungsvariablen, um einfach eine Verbindungszeichenfolge an das Application Insights SDK oder den Agent zu übergeben.

Zum Festlegen einer Verbindungszeichenfolge mithilfe einer Umgebungsvariablen platzieren Sie den Wert der Verbindungszeichenfolge in einer Umgebungsvariablen mit dem Namen APPLICATIONINSIGHTS_CONNECTION_STRING.

Dieser Prozess kann in Ihren Azure-Bereitstellungen automatisiert werden. Die folgende Azure Resource Manager-Vorlage zeigt beispielsweise, wie Sie die richtige Verbindungszeichenfolge automatisch mit einer Azure App Service-Bereitstellung einschließen können. Achten Sie darauf, alle anderen App-Einstellungen einzuschließen, die Ihre App erfordert:

{
    "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
    "contentVersion": "1.0.0.0",
    "parameters": {
        "appServiceName": {
            "type": "string",
            "metadata": {
                "description": "Name of the App Services resource"
            }
        },
        "appServiceLocation": {
            "type": "string",
            "metadata": {
                "description": "Location to deploy the App Services resource"
            }
        },
        "appInsightsName": {
            "type": "string",
            "metadata": {
                "description": "Name of the existing Application Insights resource to use with this App Service. Expected to be in the same Resource Group."
            }
        }
    },
    "resources": [
        {
            "apiVersion": "2016-03-01",
            "name": "[parameters('appServiceName')]",
            "type": "microsoft.web/sites",
            "location": "[parameters('appServiceLocation')]",
            "properties": {
                "siteConfig": {
                    "appSettings": [
                        {
                            "name": "APPLICATIONINSIGHTS_CONNECTION_STRING",
                            "value": "[reference(concat('microsoft.insights/components/', parameters('appInsightsName')), '2015-05-01').ConnectionString]"
                        }
                    ]
                },
                "name": "[parameters('appServiceName')]"
            }
        }
    ]
}

Neue Funktionen

Verbindungszeichenfolgen stellen eine einzelne Konfigurationseinstellung zur Verfügung und beenden die Notwendigkeit mehrerer Proxyeinstellungen.

  • 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.

Unterstützte SDK-Versionen

  • .NET und .NET Core v2.12.0 und höher
  • Java v2.5.1 und Java 3.0 und höher
  • JavaScript v2.3.0 und höher
  • NodeJS v1.5.0 und höher
  • Python v1.0.0 und höher

Problembehandlung

Dieser Abschnitt enthält Hilfe zur Problembehandlung.

Warnung: „Umstellung auf die Verwendung von Verbindungszeichenfolgen für die Datenerfassung“

Führen Sie die Migrationsschritte in diesem Artikel aus, um diese Warnung zu beheben.

Fehlende Daten

  • Vergewissern Sie sich, dass Sie eine unterstützte SDK-Version verwenden. Wenn Sie mit Application Insights-Integration in ein anderes Azure-Produktangebot arbeiten, lesen Sie dessen Dokumentation zur ordnungsgemäßen Konfiguration einer Verbindungszeichenfolge.
  • Vergewissern Sie sich, dass Sie nicht sowohl einen Instrumentierungsschlüssel als auch eine Verbindungszeichenfolge zugleich festlegen. Einstellungen für Instrumentierungsschlüssel sollten aus Ihrer Konfiguration entfernt werden.
  • Vergewissern Sie sich, dass ihre Verbindungszeichenfolge genau wie im Azure-Portal angegeben ist.

Umgebungsvariablen funktionieren nicht.

Wenn Sie einen Instrumentierungsschlüssel im Anwendungscode hart codieren, hat diese Programmierung möglicherweise Vorrang vor Umgebungsvariablen.

Häufig gestellte Fragen

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

Wo finde ich meine Verbindungszeichenfolge sonst noch?

Die Verbindungszeichenfolge ist auch in den Resource Manager-Ressourceneigenschaften für Ihre Application Insights-Ressource enthalten, unter dem Feldnamen ConnectionString.

Wie wirkt sich dies auf die automatische Instrumentierung aus?

Es gibt keinen Einfluss auf Szenarien mit automatischer Instrumentierung.

Kann ich die Microsoft Entra-Authentifizierung mit der automatischen Instrumentierung verwenden?

Sie können die Microsoft Entra-Authentifizierung in Szenarien mit automatischer Instrumentierung nicht aktivieren. Wir planen, diese Einschränkung in Zukunft aufzuheben.

Was ist der Unterschied zwischen der globalen und regionalen Erfassung?

Bei der globalen Erfassung werden alle Telemetriedaten an einen einzelnen Endpunkt gesendet, unabhängig davon, wo diese Daten gespeichert werden. Bei der regionalen Erfassung können Sie bestimmte Endpunkte pro Region für die Datenerfassung definieren. So wird sichergestellt, dass die Daten während der Verarbeitung und Speicherung innerhalb einer bestimmten Region bleiben.

Wie wirken sich Verbindungszeichenfolgen auf die Abrechnung aus?

Die Abrechnung ist nicht betroffen.

Microsoft Q&A

Stellen Sie Fragen im Forum für Antworten.