Tracing und Logging im SAP-System

Mit den Trace-Funktionen können Sie den Ablauf von verschiedenen Operationen in Ihrem SAP-System verfolgen. Dies dient zur Überwachung des Systems und zur Eingrenzung von auftretenden Problemen.

Das Systemprotokoll ist die Analyseoption für Fehler im System und in seiner Umgebung.

Es gibt Funktionen, die die Eigenschaften von Traces und Protokollen kombinieren, wie z.B. Entwickler-Traces.

Es gibt zahlreiche Trace-Möglichkeiten in SAP-Systemen. Die wichtigsten sind unter „Trace- und Protokolloptionen" aufgeführt.

Mit der Transaktion SM21 können Sie Fehler ermitteln und korrigieren, die in Ihrem System und seiner Umgebung auftreten. SAP-Anwendungsserver zeichnen Ereignisse und Probleme in Systemprotokollen auf. Jeder SAP-Anwendungsserver verfügt über ein lokales Protokoll, das die von diesem Server protokollierten Meldungen wie Fehler, Warnungen und Informationen enthält.

Wenn zur Laufzeit beim Aufruf eines ABAP-Programms unvorhersehbare Fehler auftreten, wird ein Laufzeitfehler protokolliert, der einen Kurzdump generiert (Transaktion ST22).

Wenn Sie die SAP-internen Aktivitäten wie Berechtigungsprüfungen, Datenbankzugriffe, Kernel-Funktionen und RFC-Aufrufe aufzeichnen möchten, verwenden Sie die Funktion Systemtrace (Transaktion ST01).

Mit der Funktion Performance-Trace (Transaktion ST05) können Sie Datenbankaufrufe, Aufrufe der Sperrverwaltung und Remote-Aufrufe von Reports und Transaktionen in einer Trace-Datei aufzeichnen und die protokollierten Messergebnisse als Listen anzeigen. Der Performance-Trace bietet auch umfangreiche Unterstützung für eine detaillierte Analyse einzelner Trace-Sätze. Alle Funktionen des Performance-Trace finden Sie auch im Systemtrace. Der Performance-Trace ist ein geeigneteres Analysewerkzeug für bestimmte Probleme, da der reduzierte Funktionsumfang die Handhabung erleichtert.

Technische Informationen zu internen SAP-Problemen werden in den Entwickler-Traces (Transaktion ST11) protokolliert.

Ereignisse und Probleme werden lokal auf jedem Anwendungsserver aufgezeichnet und können im Systemprotokoll (Syslog) im SAP-System angezeigt werden, wie in der folgenden Abbildung dargestellt.

Sie zeigen mit der Transaktion SM21 ein Systemprotokoll an. Standardmäßig liest das System das Protokoll für die letzten ein bis zwei Stunden. Neben dem lokalen Systemprotokoll können Sie auch Systemprotokolle für andere Anwendungsserver anzeigen. Auf dem Einstiegsbild Systemprotokoll anzeigen können Sie angeben, für welche Instanzen das Syslog angezeigt werden soll. Die Syslog-Meldungen werden dann für alle ausgewählten Instanzen angezeigt.

Sie können den Pfad und die Dateinamen für lokale Protokolldateien mit den folgenden Systemprofilparametern definieren:

/local/file: Dateiname für das lokale Protokoll (Standard: SLOG<SAPSYSTEMNUMBER>)

Standardmäßig werden die Protokolldateien für das lokale Systemprotokoll im Verzeichnis /usr/sap/<SID>/<instance_directory>/log abgelegt.

Die Protokolldatei hat eine maximale Größe, die mit dem Profilparameter rslg/max_diskspace/local konfiguriert werden kann. Die ältesten Einträge werden überschrieben, sobald das Limit erreicht ist.

ABAP-Programme werden bei ihrer Erstellung statisch und während ihres Ablaufs dynamisch überprüft. Fehlerhafte Zustände, die statisch nicht vorhersehbar sind und erst zur Laufzeit auftreten, werden von der ABAP-Laufzeitumgebung dynamisch erkannt. Solche Zustände führen zu Ausnahmen. Falls eine Ausnahme nicht behandelt wird oder nicht behandelbar ist, kommt es zu einem Laufzeitfehler. Beim Auftreten eines Laufzeitfehlers bricht die ABAP-Laufzeitumgebung die Ausführung des Programms ab, erzeugt einen sogenannten Kurzdump und verzweigt in ein spezielles Bild zur Analyse des Kurzdumps. Kurzdumps können Sie über die Transaktion ST22 aufrufen.

Ein Kurzdump ist in verschiedene Blöcke unterteilt, die den Fehler dokumentieren. In der Übersicht kann man sehen, welche weiteren Informationen im Kurzdump noch ausgegeben werden, wie z. B. Inhalte von Datenobjekten, aktive Aufrufe und Kontrollstrukturen. Aus der Kurzdump-Ansicht kann im ABAP-Debugger an die Abbruchstelle verzweigt werden. Es können folgende Fehlersituationen unterschieden werden:

• Interner Fehler

  Der Kernel erkennt einen Fehlerzustand. In diesem Fall ist SAP mittels einer Meldung zu benachrichtigen.

• Installations- und Umgebungs-/Ressourcenfehler

  Hier ist ein Fehler aufgetreten, der durch falsche Systeminstallation oder durch fehlende Ressourcen (z.B. Datenbank ist geschlossen) verursacht wurde.

• Fehler im Anwendungsprogramm

  Typische Fehlerursachen sind:

  • Inhalt eines numerischen Felds nicht im richtigen Format.

  • Arithmetischer Überlauf.

  • Externe Prozedur ist nicht vorhanden.

  • Typkonflikt bei der Parameterübergabe an eine externe Prozedur.

Kurzdumps werden standardmäßig 28 Tage im System gespeichert. Kurzdumps können Sie gemäß einer Zeitangabe mit der Funktion Reorganisieren löschen, die Sie über Springen → Reorganisieren aufrufen können. Sie können einen Kurzdump ohne Zeitlimit mit der Funktion Behalten sichern, die Sie in der Detailsicht unter Kurzdump → Behalten/Freigeben auswählen können.

Treten Probleme mit ABAP-Programmen auf, können Sie einen Auszug des Kurzdumps an SAP senden. Ein Kurzdump stellt sowohl für die SAP-Hotline als auch für die Remote-Beratung eine wichtige Grundlage zur Lösung von Problemen dar.

Zur Aufzeichnung von internen Systemaktivitäten kann der SAP-Systemtrace (kurz auch Systemtrace) eingesetzt werden. Sie können den Systemtrace über die Transaktion ST01 aufrufen. Über die Transaktion ST01können Sie auch die als inaktiv dargestellte Trace-Datei anzeigen.

Im Einstiegsbild werden die zu protokollierenden Komponenten gewählt. Sie können den Systemtrace zum Tracing von Berechtigungsprüfungen verwenden. Ist der Trace für die Berechtigungsprüfung aktiviert, so werden alle Berechtigungsprüfungen, die vom System vorgenommen werden, aufgezeichnet. Bei der Auswertung können Sie erkennen, zu welchen Zeitpunkten das System welche Berechtigungen geprüft hat. Darüber hinaus werden folgende Detailinformationen bereitgestellt: Datum, Uhrzeit, Workprozessnummer, Benutzer, Berechtigungsobjekt, Programm, Zeile, Anzahl der Berechtigungswerte und Berechtigungswerte.

Mit dem SQL-Trace können Sie verfolgen, wie die in Reports und Transaktionen verwendeten OPEN-SQL-Befehle in Standard-SQL-Befehle übersetzt und mit welchen Parametern die SQL-Befehle an das verwendete Datenbanksystem übergeben werden. Ebenso werden die Ergebnisse des SQL-Befehls wie der Returncode und die Anzahl der von der Datenbank gefundenen, eingefügten oder gelöschten Sätze protokolliert. Die Protokollierung der Ausführungszeit und der Aufrufstelle im Anwendungsprogramm ermöglicht Ihnen weitergehende Auswertungen.

Mit dem Enqueue-Trace können Sie verfolgen, welche Sperranweisungen das SAP-System für welche Sperrobjekten ausführt und welche Parameter das System für diese Sperren verwendet. Außerdem wird in der Trace-Datei protokolliert, welches Programm die Sperre ausgelöst hat, wer der Eigentümer der Sperre ist und die Zeitdauer, die der Enqueue-Server benötigt, um die Sperre wieder aufzuheben.

Mit dem RFC-Trace können Sie verfolgen, welche Remote-Aufrufe das SAP-System ausführt und auf welcher Instanz diese Aufrufe ausgeführt werden. Aus der Trace-Aufzeichnung können Sie entnehmen, welche Funktionsbausteine vom zu analysierenden Programm remote aufgerufen wurden und ob der RFC-Aufruf erfolgreich ausgeführt wurde. Die Gesamtzeit, die für die Ausführung des Remote-Aufrufs benötigt wurde, und die Anzahl der beim RFC gesendeten und empfangenen Bytes werden ebenfalls in der Trace-Datei protokolliert.

Der Performance-Trace wird verwendet für die Analyse von:

• Datenbankaufrufen (SQL-Trace)

• Sperrverwaltungsaufrufen (Enqueue-Trace)

• Zugriffen auf Tabellenpuffer (Puffer-Trace)

• Remote-Aufrufen von Berichten und Transaktionen (RFC-Trace)

• HTTP-Kommunikation (HTTP-Trace)

• Einzelnen SQL-Statements (Einzelnes SQL-Statement)

Der Performance-Trace bietet ähnliche Trace-Optionen wie der System-Trace. Er ermöglicht es Ihnen, die Datenbankaufrufe, die Aufrufe der Sperrverwaltung, Tabellenpuffer und die Remote-Aufrufe von Reports sowie Transaktionen aus dem SAP-System selbst in einer Trace-Datei aufzuzeichnen. Sie können den Performance-Trace über die Transaktion ST05 aufrufen.

Entwickler-Traces sind Aufzeichnungen, die technische Informationen enthalten und im Fehlerfalle herangezogen werden. Diese Art der Ablaufverfolgung ist besonders nützlich, um Host- und SAP-interne Probleme zu untersuchen, die Ihr SAP-System beeinträchtigen. Entwickler-Traces dev_ * werden in Dateien im Verzeichnis /usr/sap/<SID>/<Instanzverzeichnis>/work des SAP-Anwendungsservers geschrieben, der den Trace generiert hat, wie in der Abbildung „Entwickler-Traces" dargestellt.

Sie haben im Betriebssystem Zugriff auf die Entwickler-Traces über die Transaktion AL11, die Transaktion ST11 oder die Transaktion SM50 (Workprozess-Übersicht). In der Transaktion SM50 können Sie über → Prozess-Trace → Datei anzeigen zu den einzelnen dev_*-Traces wechseln. In den angezeigten Traces können Sie sich weitere Details durch Erweitern einzelner Einträge anzeigen lassen.

Über Systemprofilparameter können Sie die Größe der Trace-Dateien beschränken und einen entsprechenden Pfad angeben.

Der SAP-System-Trace schreibt die Trace-Daten in Trace-Dateien. Aus Performancegründen wird dies nicht direkt gemacht, sondern über einen prozessinternen Puffer. Der Profilparameter rstr/buffer_size_kB bestimmt die Größe dieses Puffers. Der SAP-Trace legt die Daten in mehrere Dateien ab, die der Reihe nach geschrieben werden. Der Parameter rstr/filename legt den Basisnamen dieser Dateien fest. Es gibt immer eine Datei mit genau diesem Namen. Wenn die Datei voll ist (Parameter rstr/max_filesize_MB), wird die Datei umbenannt und eine neue Datei mit dem Basisnamen erzeugt. Beim Umbenennen der Datei wird eine Zahl von 00 bis 99 an den Dateinamen gehängt. Der Parameter rstr/max_files legt fest, wie viele Dateien es insgesamt maximal gibt. Wenn dieser Wert überschritten ist, werden die Dateien überschrieben.