AWI Verwaltung: Loging

Wenn Fehler auftreten, werden die Logging-Informationen Ihnen bei der Fehlersuche helfen, den Grund zu finden. Das AWI-Logging ist standardmäßig mit INFO als Standard-Log-Ebene aktiviert. Als Administrator können Sie die AWI-Log-Ebene ändern, damit mehr oder weniger Ereignisse in die Logdatei geschrieben werden.

Sie können die AWI-Log-Ebene auf zwei unterschiedliche Arten ändern:

  • Durch Bearbeiten der Konfigurationsdatei logback.xml, in der die Log-Ebene definiert ist

  • Über die Seite AWI Management > Logging der Benutzeroberfläche

    Wichtig! Das Ändern der Log-Ebene über die Benutzeroberfläche ist nur in Mandant 0 möglich.

Dieses Thema beschreibt, wie Sie die Log-Ebene im Automic Web Interface ändern.

Die Log-Ebene ändern

  1. Melden Sie sich bei Mandant 0 an und gehen Sie in der Administration-Perspektive zu AWI Management . Die Seite Logging wird angezeigt.

  2. Wählen Sie unter Logs umfassen die Log-Ebene aus, die Sie auf die Logdateien anwenden möchten.

    Es gibt fünf Log-Ebenen. Die verfügbaren Log-Ebenen der von höchsten zu niedrigsten Ebene sind:

    • ERROR

      Fehlgeschlagene Aktion einer AWI -Komponente, von der sich das AWI nicht erholen konnte, wie z. B. nullPointExceptions oder closedStreamExceptions.

      Nachverfolgung von Daten in der Nachricht

      Keine benutzeridentifizierenden Daten. Hostnamen, andere standortspezifische Daten, Klassennamen, Objektnamen und dergleichen sind jedoch in den ereignisbezogenen Angaben enthalten. Die Nachricht enthält den vollständigen Stack-Trace.

    • WARNING

      Unerwartetes Verhalten einer AWI -Komponente, wie z. B. instabile Netzwerkverbindungen, die eine automatische Wiederherstellung der Verbindung des AWI, einen Wiederholungsversuch nach einem Timeout oder das Auslösen eines Workarounds für einen Bug eines Drittanbieters erfordern.

      Nachverfolgung von Daten in der Nachricht

      Wie ERROR-Ebene 

    • INFO (Standard)

      Konfigurationswerte beim Anmelden oder Hochfahren von Komponenten oder globale Konfigurationsänderungen.

      Nachverfolgung von Daten in der Nachricht

      wie ERROR-Ebene, jedoch ohne vollständigen Stack-Trace.

    • DEBUG

      Benutzerspezifische Aktionen auf hoher Ebene, wie z. B. An- und Abmeldeereignisse, Benutzeränderungen (z. B. Objektbearbeitung), autorisierungsbezogene Ereignisse (z. B. erfolgreiche und fehlgeschlagene Setup-Aktionen) und wichtige Leistungskennzahlen

      Nachverfolgung von Daten in der Nachricht

      Benutzerinformationen (z. B. Benutzer-ID und HTTP-Session-ID) und ereignisbezogene Angaben.

    • TRACE

      Benutzerspezifische Aktionen auf niedriger Ebene wie Navigation, Objekt öffnen, Tastenklicks, die Nutzlast von Backend-Aufrufen, interne Anwendungsereignisse und alle Aufrufe an das Backend.

      Nachverfolgung von Daten in der Nachricht

      wie bei DEBUG

    Hinweise:

    • Ein umfangreiches Logging kann sich auf die Leistung des AWI auswirken. Wenn Probleme bei der Leistung auftreten, überprüfen Sie Ihre Log-Ebene und reduzieren Sie die geschriebenen Meldungen, indem Sie eine höhere Log-Ebene festlegen.

    • Es wird empfohlen, dass Sie DEBUG nur auf Test- und Entwicklungsinstanzen und auf INFO zur Produktion verwenden.

    • In AAKE haben Sie zusätzliche Optionen, um die Standard-Log-Ebene zu ändern. Weitere Informationen finden Sie unter Container-basierte Systeme konfigurieren.

  3. Bestätigen Sie, dass Sie die Log-Ebene ändern möchten.

Siehe auch: