Real-time monitoring and administration for your Platformatic applications
Watt Admin is an open-source developer monitoring tool that provides instant visibility into your Node.js services. Monitor performance, analyze logs, and troubleshoot issues—all from a single, intuitive dashboard.
- Memory tracking: RSS, heap usage, new/old space allocation with interactive charts
- CPU monitoring: Real-time CPU and event loop utilization
- Latency analysis: P90, P95, P99 percentiles at a glance
- Request rates: Monitor requests per second across all services
- View logs from all services in one place
- Filter by service or log level
- Toggle between formatted and raw JSON views
- Export logs for further analysis
- Monitor service status at a glance
- Drill down into individual service metrics
- Compare performance across services
- Restart services directly from the dashboard
- CPU profiling: Capture flame graphs to identify performance bottlenecks
- Heap profiling: Analyze memory allocation patterns
- Offline analysis: Generate self-contained HTML bundles for sharing and review
- Recording mode: Capture metrics and profiles over time for post-mortem analysis
Launch Watt Admin with a single command:
npx wattpm adminThe dashboard will automatically discover your running Platformatic runtimes and open at http://localhost:4042.
Install globally for convenient access:
npm install -g @platformatic/watt-adminThen run:
watt-adminWhen you run watt-admin, it automatically discovers all available Platformatic runtimes:
$ watt-admin
Select a runtime: (Use arrow keys)
❯ my-app (PID: 12345) (Started at 3/10/2025, 10:00:00 AM)
api-service (PID: 54321) (Started at 3/10/2025, 9:30:00 AM)If only one runtime is running, it will be selected automatically.
Run Watt Admin on a different port:
watt-admin --port 4321Capture metrics and profiling data for offline analysis:
# Profile CPU usage
watt-admin --record --profile cpu
# Profile heap allocation
watt-admin --record --profile heapWhen recording, press Ctrl+C to stop. Watt Admin will:
- Collect all metrics and profiling data
- Generate a self-contained HTML bundle
- Automatically open the bundle in your browser
The generated HTML file contains everything you need for offline analysis—perfect for sharing with your team or reviewing later.
- Node.js 18 or higher
- A running Platformatic runtime to monitor
git clone https://github.com/platformatic/watt-admin.git
cd watt-admin
npm install
cp .env.sample .envAuto-reload both backend and frontend on changes:
npm run devnpm run build# Run all tests
npm test
# Run specific test suites
npm run test:cli # CLI tests
npm run test:backend # Backend tests
npm run test:frontend # Frontend tests
npm run test:e2e # End-to-end testswatt-admin/
├── cli.js # CLI entry point
├── lib/ # Core CLI functionality
├── web/
│ ├── backend/ # Fastify API server
│ ├── frontend/ # React dashboard
│ └── composer/ # Platformatic Gateway
├── watt.json # Wattpm configuration
└── test/ # Test suites
Monitor your application while developing locally. Instantly see the impact of code changes on performance.
Use CPU and heap profiling to identify bottlenecks and memory leaks before they reach production.
Generate offline HTML bundles to share performance data and profiling results with your team.
Understand how your services behave under load and optimize based on real data.
For production monitoring and observability, check out Platformatic Console—the intelligent command center for Platformatic Cloud deployments.
Contributions are welcome! Please check out our contributing guidelines to get started.
Apache-2.0 License - see LICENSE for details.
Built with ❤️ by the Platformatic team