github.com/abap2UI5-addons/admin-cockpit

Admin Cockpit

Usage, errors, performance and a security traffic light at a glance.

ABAP CloudActiveMIT license

Repository on GitHubInstall with abapGit

What it does

An abap2UI5 app for administrators and IT leads that shows usage and errors per app, response times with their phases, the draft table and a security traffic light of the installation. The Installation & Security and Drafts & Housekeeping tabs need no logging at all; the usage, error and performance tabs fill once a one-line hook in your HTTP handler or the monitor hook of abap2UI5 records the roundtrips. It steps through what a user did session by session, replays failed events with the headless frontend, records requests and responses, raises alerts and purges its own tables. Privacy mode is on by default: no user names are stored.

  • Overview tiles: active users, roundtrips, p95 response time, error rate, alerts
  • Errors grouped by app, event and exception, with the user's steps and a replay
  • Slowest roundtrips with phase breakdown and runtime hints
  • Sessions step by step, find a value in all drafts, delete expired drafts
  • Security traffic light: CSRF origin check, CSP, security headers, developer addons
  • Recorder replays what the user saw and did, with story and process variants
  • Privacy by default: users counted under a daily SHA-256 pseudonym

Requirements

  • ABAP Cloud or Standard ABAP 7.50 or higher, released APIs only; the 7.02 downport is linted in CI
  • UI5 1.71 or later (OpenUI5 and SAPUI5)
  • abap2UI5 1.146.0 or later; branch main needs an abap2UI5 with the monitor hook z2ui5_if_ui5_monitor, otherwise branch standalone
  • Optional: abap2UI5-addons/abap-agent-runtime for the Agents tab
  • Optional: abap2UI5/headless-frontend for Reproduce
  • Optional: abap2UI5-addons/lock-manager for its monitor on the Live tab

Installation

Pull the repository with abapGit into a package of your own. abap2UI5 itself has to be installed first.

https://github.com/abap2UI5-addons/admin-cockpit

  1. Install abap2UI5 first, then this repository with abapGit into a package of its own (for example Z2UI5_COCKPIT, folder logic PREFIX)
  2. Branch main for an abap2UI5 with z2ui5_if_ui5_monitor (the release after 1.146.0); branch standalone for abap2UI5 1.146.0 or later without the monitor hook
  3. Start ?app_start=z2ui5_cl_cockpit_app and claim the administrator role: the first user who presses the button becomes the administrator
  4. Hook the cockpit into your own HTTP handler: replace z2ui5_cl_ui5_http_handler=>run( server ) with z2ui5_cl_cockpit_wire=>run( server ) once every object is active
  5. Or switch the monitor hook on in your user exit: cs_config-check_monitor_active = abap_true in set_config_http_post
  6. Schedule z2ui5_cl_cockpit_job=>run( ) every 15 minutes for housekeeping and alerts

Usage

METHOD if_http_extension~handle_request.
  z2ui5_cl_cockpit_wire=>run( server ).  " instead of z2ui5_cl_ui5_http_handler=>run( server )
ENDMETHOD.