Migrieren von Application Insights-Instrumentierungsschlüsseln zu Verbindungszeichenfolgen

2024-10-10

Application Insights wechselt von globalen Aufnahmeendpunkten zu regionalen Endpunkten, die Verbindungszeichenfolgen verwenden, die zusätzliche Funktionen bieten.

Szenarien, die von dieser Änderung am stärksten betroffen sind:

Firewall-Ausnahmen oder Proxyumleitungen – In Fällen, in denen die Überwachung eines Intranet-Webservers erforderlich ist, haben wir Sie in unserer früheren Lösung aufgefordert, 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 Änderung von Präfixen und Suffixen ermöglicht die automatische Konfiguration und Umleitung aller Endpunkte zu den korrekten Diensten.
Souveräne oder hybride Cloudumgebungen – 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.

In diesem Artikel wird die Migration von Instrumentierungsschlüsseln zu Verbindungszeichenfolgen erläutert.

Voraussetzungen

Eine unterstützte SDK-Version
Eine vorhandene Application Insights-Ressource

Migration

Wechseln Sie zum Bereich Übersicht Ihrer Application Insights-Ressource.
Suchen Sie die Verbindungszeichenfolge, die rechts angezeigt wird.
Zeigen Sie mit der Maus auf die Verbindungszeichenfolge, und wählen Sie das Symbol In Zwischenablage kopieren aus.
Konfigurieren Sie das Application Insights SDK, indem Sie Verbindungszeichenfolgen festlegen befolgen.

Von Bedeutung

Verwenden Sie nicht sowohl eine Verbindungszeichenfolge als auch einen Instrumentierungsschlüssel. Der zweite Satz überschreibt den anderen Satz und könnte dazu führen, dass die Telemetrie nicht im Portal angezeigt wird. Siehe fehlende Daten.

Migration im großen Maßstab

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

Um eine Verbindungszeichenfolge über eine Umgebungsvariable festzulegen, platzieren Sie den Wert der Verbindungszeichenfolge in eine Umgebungsvariable namens APPLICATIONINSIGHTS_CONNECTION_STRING.

Dieser Prozess kann in Ihren Azure-Bereitstellungen automatisiert werden. Die folgende Azure Resource Manager-Vorlage zeigt beispielsweise, wie Sie automatisch die richtige Verbindungszeichenfolge in eine 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')]"
            }
        }
    ]
}

Unterstützte SDK-Versionen

.NET und .NET Core v2.12.0+
Java v2.5.1 und Java 3.0+
JavaScript v2.3.0+
NodeJS v1.5.0+
Python v1.0.0+

Problembehandlung

Dieser Abschnitt enthält Lösungen zur Problembehandlung.

Warnung: "Übergang zur Verwendung von Verbindungszeichenfolgen für die Datenaufnahme"

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

Fehlende Daten

Bestätigen Sie, dass Sie eine unterstützte SDK-Version verwenden. Wenn Sie die Integration von Application Insights in ein anderes Azure-Produktangebot verwenden, lesen Sie die Dokumentation zum ordnungsgemäßen Konfigurieren einer Verbindungszeichenfolge.
Vergewissern Sie sich, dass Sie nicht gleichzeitig einen Instrumentierungsschlüssel und eine Verbindungszeichenfolge festlegen. Die Einstellungen für den 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 in Ihrem Anwendungscode hartcodieren, hat diese Programmierung möglicherweise Vorrang vor Umgebungsvariablen.

Häufig gestellte Fragen

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

Wo kann ich sonst meine Verbindungszeichenfolge finden?

Die Verbindungszeichenfolge ist auch in den Ressourcen-Manager-Ressourceneigenschaften für Ihre Application Insights-Ressource unter dem Feldnamen ConnectionStringenthalten.

Wie wirkt sich dies auf die Automatische Instrumentierung aus?

Autoinstrumentationsszenarien sind nicht betroffen.

Kann ich die Microsoft Entra-Authentifizierung mit automatischer Instrumentierung verwenden?

Sie können die Microsoft Entra-Authentifizierung für Autoinstrumentationsszenarien nicht aktivieren. Wir haben pläne, diese Einschränkung in Zukunft zu beheben.

Was ist der Unterschied zwischen globaler und regionaler Aufnahme?

Die globale Erfassung sendet alle Telemetriedaten an einen einzelnen Endpunkt, unabhängig davon, wo diese Daten gespeichert werden. Mit der regionalen Erfassung können Sie bestimmte Endpunkte pro Region für die Datenaufnahme definieren. Diese Funktion stellt sicher, dass Daten während der Verarbeitung und Speicherung innerhalb einer bestimmten Region verbleiben.

Wie wirken sich Verbindungsparameter auf die Abrechnung aus?

Die Abrechnung ist nicht betroffen.

Microsoft Q&A (Fragen und Antworten)

Stellen Sie Fragen im Antwortforum.

Freigeben über