A web dashboard for monitoring and managing Poseidon subnet workflows, tasks, and workers.
The Poseidon Subnet Management Console provides a comprehensive interface for:
- Dashboard Monitoring: Real-time metrics for workflow success rates, active workers, and system health
- Workflow Management: View, track, and analyze workflow executions with detailed timelines
- Task Queue Management: Monitor task queues and their processing status
- Worker Monitoring: Track worker performance, staking, and activity status
This frontend application connects to the backend API:
Poseidon Subnet Management API
- Node.js: v18 or higher
- pnpm: v9.15.4 (recommended) or use npm/yarn
- Backend API: The Poseidon Subnet Management API must be running
git clone https://github.com/your-org/poseidon-subnet-management-console.git
cd poseidon-subnet-management-console
Using pnpm (recommended):
pnpm install
Create a .env.local
file in the root directory:
# API Configuration
NEXT_PUBLIC_API_URL=http://localhost:8080
Adjust the NEXT_PUBLIC_API_URL
to point to your running instance of the Poseidon Subnet Management API.
pnpm run dev
Open http://localhost:3000 in your browser to see the application.
pnpm dev
- Start the development server on port 3000pnpm build
- Build the production applicationpnpm start
- Start the production serverpnpm lint
- Run ESLint to check code quality
poseidon-subnet-management-console/
├── app/ # Next.js App Router pages
│ ├── page.tsx # Dashboard homepage
│ ├── layout.tsx # Root layout with navigation
│ ├── workflows/ # Workflow list and detail pages
│ ├── task-queue/ # Task queue management pages
│ └── ...
├── domain/ # Feature-specific modules
│ ├── dashboard/ # Dashboard components and hooks
│ ├── workflow/ # Workflow-related logic
│ ├── task/ # Task management
│ └── worker/ # Worker monitoring
├── common/ # Reusable components and hooks
│ ├── components/ # Pure UI components (shadcn/ui)
│ └── hooks/ # Generic React hooks
├── lib/ # External integrations
│ ├── api/ # API types and transforms
│ └── utils.ts # Utility functions
├── public/ # Static assets
├── styles/ # Global styles
└── swagger.json # API schema definition
Real-time monitoring with:
- Workflow and activity success rate metrics
- Active/idle worker statistics
- Total staked amount tracking
- Historical execution charts
Interactive timeline visualization showing:
- Workflow execution flow
- Activity status and duration
- Event history with zoom/pan controls
- Real-time status updates
Monitor task queues with:
- Queue status and metrics
- Task distribution analysis
- Processing performance
Track worker performance:
- Worker status (Active/Inactive/Jailed)
- Staking information
- Activity assignments
The application consumes the Poseidon Subnet Management API. Key endpoints include:
/api/dashboard/metrics
- Dashboard statistics/api/workflows
- Workflow list and details/api/workflows/{id}/events
- Workflow event history/api/task-queue
- Task queue information/api/workers
- Worker information
API types are defined in lib/api/types.ts and match the swagger.json schema.