Logs in der SAP BTP und FlexGuide4

Wenn etwas in einer Software schief geht, ist es immer eine gute Idee, in die Logs zu schauen. Die SAP Business Technology Platform (BTP) und die Apps, die auf ihr laufen, bilden dabei keine Ausnahme.

In diesem Artikel zeigen wir Ihnen, wo Sie in der BTP und der BTP-Applikation FlexGuide4 von Flexus Logs finden und wie Sie diese downloaden können.

Man könnte meinen, dass für die Problembehebung einer BTP-Applikation die Logs dieser Applikation ausreichend sind. Allerdings muss dabei bedacht werden, dass die Applikation in einer Runtime (Cloud Foundry) läuft und sich Probleme mit der Runtime auf die Applikation auswirken können. Des Weiteren kann bei gravierenden Fehlern in der Applikation (z.B. bei einem Crash) diese womöglich gar nicht aufgerufen werden. In beiden dieser Fälle sollten die Logs der Runtime als zusätzliche Informationsquelle zur Rate gezogen werden.

Logs in der BTP

Bei den Logs in der BTP muss zwischen den verschiedenen Ebenen, auf die sie sich beziehen, unterschieden werden. Auf Ebene des globalen Accounts und von Subaccounts sind keine Logs verfügbar, allerdings auf Ebene der Cloud Foundry Runtime in den Spaces und eventuell in Applikationen, die in der Runtime laufen.

Anmerkung: Die Kyma Runtime wird in diesem Artikel nicht behandelt. Für Informationen über Logs in Kyma schauen Sie bitte in die Dokumentation.

Logs in Spaces

Logs auf Ebene von Spaces werden als „Ereignisse“ bezeichnet. Ereignisse dokumentieren Veränderungen auf Ebene des Spaces. Zum Beispiel wird bei der Erstellung jeder neuen Route ein Space-Ereignis geloggt.

Um Logs auf Space-Ebene anzusehen, navigieren Sie zu dem Space und klicken Sie in der Sidebar auf „Space-Ereignisse“:

Der Eintrag in der Ereignis-Spalte gibt einen Hinweis darauf, was genau passiert ist. Besonders relevant sind die Einträge „audit.app.crash“ und „audit.app.restart“. Die Spalte Beschreibung kann hilfreich sein, gibt jedoch meist nur minimale weitere Informationen darüber, was genau passiert ist.

Logs in der Anwendungsübersicht

Bei den Logs auf Ebene von Anwendungen muss zwischen „Anwendungsereignissen“ und „Protokollen“ unterschieden werden. Anwendungsereignisse sind schlichtweg alle Ereignisse, die sich auf diese Anwendung beziehen. „Protokolle“ ist eine deutsche Übersetzung der SAP. In der englischen Benutzeroberfläche ist schlichtweg von „Logs“ die Rede. Bei Protokollen handelt es sich um Logs, die von der Applikation an Cloud Foundry geschickt werden, und um solche, die direkt von Cloud-Foundry-Komponenten generiert werden.

Anwendungsereignisse

Um die Anwendungsereignisse einsehen zu können, navigieren Sie zu der gewünschten Anwendung und klicken Sie in der Sidebar auf Anwendungsereignisse:

Bei den Anwendungsereignissen sind alle Ereignisse gelistet, die sich auf die jeweilige Anwendung beziehen. Daher können Sie alle Ereignisse in dieser Tabelle auch in der Tabelle der Space-Ereignisse finden, allerdings müssten Sie bei letzterer wahrscheinlich länger scrollen, um ein bestimmtes Ereignis zu finden.

Da es sich hier wieder um Ereignisse handelt gilt auch hier: In der Tabelle sehen Sie, was passiert ist, aber die Beschreibung gibt nur selten Auskunft darüber, warum es passiert ist.

Anwendungs-Logs

Die Anwendungs-Logs finden Sie in der Ansicht der jeweiligen Anwendung, indem Sie in der Sidebar auf Protokolle klicken.

In der Tabelle werden nur die jüngsten Logs angezeigt. Je nach Menge der Logs kann der Zeitraum, der durch die Logs abgedeckt wird, sehr kurz sein (20 Minuten oder weniger). Daher empfehlen wir Ihnen beim Auftreten von Problemen in einer Anwendung, die Logs zeitnah nach Auftreten des Problems herunterzuladen. Dies können Sie durch Klick auf den Knopf Herunterladen oben rechts über der Tabelle tun.

Mit dem Suchfeld oberhalb der Tabelle können Sie lediglich den Text in der Spalte Meldung filtern. Wenn Sie eine der anderen Spalten nach einer bestimmten Zeichenabfolge durchsuchen wollen, können Sie dies am einfachsten in der heruntergeladenen Datei tun.

Logs in FlexGuide4

Die Logs für FlexGuide4 finden Sie unter dem Eintrag Logs in der Sidebar. Die Spalten sind selbsterklärend bis auf Typ. Damit ist das Level, beziehungsweise „Schweregrad“ der Nachricht gemeint. Das niedrigste Level ist DEBUG, gefolgt von INFO, gefolgt von WARN (kurz für „warning“) und schließlich ERROR als höchstes Level.

Mit dem orangen Knopf Logs löschen können Sie die Logs löschen. Wir empfehlen, spärlichen Gebrauch von dieser Funktion zu machen. Einer der wenigen sinnvollen Anwendungsfälle tritt bei einer Überlastung der Datenbank durch Logeinträge auf. In diesem Fall sollten Sie zusätzlich zur Löschung in den Einstellungen (Schritt 1 in dem Screenshot unten) für den Job Alte Lognachrichten löschen einen für Sie sinnvollen Aufbewahrungszeitraum konfigurieren (2) und anschließend den Job aktivieren (3).

Fehlerdiagnose

FlexGuide4 setzt sich aus mehreren Modulen zusammen. Module sind sozusagen „Mini-Applikationen“, welche in ihrem Zusammenspiel eine ganze Applikation ergeben. Sie finden eine Übersicht über die Module in dem Space, in dem FlexGuide4 läuft:

Anmerkung: Dass der Datenbank-Deployer (db-deployer) gestoppt ist, ist intendiertes Verhalten. Ihn zu starten behebt keine Fehler.

Wie der Name schon vermuten lässt, ist das „core“-Modul besonders relevant. Schauen Sie, sofern nichts anderes indiziert ist, zunächst in die Protokolle des Core-Moduls.

Falls ein anderes Modul Schwierigkeiten bereitet, sind natürlich die Protokolle von diesem Modul relevanter. Hinweise darauf können Sie der Tabelle mit den Space-Ereignissen entnehmen, wobei die Ereignisse audit.app.crash und audit.app.restart besonders relevant sind. Das betroffene Modul können Sie der Spalte Ziel entnehmen.