🧠 Build Process Watcher

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/[email protected]
  with:
    remote_monitoring: 'false'

Generates log files and charts as workflow artifacts.

Remote Mode (Live Dashboard)

- uses: cdsap/[email protected]
  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

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

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