Fehlerbehebung bei der „.NET Framework “-Protokollierung unter IIS

Symptome: Die Anwendung zeigt Metriken an, aber keine Traces; einige Dienste melden Daten, andere hingegen nicht, oder die Tracing-Funktion wird nach einer Bereitstellung oder einem Update nicht mehr ausgeführt.

Fehlerbehebungsschritte:

1. Vergewissern Sie sich, dass die „.NET Framework “-Version der Anwendung unterstützt wird:

   • .NET Framework 4.5.2 oder später
2. Überprüfen Sie, ob die Ablaufverfolgung in der configuration.yaml Agent-Datei aktiviert ist.

3. Erfassen Sie Trace-Protokolle mit einer der folgenden Methoden:

   • Protokollerfassungsfunktion
   • Manuelle Protokollsammlung.

4. Überprüfen Sie die Trace-Protokolle unter Instana und werten Sie die Ergebnisse aus:

   • Wenn die Protokolle leer sind oder keine Spuren sichtbar sind, erzeugt die Anwendung keine Spans.
   • Wenn in den Protokollen zwar Einträge vorhanden sind, aber Informationen fehlen (z. B. der Host), liegt das Problem bei der „.NET “-Tracing-Ebene.
   • Wenn in den Protokollen Einträge vorhanden sind, die Informationen enthalten, die in der Benutzeroberfläche fehlen, ist das Problem entweder im Backend von „ Instana “ oder im Agenten aufgetreten.

Symptom: Die Anwendung stürzt beim Start ab, wenn der „ Instana “-Agent ausgeführt wird.

Fehlerbehebungsschritte:

1. Vergewissern Sie sich, dass die „.NET Framework “-Version der Anwendung unterstützt wird:

   • .NET Framework 4.5.2 oder später

2. Erfassen Sie die Protokolle der Ereignisanzeige mit einer der folgenden Methoden:

   • Protokollerfassungsfunktion
   • Manuelle Protokollsammlung.

3. Überprüfen Sie die Einträge im Ereignisprotokoll, die mit „ Instana “ in Zusammenhang stehen:

   • Achten Sie auf Fehler oder Warnungen, die mit „ Instana “ zusammenhängen.
   • Die Protokolleinträge enthalten Zeitstempel und Fehlercodes, die bei der Fehlerbehebung helfen können.
   • InstanaPCP.exeWenn in einer Fehlermeldung auf verwiesen wird, bedeutet dies, dass der Prozess „ InstanaPCP “ abgestürzt ist. Gehen Sie die vorangegangenen Ereignisse durch und gehen Sie der Sache weiter auf den Grund.
4. Erstellen Sie einen Absturzbericht für die Anwendung.

Symptom: Die Anwendung „.NET Framework “ wird vom „ Instana “-Agenten nicht überwacht und ist in der Benutzeroberfläche von „ Instana “ nicht vorhanden.

Fehlerbehebungsschritte:

1. Stellen Sie sicher, dass der „ Instana “-Agent als Administrator ausgeführt wird.
2. Stellen Sie sicher, dass der „ Instana “-Agent über die erforderlichen Berechtigungen für die Anwendung verfügt.

3. Überprüfen Sie, ob der PCP von „ Instana “ ausgeführt wird:

   • Öffnen Sie den Task-Manager unter Windows und suchen Sie nach InstanaPCP.
   • Erfassen Sie die Protokolle der „ Instana “-Agenten mithilfe des Log Collectors oder durch manuelle Protokollerfassung.

   • In den Protokoll-Dateien des „ Instana “-Agenten muss folgende Zeile enthalten sein:

     com.instana.agent-process-handling - <version> |  | InstanaPCP.exe passed early window; marked RUNNING

4. Überprüfen Sie in den Agent-Protokollen, ob die Sensoren erfolgreich aktiviert wurden:

   com.instana.sensor-clr - <version> |  | Activated Sensor

5. Stellen Sie sicher, dass der Prozess „.NET Framework “ nach dem „ Instana “-Agenten gestartet wird.

Symptom: „ InstanaPCP “ oder die Anwendung „.NET Framework “ weisen nach Aktivierung der Ablaufverfolgung eine ungewöhnlich hohe CPU-Auslastung auf.

Fehlerbehebungsschritte:

1. Überprüfen Sie im Task-Manager, ob das Problem mit der Anwendung oder mit „ InstanaPCP “ zusammenhängt.

2. Falls das Problem bei InstanaPCP: liegt

   • Debug-Protokolle für „ InstanaPCP “ aktivieren. Siehe „Protokolle sammeln “.
   • Überprüfen Sie die Protokolle auf wiederkehrende Meldungen über fehlende Leistungsindikatoren oder Ausnahmen.

3. Falls es sich um einen Speicheranstieg in der Anwendung handelt:

   • Erfassen Sie Ereignisprotokolle und Protokolle von „.NET “ mithilfe des Protokoll-Collectors oder durch manuelle Protokollsammlung.
   • Überprüfen Sie die Ereignisprotokolle und die Protokolle von „.NET “ auf speicherbezogene Ausnahmen.
   • Überprüfen Sie, ob das Problem durch die Instrumentierung von „ Instana “ verursacht wird.
   • Erstellen Sie eine „.NET “-Dump-Datei zur weiteren Analyse.

Log Collector ist eine eigenständige Anwendung zum Erfassen von Protokollen aus „ Instana “. Sie können den Log Collector an folgenden Stellen starten:

• Instana Benutzeroberfläche
• Konsole

Der Log Collector erfasst die folgenden Protokolle:

• Anwendungsprotokolle
• Instana PCP-Protokolle
• CLR-Debug-Protokolle
• Protokolle der Ereignisanzeige
• Instana Agent-Debug-Protokolle
• Instana Agent protokolliert

Alternativ können Sie die Protokolle für auf IIS gehostete „.NET Framework “-Anwendungen manuell erfassen. Führen Sie die folgenden Schritte aus:

1. Aktivieren Sie die Debugprotokolle:

   1. Fügen Sie Umgebungsvariablen mithilfe einer der folgenden Optionen hinzu:

      Hinweis: Stellen Sie sicher, dass die Pfade gültig, für den Prozess oder die Anwendung zugänglich und korrekt sind.

      • Legen Sie die folgenden Umgebungsvariablen manuell auf Systemebene oder in der IIS-Anwendung fest:

        INSTANA_NET_LOG_PATH: "C:\dc_net_log"
        INSTANA_NET_LOG_LEVEL: DEBUG
        INSTANA_NET_FF_LOG_LEVEL: DEBUG
        INSTANA_NET_PCP_LOG_LEVEL: DEBUG
        INSTANA_TRACER_ENTEREXIT_LOGGING: 1
        INSTANA_EXTENDED_DEBUG: 1

        Hinweis: Stellen Sie sicher, dass der in INSTANA_NET_LOG_PATH angegebene Ordner bereits vorhanden ist.

      • Öffnen Sie die Eingabeaufforderung als Administrator und führen Sie den folgenden Befehl aus, um die Umgebungsvariablen hinzuzufügen:

        setx INSTANA_NET_LOG_PATH "C:\dc_net_log" /M
        setx INSTANA_NET_LOG_LEVEL "DEBUG" /M
        setx INSTANA_NET_FF_LOG_LEVEL "DEBUG" /M
        setx INSTANA_NET_PCP_LOG_LEVEL "DEBUG" /M
        setx INSTANA_TRACER_ENTEREXIT_LOGGING "1" /M
        setx INSTANA_EXTENDED_DEBUG "1" /M

   2. Konfigurieren Sie den folgenden Registrierungsschlüssel unter „ Windows “:

      CLRDebugLog: "_C:\dc_clr_debug_log\clr__"

   3. Führen iisreset Sie den Befehl aus, um die Änderungen zu übernehmen:

      iisreset

   4. Starten Sie die Anwendung erneut.

2. Instana -Agentenprotokolle erfassen:

   1. Beenden Sie den Dienst <instana_install_dir>/bin/stop.sh oder, falls der Dienst als Dienst gestartet wurde, beenden Sie den Dienst.

   2. Protokolldateien entfernen: Löschen Sie alle Dateien im Protokollverzeichnis, um einen Neuanfang zu machen, indem Sie den folgenden Befehl ausführen:

      rm -rf <instana_install_dir>/data/log/*

   3. Stellen Sie die Protokollierungsstufe auf „Debug“ ein: Ändern Sie die Schweregradstufe der Protokollierung in der Agent-Datei configuration.yaml . Weitere Informationen finden Sie unter „Einrichten der Agentenkonfigurationsdatei “.
   4. Starten Sie den Agenten <instana_install_dir>/bin/start.sh oder starten Sie den Dienst.
   5. So lassen Sie das Problem auftreten: Lassen Sie das Problem auftreten und lassen Sie den Agenten etwa 15 Minuten lang laufen.

   6. Protokolldateien sammeln: Komprimieren Sie das Verzeichnis „logs“ zur Übermittlung, indem Sie den folgenden Befehl ausführen:

      cd <instana_install_dir>/data/logs
      zip -r instana_agent_debug_logs.zip *

3. Instana -Trace-Protokolle erfassen:

   1. com.instana.agent.main.sender.File.cfgGo zu [agent-dir]\etc\instana und die Datei öffnen.

   2. Füge die folgenden Zeilen in die Datei ein:

      prefix=instanaTraces
      type=traces

      Diese Konfiguration stellt Ihnen eine Protokolldatei zur Verfügung, die alle Traces mit [agent-dir]/data/log dem instanaTraces Präfix enthält.

   3. Starten Sie den „ Instana “-Agenten neu.

   4. Führen iisreset Sie den Befehl aus, um die Änderungen zu übernehmen:

      iisreset

   5. Starten Sie die Anwendung neu und lassen Sie sie etwa 15 Minuten lang laufen.

   6. Sammeln Sie die Protokolle aus den folgenden Pfaden:

      • Der durch die Variable angegebene Pfad INSTANA_NET_LOG_PATH
      • instana-agent-installation-folder/data/log

4. CLR-Debug-Protokolle erfassen:

   1. Öffnen Sie den Registrierungseditor unter „ Windows “.
   2. Computer\HKEY_LOCAL_MACHINE\SOFTWARE\Instana\ aufrufen
   3. C:\temp\clr_Fügen Sie den Registrierungsschlüssel CLRDebugLog als Zeichenfolge mit Wert hinzu, zum Beispiel.

   4. Alternativ können Sie die Eingabeaufforderung als Administrator öffnen und den folgenden Befehl ausführen:

      reg add "HKLM\SOFTWARE\Instana" /v CLRDebugLog /t REG_SZ /d "C:\temp\clr_" /f

5. Windows -Ereignisprotokolle erfassen:

   1. Ereignisanzeige öffnen:

      1. Drücke Win + R.
      2. Geben Sie eventvwr.msc ein.
      3. Drücken Sie die Eingabetaste.

   2. Go zu dem Protokoll, das Sie exportieren möchten:

      • Windows Protokolle: Windows Protokolle > Anwendung
      • Anwendungs- und Dienstprotokolle
   3. Wählen Sie im Akt ionsfenster die Option „Alle Ereignisse speichern unter“ aus.
   4. Wähle einen Speicherort und speichere die Datei unter .evtx.