🚀 Build Process Watcher

Monitor memory usage and performance of your Gradle build processes in real-time with our powerful GitHub Action.

📦Default Mode

Generate Mermaid diagrams and SVG charts locally, uploaded as GitHub Actions artifacts:

- name: Build Process Watcher
  uses: cdsap/build-process-watcher@v0.5.1
 
- name: Build project
  run: ./gradlew clean build

📤 Output: Check GitHub Actions artifacts for Mermaid diagrams, SVG charts, and log files

🌐Remote Mode

Enable live dashboard with real-time monitoring and GC metrics:

- name: Build Process Watcher
  uses: cdsap/build-process-watcher@v0.5.1
  with:
    remote_monitoring: 'true'
    
- name: Build project
  run: ./gradlew clean build

🌐 Output: Dashboard URL displayed in action output (data available for 24 hours)

📋

Inputs

Key configuration options for the action. View full inputs on GitHub →

Input	Description	Default	Required
`remote_monitoring`	Enable cloud dashboard	false	No
`interval`	Polling interval (seconds)	5	No
`debug`	Enable debug logging	false	No
`disable_summary_output`	Disable GitHub Actions summary output	false	No

🎯

Live Example Dashboard

View a real Gradle build monitoring dashboard with live data from an actual build run.

🔗 Open Live Example Dashboard

Real data from run 18236843825 - 311 samples from GradleDaemon & KotlinCompileDaemon

This example demonstrates the Remote Mode dashboard with 24-hour data retention

🧪

Replay & Compare JSON

Analyze exported JSON runs offline. Replay a single run or compare two runs side-by-side.

💡 No Remote Mode needed: With Local Mode, the action generates JSON files in the workflow artifacts. Download the JSON from your artifacts and upload it to Replay or Compare. You can also open these HTML files locally in your browser.

Example: Replay exported JSON runs with interactive charts

Example: Compare two JSON runs side-by-side with a shared timeline

Compare JSON Runs Replay JSON Run

📊

Default Mode Output Examples

When using Default Mode, you'll get these outputs in your GitHub Actions artifacts:

📊 Mermaid Diagram

Interactive flowchart showing memory usage over time with process details

📄 File: memory_usage.mermaid - Can be rendered in GitHub, GitLab, or any Mermaid-compatible viewer

Example: Memory usage flowchart with process details

📈 SVG Chart

High-quality vector chart showing RSS and Heap usage with process-specific colors

📄 File: memory_usage.svg - Scalable vector graphics perfect for documentation and reports

Example: RSS and Heap usage chart with process-specific colors

🆕

GC Metrics Collection

🔄 GC Time Chart

Track garbage collection performance over time to identify GC-related performance bottlenecks. GC time is displayed in seconds and works across all JVM GC collectors (Parallel, G1, Serial, CMS).

Example: GC time chart showing garbage collection performance over time

✨

Key Features

📊 Default Mode

Generate Mermaid diagrams and SVG charts locally. Data is stored locally and uploaded as GitHub Actions artifacts.

🌐 Remote Mode

Check the current state of processes in real-time through our web dashboard. Data is stored in the cloud with 24-hour retention.

Ready to Get Started?

Start monitoring your build processes today with just a few lines of code.

View Example Dashboard View on GitHub