Konfigurieren der Log-Ebene in AWI

{"URL":["/*.*/awa/administration_awi_logging"],"heroDescriptionIdentifier":"ice_logging_intro","customCards":[{"id":"ice_modify_logging","title":"Modifying the Log Level in AWI","type":"customize","url":"https://docs.automic.com/documentation/webhelp/english/ALL/components/DOCU/*.*/Automic%20Automation%20Guides/Content/AWA/Admin/admin_AWI_Logging.htm","languages":["en-us"]},{"id":"ice_administration_perspective","title":"Understanding the Administration Perspective","type":"customize","url":"https://docs.automic.com/documentation/webhelp/english/ALL/components/DOCU/*.*/Automic%20Automation%20Guides/Content/AWA/Admin/AdministrationPerspective.htm","languages":["en-us"]},{"id":"ice_Overview_AWI","title":"Understanding the User Interface","type":"customize","url":"https://docs.automic.com/documentation/webhelp/english/ALL/components/DOCU/*.*/Automic%20Automation%20Guides/Content/_Common/GettingStarted/GS_OverviewAWI.htm","languages":["en-us"]}]}

Wenn Fehler auftreten, helfen Ihnen die Logging-Informationen dabei, sie zu beheben und die Ursache zu finden. Das AWI-Logging ist standardmäßig mit INFO als Standard-Log-Ebene aktiviert. Als Administrator mit dem Recht Diagnoseinformationen erstellen können Sie die AWI-Log-Ebene so ändern, dass mehr oder weniger Ereignisse in die Logdatei geschrieben werden.

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

  • Über die Seite AWIManagement > Logging der Benutzeroberfläche, wie in diesem Abschnitt beschrieben

  • Durch Bearbeiten der Konfigurationsdatei logback.xml, in der die Log-Ebene definiert ist (siehe logback.xml - Log-Ebenen konfigurieren)

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

Ändern der Log-Ebene in AWI

Befolgen Sie die nachfolgenden Anweisungen, um die Log-Ebene in der Automic Web Interface zu ändern.

  1. Melden Sie sich bei Mandant 0 an und gehen Sie in der Perspektive "Administration" zu AWIManagement. 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 von AWI auswirken. Wenn Probleme bei der Leistung auftreten, überprüfen Sie Ihre Log-Ebene und reduzieren Sie die Anzahl geschriebener Meldungen, indem Sie eine höhere Log-Ebene festlegen.

    • Es wird empfohlen, dass Sie DEBUG nur auf Test- und Entwicklungsinstanzen und INFO nur auf Produktionsinstanzen anwenden.

    • 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: