```
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 ```
This commit is contained in:
164
apps/miner-dashboard/README.md
Normal file
164
apps/miner-dashboard/README.md
Normal file
@@ -0,0 +1,164 @@
|
||||
# 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
|
||||
Reference in New Issue
Block a user