Skip to content

Build Process Watcher

Actions
Monitor Java build processes with optional backend integration
v0.3
Latest
Star (5)

Tags

 (1)

🧠 Build Process Watcher

GitHub Marketplace

Monitor memory usage of Java/Kotlin build processes (GradleDaemon, GradleWorkerMain, KotlinCompileDaemon) during CI builds. Track heap and RSS usage, generate charts, and visualize data in real-time dashboards.


✨ Quick Start

Local Mode (Artifacts Only)

- uses: cdsap/build-process-watcher@0.3
  with:
    remote_monitoring: 'false'

Generates log files and charts as workflow artifacts.

Remote Mode (Live Dashboard)

- uses: cdsap/build-process-watcher@0.3
  with:
    remote_monitoring: 'true'

Data sent to cloud backend with live dashboard (3-hour retention).
Dashboard URL shown in job output.


📋 Inputs

Input Description Default Required
remote_monitoring Enable cloud dashboard false No
backend_url Custom backend URL Default Cloud Run URL No
run_id Custom run identifier Auto-generated No
log_file Local log filename build_process_watcher.log No
interval Polling interval (seconds) 5 No
debug Enable debug logging false No

📊 Outputs

Local Mode

  • build_process_watcher.log - Raw memory data
  • memory_usage.svg - SVG chart
  • GitHub Actions job summary with Mermaid chart

Remote Mode

  • Live dashboard URL (in job output)
  • Data retention: 3 hours
  • Real-time process monitoring

📸 Screenshots

Interactive Dashboard

SVG Chart Example

The dashboard shows:

  • Memory usage over time for all monitored processes
  • Individual process metrics (RSS, Heap Used, Heap Capacity)
  • Aggregated memory consumption
  • Interactive charts with Plotly.js

GitHub Actions Summary

Mermaid Diagram Example

The job summary includes:

  • Mermaid flowchart showing process memory progression
  • Per-process statistics (max, average, final measurements)
  • Timeline of monitoring session

🏗️ Architecture

  • Frontend: Firebase Hosting (static dashboard)
  • Backend: Google Cloud Run (Go API)
  • Database: Firestore (3-hour TTL)

📝 License

MIT

Build Process Watcher is not certified by GitHub. It is provided by a third-party and is governed by separate terms of service, privacy policy, and support documentation.

About

Monitor Java build processes with optional backend integration
v0.3
Latest

Tags

 (1)

Build Process Watcher is not certified by GitHub. It is provided by a third-party and is governed by separate terms of service, privacy policy, and support documentation.