Azure App Services Nachverfolgung für „.NET “

Um die Instrumentierung für.NET Framework,.NET Core und.NET auf „ Windows “-Varianten von App Services zu aktivieren, muss in der Umgebung, in der Sie die App Services überwachen möchten, ein „ Instana “-Agent ausgeführt werden.

Weitere Informationen zur Konfiguration des „ Instana “-Agenten für die Überwachung von „ Azure “ finden Sie unter „Überwachung und Instrumentierung von Microsoft Azure “.

Führen Sie die folgenden Schritte aus, um „ Windows “-Workloads einzurichten:

1. Suchen Sie im Microsoft Azure nach dem .Net App Service, den Sie instrumentieren möchten.

2. Öffnen Sie den .Net App Service im Azure.

3. Klicken Sie im Navigationsmenü auf Erweiterungen. Auf der Seite Erweiterungen können Sie eine neue Erweiterung hinzufügen, die installierten Erweiterungen überprüfen und eine Erweiterung aktualisieren oder entfernen.

   

4. Installieren Sie die Erweiterung „ Instana “ von Tracing App Service. Nach der Installation müssen Sie die Erweiterung konfigurieren, bevor Sie sie verwenden können.

5. Go zur Seite „Erweiterungen“.

6. Klicken Sie in der Liste der installierten Erweiterungen auf das Symbol „ URL “ für die Erweiterung „ Instana Tracing App Service “. Es wird das Fenster „ Instana -Tracing für AppServices “ angezeigt, in dem Sie die Erweiterung „ Instana “ konfigurieren können.

   

7. Führen Sie die folgenden Konfigurationen durch:

   1. Um die Funktion „ Instana -Tracing“ zu aktivieren, setzen Sie „Enable Tracing“ auf „On “.

   2. Um 32 Bit für Ihre App Services-Anwendung auszuwählen, setzen Sie 64 Bit aktivieren auf Aus. Um 64 Bit für Ihre App Services-Anwendung auszuwählen, setzen Sie 64 Bit aktivieren auf Ein. Weitere Informationen finden Sie unter Bitness der Anwendung.

   3. Geben Sie im Feld „Agent-Schlüssel“ den Lizenzschlüssel Ihres „ Instana “-Host-Agenten ein.

   4. Geben Sie im Feld „Endpunkt- URL “ die Endpunkt- URL für die serverlose Überwachung ein.

      Hinweis: Bei einer selbst gehosteten Lösung geben Sie den Endpunkt im https://<IP address of the Instana backend>/serverless Format ein und setzen Sie den INSTANA_DISABLE_CA_CHECK Parameter auf true oder 1.

   5. Geben Sie in das Feld Log-Level den gewünschten Log-Level ein. Die Werte, die Sie eingeben können, sind " NONE, " DEBUG, " INFO, " WARN und " ERROR.

      Die Protokollinformationen werden im Stammordner der App Service erstellt.

8. Nachdem Sie alle Informationen eingegeben haben, klicken Sie auf Update Config. Die Informationen werden im Rahmen des App Service gespeichert.

9. Starten Sie im Dashboard des App Service den App Service neu. Wenn Sie Ihre Anwendung ausführen, wird ein „ Instana “-Rewriter an die Anwendung angehängt, und „ Instana “ beginnt mit der Erfassung von Traces.

Um die Traces in der Benutzeroberfläche von „ Instana “ anzuzeigen, führen Sie die folgenden Schritte aus:

1. Öffnen Sie in der Benutzeroberfläche von „ Instana “ das Dashboard Ihrer Entität „ App Service “.

2. Klicken Sie auf Upstream / Downstream. Traces, die für diese Entität gesammelt werden, werden angezeigt.

   

Um die Instrumentierung für.NET Core- und.NET-Anwendungen zu aktivieren, die auf App Services auf Basis von „ Linux “ ausgeführt werden, muss in der Umgebung, in der Sie die „ App Service “ überwachen möchten, ein „ Instana “-Agent ausgeführt werden. Weitere Informationen zur Konfiguration des „ Instana “-Agenten für die Überwachung von Azure finden Sie unter „Überwachung und Instrumentierung von Microsoft Azure “.

Führen Sie die folgenden Schritte aus, um Spuren zu erfassen:

1. Fügen Sie das Tracing- NuGet -Paket zu Ihrem Projekt hinzu: Instana.Tracing.Core.Rewriter.Linux

2. Nachdem Sie das NuGet für die Ablaufverfolgung hinzugefügt haben, stellen Sie Ihre Anwendung erneut auf dem Azure App Service bereit.

3. Nach der erneuten Bereitstellung der Anwendung wird die „ Instana “-Ablaufverfolgung Teil Ihrer Anwendung. Um die Ablaufverfolgung zu aktivieren, konfigurieren Sie die CLR-Engine wie folgt:

   1. Go zum Abschnitt „Konfiguration“ in Ihrem Dashboard unter AzureApp Service.

   2. Fügen Sie die folgenden Umgebungsvariablen hinzu:

      CORECLR_ENABLE_PROFILING = 1
      CORECLR_PROFILER = {cf0d821e-299b-5307-a3d8-b283c03916dd}
      CORECLR_PROFILER_PATH = /home/site/wwwroot/instana_tracing/CoreProfiler.so
      DOTNET_STARTUP_HOOKS = /home/site/wwwroot/Instana.Tracing.Core.dll
      INSTANA_AGENT_KEY = the license key of your Instana host agent
      INSTANA_ENDPOINT_URL = one of the following [endpoint URL for serverless monitoring](../../../setup_and_manage/endpoints_and_keys.html#endpoints-for-serverless-monitoring)
      

4. Starten Sie Ihre Anwendung neu. Gehen Sie folgendermaßen vor, um sicherzustellen, dass Ihre Änderungen aktiv sind:

   1. Stoppen Sie die Anwendung.
   2. Warten Sie 1-2 Minuten, um alle zwischengespeicherten Zustände zu löschen.
   3. Starten Sie die Anwendung erneut.

   Sie können nun Traces in der Benutzeroberfläche von „ Instana “ anzeigen.

Wenn Sie die Instrumentierung von „ Instana “ mithilfe der installierten Erweiterung unter Azure konfigurieren, wird das Kontrollkästchen „64-Bit aktivieren“ angezeigt. Je nach Bit-Version Ihrer Anwendung müssen Sie den entsprechenden Rewriter anhängen.

Wenn Sie die Anwendung über Visual Studio für Azure App Service bereitstellen, wird die Anwendung standardmäßig im 32-Bit-Modus installiert. Die Bitversionseinstellungen können in der Konfiguration des App Service unter Konfiguration > Allgemeine Einstellungen geändert werden:

Wenn Sie den 64-Bit-Modus verwenden, wählen Sie in der Konfiguration der Erweiterung „ Instana -Tracing- App Service “ die Option „64 Bit“ aus. Andernfalls können Sie keine Spuren anbringen und sammeln.

Wenn die Verfolgung nicht funktioniert, führen Sie die folgenden Schritte aus:

1. Überprüfen Sie, ob die Bit-Version sowohl in der Konfiguration von „ App Service “ als auch in der Konfiguration der Erweiterung „ Instana Tracing App Service “ korrekt konfiguriert ist.

2. Stellen Sie sicher, dass der Agentenschlüssel und der Endpunkt URL auf der Seite „ Instana -Tracing für App Services“ korrekt eingestellt sind. Weitere Informationen finden Sie unter „Endpunkt- URL “ für die serverlose Überwachung.

3. Suchen Sie im Ereignisprotokoll nach Fehlern, indem Sie auf Diagnose und Problemlösung > Anwendungsereignisprotokolle klicken.

   

4. Öffnen Sie den Kudu Process Explorer, indem Sie im Navigationsmenü auf Advanced Tools klicken. Prüfen Sie, ob der Prozess " w3wp mit dem Modul Instana.Profiler_x64.dll verbunden ist.

   

   

5. Rufen Sie die Debugging-Protokolle für „ Instana “ über das Kudu-Tool ab. Gehen Sie im Kudu-Tool zur Debug-Konsole und dann zum Ordner " C:\home\site\wwwroot>. In diesem Ordner finden Sie zwei Arten von Protokolldateien:

• CLR-Debug-Protokolle: 1.log_YYYY-MM-DD-HH_MM_SS
• Instrumentierungsprotokolle: YYYY-MM-DD_HH_MM_SSPID