9b9c5beb23
chore: enhance .gitignore and remove obsolete documentation files - Reorganize .gitignore with categorized sections for better maintainability - Add comprehensive ignore patterns for Python, Node.js, databases, logs, and build artifacts - Add project-specific ignore rules for coordinator, explorer, and deployment files - Remove outdated documentation: BITCOIN-WALLET-SETUP.md, LOCAL_ASSETS_SUMMARY.md, README-CONTAINER-DEPLOYMENT.md, README-DOMAIN-DEPLOYMENT.md ```
165 lines
3.8 KiB
Markdown
165 lines
3.8 KiB
Markdown
# AITBC Miner Dashboard
|
|
|
|
A real-time monitoring dashboard for GPU mining operations in the AITBC network.
|
|
|
|
## Features
|
|
|
|
### 🎯 GPU Monitoring
|
|
- Real-time GPU utilization
|
|
- Temperature monitoring
|
|
- Power consumption tracking
|
|
- Memory usage display
|
|
- Performance state indicators
|
|
|
|
### ⛏️ Mining Operations
|
|
- Active job tracking
|
|
- Job progress visualization
|
|
- Success/failure statistics
|
|
- Average job time metrics
|
|
|
|
### 📊 Performance Analytics
|
|
- GPU utilization charts (last hour)
|
|
- Hash rate performance tracking
|
|
- Mining statistics dashboard
|
|
- Service capability overview
|
|
|
|
### 🔧 Available Services
|
|
- GPU Computing (CUDA cores)
|
|
- Parallel Processing (multi-threaded)
|
|
- Hash Generation (proof-of-work)
|
|
- AI Model Training (ML operations)
|
|
- Blockchain Validation
|
|
- Data Processing
|
|
|
|
## Quick Start
|
|
|
|
### 1. Deploy the Dashboard
|
|
```bash
|
|
cd /home/oib/windsurf/aitbc/apps/miner-dashboard
|
|
sudo ./deploy.sh
|
|
```
|
|
|
|
### 2. Access the Dashboard
|
|
- Local: http://localhost:8080
|
|
- Remote: http://[SERVER_IP]:8080
|
|
|
|
### 3. Monitor Mining
|
|
- View real-time GPU status
|
|
- Track active mining jobs
|
|
- Monitor hash rates
|
|
- Check service availability
|
|
|
|
## Architecture
|
|
|
|
```
|
|
┌─────────────────┐ ┌──────────────────┐ ┌─────────────────┐
|
|
│ Web Browser │◄──►│ Dashboard Server │◄──►│ GPU Miner │
|
|
│ (Dashboard UI) │ │ (Port 8080) │ │ (Background) │
|
|
└─────────────────┘ └──────────────────┘ └─────────────────┘
|
|
│
|
|
▼
|
|
┌─────────────────┐
|
|
│ nvidia-smi │
|
|
│ (GPU Metrics) │
|
|
└─────────────────┘
|
|
```
|
|
|
|
## API Endpoints
|
|
|
|
- `GET /api/gpu-status` - Real-time GPU metrics
|
|
- `GET /api/mining-jobs` - Active mining jobs
|
|
- `GET /api/statistics` - Mining statistics
|
|
- `GET /api/services` - Available services
|
|
|
|
## Service Management
|
|
|
|
### Start Services
|
|
```bash
|
|
sudo systemctl start aitbc-miner
|
|
sudo systemctl start aitbc-miner-dashboard
|
|
```
|
|
|
|
### Stop Services
|
|
```bash
|
|
sudo systemctl stop aitbc-miner
|
|
sudo systemctl stop aitbc-miner-dashboard
|
|
```
|
|
|
|
### View Logs
|
|
```bash
|
|
sudo journalctl -u aitbc-miner -f
|
|
sudo journalctl -u aitbc-miner-dashboard -f
|
|
```
|
|
|
|
## GPU Requirements
|
|
|
|
- NVIDIA GPU with CUDA support
|
|
- nvidia-smi utility installed
|
|
- GPU memory: 4GB+ recommended
|
|
- CUDA drivers up to date
|
|
|
|
## Troubleshooting
|
|
|
|
### Dashboard Not Loading
|
|
```bash
|
|
# Check service status
|
|
sudo systemctl status aitbc-miner-dashboard
|
|
|
|
# Check logs
|
|
sudo journalctl -u aitbc-miner-dashboard -n 50
|
|
```
|
|
|
|
### GPU Not Detected
|
|
```bash
|
|
# Verify nvidia-smi
|
|
nvidia-smi
|
|
|
|
# Check GPU permissions
|
|
ls -l /dev/nvidia*
|
|
```
|
|
|
|
### No Mining Jobs
|
|
```bash
|
|
# Check miner service
|
|
sudo systemctl status aitbc-miner
|
|
|
|
# Restart if needed
|
|
sudo systemctl restart aitbc-miner
|
|
```
|
|
|
|
## Configuration
|
|
|
|
### GPU Monitoring
|
|
The dashboard automatically detects NVIDIA GPUs using nvidia-smi.
|
|
|
|
### Mining Performance
|
|
Adjust mining parameters in `miner_service.py`:
|
|
- Job frequency
|
|
- Processing duration
|
|
- Success rates
|
|
|
|
### Dashboard Port
|
|
Change port in `dashboard_server.py` (default: 8080).
|
|
|
|
## Security
|
|
|
|
- Dashboard runs on localhost by default
|
|
- No external database required
|
|
- Minimal dependencies
|
|
- Read-only GPU monitoring
|
|
|
|
## Development
|
|
|
|
### Extend Services
|
|
Add new mining services in the `get_services()` method.
|
|
|
|
### Customize UI
|
|
Modify `index.html` to change the dashboard appearance.
|
|
|
|
### Add Metrics
|
|
Extend the API with new endpoints for additional metrics.
|
|
|
|
## License
|
|
|
|
AITBC Project - Internal Use Only
|