Auf Englisch lesen

Freigeben über

Upgrade von alten Versionen des Application Insights JavaScript SDK

  • Artikel

Das Upgrade auf die neue Version des Application Insights JavaScript SDK kann mehrere Vorteile bieten, z. B.:

  • Verbesserte Leistung und Fehlerkorrekturen
  • Neue Funktionen und Merkmale
  • Bessere Kompatibilität mit anderen Technologien
  • Verbesserte Sicherheit und Datenschutz

Einschneidende Änderungen in der SDK V2-Version.

  • Um bessere API-Signaturen zu ermöglichen, wurden einige der API-Aufrufe wie trackPageView und trackException aktualisiert. Die Ausführung in Internet Explorer 8 und früheren Versionen des Browsers wird nicht unterstützt.

  • Der Telemetrieumschlag hat Feldnamen und Strukturänderungen aufgrund von Datenschemaaktualisierungen.

  • context.operation in context.telemetryTraceverschoben. Einige Felder wurden ebenfalls geändert (operation.id -->telemetryTrace.traceID).

    Um die aktuelle Seitenansichts-ID manuell zu aktualisieren, z. B. in Einzelseitenanwendungen, verwenden Sie appInsights.properties.context.telemetryTrace.traceID = Microsoft.ApplicationInsights.Telemetry.Util.generateW3CId().

    Hinweis

    Um die Ablaufverfolgungs-ID eindeutig zu halten, verwenden Sie jetzt Util.generateW3CId(), wo Sie zuvor Util.newId()verwendet haben. Letztendlich werden beide zur Operations-ID.

Wenn Sie das aktuelle Application Insights PRODUCTION SDK (1.0.20) verwenden und prüfen möchten, ob das neue SDK zur Laufzeit funktioniert, aktualisieren Sie die URL je nach aktuellem SDK-Ladeszenario.

  • Download über CDN-Szenario: Aktualisieren Sie das JavaScript (Web)-SDK-Ladeprogrammskript, das Sie derzeit verwenden, um auf die folgende URL zu verweisen:

    "https://js.monitor.azure.com/scripts/b/ai.3.gbl.min.js"

  • npm-Szenario: Rufen Sie downloadAndSetup auf, um das vollständige ApplicationInsights-Skript aus CDN herunterzuladen und mit einer Verbindungszeichenfolge zu initialisieren:

    ts 
    appInsights.downloadAndSetup({
   connectionString: "Copy connection string from Application Insights Resource Overview",
   url: "https://js.monitor.azure.com/scripts/b/ai.3.gbl.min.js"
   });

Testen Sie in einer internen Umgebung, um zu überprüfen, ob die Überwachungstelemetrie wie erwartet funktioniert. Wenn alles funktioniert, aktualisieren Sie Ihre API-Signaturen entsprechend auf SDK v2, und stellen Sie sie in Ihren Produktionsumgebungen bereit.

Nächste Schritte