Skip to content

Latest commit

 

History

1 Commit

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Process Performance (PPERF)

Where the time goes: duration statistics per activity (average, median, P95, max from the closed tasks of the last N days), per process (completed instances, creation to last change), throughput per day (instances started / completed / failed / terminated, as a table per application and an SVG bar chart), and the observed variants of every process (the ordered sequence of user tasks of each completed instance and how often each sequence occurs). The engine's own performance endpoints (/performance/query, /performance/instance/{id}) need tracking groups and are not used.

Target: IBM BPM 8.6.2, IBM BAW 20-26 (traditional) and CP4BA (Workflow Authoring / Studio import). Built from out-of-the-box building blocks only (System Data, UI Toolkit, one client-side human service, server-side service flows calling the product REST API as a technical user; where no API exists, a read-only SELECT on the product database through the engine's own datasource) - no third-party toolkit, no custom Java.

Install

  1. Import packages/Process-Performance-1.0.twx (Process Center / Workflow Center console: Import Process App; CP4BA: Business Automation Studio > Import).
  2. Set the environment variables of the snapshot (below): the server base URL as seen from the server itself and the technical user the flows call the REST API with. The package ships no password.
  3. Expose the dashboard to a team (the package's default team holds celladmin; change it) and open it from Process Portal or the playback URL of the human service.

Dashboard

Tab Content
Step durations application, process, last N days, Compute, Export CSV; table per activity
Instance durations table per process
Throughput SVG bars per day + table per day and application
Variants table of activity sequences with share

Environment variables

serverBaseURL, restAuthUser, restAuthPassword, restTrustAllCertificates, appTitle.

Documents

  • docs/DESIGN.md - what the app does, every service flow with its REST calls and SQL, business objects, build and test procedure, pitfalls met on the way.
  • docs/RECIPES-AND-PITFALLS.md - the recipe collection of all the kit apps: shared helpers, verified search / team / instance / operations / product database facts, build and deployment pitfalls.

Rebuilding and customising

The application is generated by a small Python program on the twxkit generator (standard library only, no base export). The generator and the kit are served to AI agents and developers by the BAW Knowledge MCP server (https://bawmcp.dosvak.com/mcp, see dosvak/baw-mcp): get_package('process performance (pperf)') returns this package, get_tool('build_pperf.py') the generator, get_topic('howto-kit-utility-app-recipes') the recipes.

License

Apache License 2.0 - see LICENSE and NOTICE. IBM, IBM Business Automation Workflow, IBM Business Process Manager and IBM Cloud Pak are trademarks of International Business Machines Corporation; this project is not affiliated with or supported by IBM.

About

Process Performance for IBM BAW: step durations (average, median, P95 per activity), instance durations, throughput per day with a chart, observed variants - from the task and instance searches, no tracking groups

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors