Einrichten der „.NET “-Tracing-Funktion für Container-Apps auf Azure

Online bearbeiten

Sie können die Ablaufverfolgung für „.NET Core “-Anwendungen aktivieren, die auf „ Azure Container Apps“ ausgeführt werden, indem Sie das „ Instana “-Tracing-SDK in Ihrer Anwendung konfigurieren und es mithilfe des „ Instana “-Serverless-Agenten mit „ Instana “ verbinden.

Einen Überblick darüber, wie „ Instana “ „.NET “-Anwendungen überwacht, finden Sie unter „So funktioniert die Überwachung von „.NET “.

Vorbereitende Schritte

Online bearbeiten

Bevor Sie die Ablaufverfolgung für eine „.NET Core “-Anwendung in „ Azure Container Apps“ aktivieren, stellen Sie sicher, dass die folgenden Voraussetzungen erfüllt sind:

  • Sie verfügen über ein aktives „ Instana “-Konto mit Zugriff auf die Benutzeroberfläche von „ Instana “.
  • Sie verfügen über ein „ Azure “-Abonnement, das die Nutzung von „ Azure Container Apps“ umfasst.
  • Lesen Sie die Support-Informationen durch, um sicherzustellen, dass die Kompatibilität mit Ihrer Version von „.NET “ und Ihrer Laufzeitumgebung gegeben ist.

.NET -Tracing aktivieren

Online bearbeiten

Um die Ablaufverfolgung in Ihrer auf Azure Container App Service gehosteten „.NET Core “-Anwendung zu aktivieren, führen Sie die folgenden Schritte aus:

Schritt 2: Aktualisieren Sie die Dockerfile-Datei

Online bearbeiten

Legen Sie in Ihrer Dockerfile-Datei die Umgebungsvariablen für die Ablaufverfolgungs.NET Core :

# set .NET Core tracing environment variables
ENV CORECLR_ENABLE_PROFILING="1"
ENV CORECLR_PROFILER="{cf0d821e-299b-5307-a3d8-b283c03916dd}"
ENV CORECLR_PROFILER_PATH="/app/instana_tracing/CoreProfiler.so"
ENV DOTNET_STARTUP_HOOKS="/app/Instana.Tracing.Core.dll"

Schritt 3: Erstellen und Bereitstellen einer „ Azure “-Container-App

Online bearbeiten
  1. Go zum Portal „ Azure “.
  2. Suchen Sie nach „Container-Apps“ und wählen Sie „Container-Apps“ aus.
  3. Erstellen Sie eine Ressourcengruppe, falls noch keine vorhanden ist:
    1. Klicken Sie auf der Seite „Container-Apps “ auf „Erstellen “.
    2. Wählen Sie „Ressourcengruppe“ aus und klicken Sie auf „Neu erstellen “.
    3. myResourceGroupGeben Sie einen Namen ein (zum Beispiel ), wählen Sie eine Region aus und klicken Sie dann auf „OK “.
  4. Eine Container-Apps-Umgebung erstellen:
    1. Wählen Sie auf der Registerkarte „Grundlagen“ die Option „Abonnement“ und die zuvor erstellte Ressourcengruppe aus.
    2. myDotnetAppGeben Sie einen Namen für die Container-App ein (zum Beispiel ).
    3. Wählen Sie die Region aus und klicken Sie dann auf „Weiter: Umgebung “.
    4. myContainerAppEnvKlicken Sie unter „Umgebung “ auf „Neu erstellen“ und geben Sie einen Umgebungsnamen ein (zum Beispiel ).
    5. Wählen Sie eine Region und einen Log Analytics-Arbeitsbereich aus.
    6. Klicken Sie auf „Überprüfen + Erstellen “ und anschließend auf „Erstellen “.
  5. Eine „.NET Core “-Anwendung bereitstellen:
    1. Rufen Sie im Portal „ Azure “ die Seite AzureContainer Registry (ACR) auf und erstellen Sie ein neues Register, falls noch keines vorhanden ist.
    2. mycontainerregistry.azurecr.io/my-dotnet-app:v1Übertragen Sie Ihr „ Docker “-Image in ACR (zum Beispiel ). Stellen Sie sicher, dass Ihre „.NET Core “-Anwendung containerisiert ist, indem Sie Docker verwenden.
    3. Klicken Sie unter „ Azure -Container-Apps “ auf „Container-App erstellen “.
    4. Wählen Sie die erstellte Ressourcengruppe und die Container-App-Umgebung aus.
    5. Wählen Sie unter „Container-Einstellungen“ die Option „ Docker -Hub“ oder „ Azure “ aus Container Registry und geben Sie den Namen des Images an.
    6. 80Stellen Sie den Container-Port ein (zum Beispiel ).
    7. Aktivieren Sie „Ingress“ und wählen Sie „Externer Zugriff “.
    8. Klicken Sie auf „Überprüfen + Erstellen “ und anschließend auf „Erstellen “.

Schritt 4: Konfigurieren Sie die Einstellungen des Serverless-Agenten für „ Instana “

Online bearbeiten
  1. Melden Sie sich bei Ihrem „ Instana “-Konto an (zum Beispiel: https://sesandbox-instana.instana.io).
  2. Rufen Sie den Endpunkt „ Instana “ unter URL sowie den Agentenschlüssel unter Instana ab:
    1. Wählen Sie im Navigationsmenü der Benutzeroberfläche von „ Instana “ die Option „Mehr“ > „Agenten“ > „Agenten installieren “.
    2. Wählen Sie „ Azure -Container-Apps“ aus.
    3. Kopieren Sie den Endpunkt „ Instana “ sowie den „ URL “ und den „Agent Key “.
  3. Umgebungsvariablen im Portal „ Azure “ festlegen:
    1. Go zu „ Azure “ (Container-Apps) im „ Azure “-Portal.
    2. Wählen Sie Ihre Container-App aus.
    3. Klicken Sie auf „Einstellungen “ > „Umgebungsvariablen “.
    4. Fügen Sie die folgenden Umgebungsvariablen hinzu:
      CORECLR_ENABLE_PROFILING = 1
CORECLR_PROFILER = {cf0d821e-299b-5307-a3d8-b283c03916dd}
CORECLR_PROFILER_PATH = /app/instana_tracing/CoreProfiler.so
DOTNET_STARTUP_HOOKS = /app/Instana.Tracing.Core.dll
INSTANA_ENDPOINT_URL = instana_endpoint_url
AZURE_SUBSCRIPTION_ID = your_azure_subscription_id
AZURE_RESOURCE_GROUP = your_azure_resource_group
INSTANA_SERVICE_NAME = your_service_name
INSTANA_AGENT_KEY = your_instana_agent_key
      Hinweis: INSTANA_SERVICE_NAME ist der Name des Dienstes, den Sie überwachen möchten, zum Beispiel dotnetcore-webapp.
    5. Speichern Sie die Änderungen.

Schritt 5: Überprüfen Sie die Einrichtung

Online bearbeiten

Gehen Sie im Navigationsmenü der Benutzeroberfläche von „ Instana “ zu „Anwendungen > Dienste“, um die erfassten Metriken und Traces anzuzeigen.