Vorbereiten von Log-Dateien für die Meldung von Fehlern

Auf dieser Seite wird erläutert, was im AWI protokolliert werden kann und wo Sie die Log- und Trace-Einstellungen ändern können.  Sie benötigen diese Informationen, wenn Sie Probleme mit dem AWI haben und dieses untersuchen möchten. Sie erfahren außerdem, was Sie tun sollten, um sich auf den CA Automic

Was kann das AWI  protokollieren und wie aktiviere ich diese Funktionen?

AEAPI-Tracing 

Hiermit wird die Kommunikation zwischen AE und AWI aus der Sicht von AWI protokolliert.

Setzen Sie in der Datei uc4config.xml die Trace-Element-Parameter auf <trace count="10" xml="3"></trace>

Hinweise:

  • Kontaktieren Sie Ihre AE-Administratoren, um die entsprechende Protokollebene anzufordern, wenn ein AE-serverseitiges Tracing erforderlich ist
  • Dies ist das gleiche Protokoll, das der Rich Client der AE  verwendet, um mit dem AE-Backend zu kommunizieren, weshalb dies manchmal als "Client Trace" bezeichnet wird.

Weitere Informationen finden Sie unter uc4config.xml - Konfigurieren der Verbindung zwischen AWI und AE.

Protokollierung von AWI-Ereignissen 

Sie definieren die Ebene der Meldungen, die in der Datei logback.xml protokolliert werden. Um Protokolldaten für das Debuggen von AWI -Problemen zu sammeln, setzen Sie die Protokollebene auf DEBUG (<root level="DEBUG">). In den meisten Fällen sammelt diese Einstellung genügend Protokolldaten für ein effektives Debugging, ohne die Performance übermäßig zu belasten. In einigen Fällen kann der CA Automic-Support jedoch verlangen, dass Sie die vollständige TRACE-Protokollierung einschalten.

Weitere Informationen finden Sie unter logback.xml - Log-Ebenen konfigurieren.

Hinweis: Sie können die Log-Ebene unter Verwendung der Automic Web Interfaceändern. Die Logdateien zeigen an, dass die Log-Ebene über die Benutzeroberfläche geändert wurde. Die geänderte Log-Ebene wird jedoch nicht in der Datei logback.xml gespeichert. Aus diesem Grund gilt diese Änderung nur, bis Sie den Anwendungsserver neu starten. Weitere Informationen finden Sie unter AWI Verwaltung: Loging.

Protokollierung aktivieren

Wenn Sie die Trace- oder Log-Einstellungen wie oben beschrieben ändern, müssen Sie den Anwendungsserver neu starten, damit die Änderungen wirksam werden.

Vorbereiten und Senden von Logdateien an den CA Automic-Support

  1. (Empfehlung) Speichern Sie die alten Logdateien, sodass Sie Ihnen auch dann zur Verfügung stehen, wenn der Fehler nicht reproduziert werden kann.
  2. Aktivieren Sie das Tracing und die Protokollierung, wie bereits beschrieben.
  3. Starten Sie Ihren Anwendungsserver neu.
  4. Versuchen Sie, den Fehler zu reproduzieren.
  5. Sammeln Sie die folgenden Informationen und senden Sie sie an den CA Automic-Support:
    • Alle Tomcat-Logdateien.

      Alle AWI-Logdateien werden im Ordner "logs" des Tomcat Web Application Servers gespeichert. Die Logdateien werden als <Host_Name>_ECC_Log benannt.##.TXT- und Trace-Dateien werden als <Host_Name>_ECC_TRACE benannt.##.TXT. Die Dateinummer (##) wird erhöht, wobei 00 die aktuelle Datei ist.

      Wenn Ihre Organisation sicherheitsbewusst ist, dann senden Sie bitte zumindest alle Protokolldateien mit dem Namen *_ECC_*. Natürlich ist es für die Fehleranalyse hilfreich, wenn man nach Möglichkeit alle Logdateien zur Verfügung stellt.

    • AE-serverseitiger Trace nach Best Practices bei Bedarf oder wenn ein AE-Backend-Problem sehr wahrscheinlich ist
    • Zeit, zu der der Fehler aufgetreten ist. Dies ist sehr wichtig für die Debugging-Analyse.
    • Wenn das Problem mit Diskrepanzen zwischen dem Rich Client der AE  und dem AWI für denselben AE-Server zusammenhängt, stellen Sie sicher, dass Sie Traces sowohl für den Rich Client der AE  als auch für das AWI protokolliert werden. Um Traces vom Rich Client zu sammeln, setzen Sie das Trace-Element in der Datei uc4config.xml auf dem Rich Client auch auf <trace count="10" xml="3"></trace>.

Wenn Sie Hilfe benötigen, wenden Sie sich an unsere Support-Experten, siehe Dateien, die dem technischen Support helfen.