Controller - System and Monitoring
What is the Controller?
The Controller is Rosepetal's central monitoring and control module that manages device communication, monitors system status, and provides access to diagnostic and configuration tools.
Controller Access
From the Dashboard
- "Controller" card in the main panel
- Visible status: Online/Offline in real-time
- Visual indicator: Green/red color based on availability
System States
🟢 Controller Online
- Operating system: Normal operation
- Active communication: Connection established with devices
- Available services: All functionalities accessible
- Real-time monitoring: Updated metrics
🔴 Controller Offline
- Inaccessible system: No communication
- Error screen: Informative image and retry button
- Limited functionality: Only historical data reading
- Diagnostics: Tools to identify problems
Controller Modules
📊 Information
System Dashboard
- General view: Consolidated status of all components
- Main metrics: CPU, memory, storage
- Active alerts: Problem notifications
- Real-time graphs: Historical performance
Metrics
- System performance: CPU, RAM, disk
- Network metrics: Bandwidth, latency
- Application statistics: Requests, errors, response times
- AI metrics: Inference time, precision, throughput
Logs
- System logs: Operating system events
- Application logs: Rosepetal application events
- Error logs: Failure and exception records
- Audit logs: User action records
Hardware
- Processor information: Model, speed, cores
- Memory: Total RAM, available, swap
- Storage: Disks, partitions, free space
- GPU: Graphics cards, VRAM memory, temperature
- Sensors: Temperature, fans, voltages
NATS (Messaging System)
- Broker status: Active connections, messages
- Subscribed topics: Active communication channels
- Throughput: Messages per second
- Latency: System response time
🛠️ Tools
Terminal
- Command line: Direct system access
- Administrative commands: For diagnostics and configuration
- Custom scripts: Task automation
- History: Record of executed commands
File Manager
- File explorer: Navigate the file system
- Dataset management: Physical location of images
- Logs and configuration: Access to system files
- Backup and restore: Backup management
Database Tools
- Firebase connection: Database status
- SQL queries: For data analysis
- Data backup: Export information
- Cleanup: Database maintenance
⚙️ Configuration
System Settings
- Network configuration: IP, ports, proxy
- Security configuration: Firewalls, certificates
- Environment variables: Application configuration
- System services: Automatic startup, dependencies
Device Configuration
- Connected cameras: List and configuration
- Sensors: Input/output configuration
- PLCs and controllers: Industrial communication
- Network interfaces: Ethernet, WiFi, serial
AI/ML Settings
- GPU configuration: CUDA usage, memory
- Available models: Location and status
- Processing pipelines: Flow configuration
- Performance tuning: Specific optimizations
Real-Time Monitoring
📊 Main Dashboard
Key Metrics
- CPU Usage: Processor usage percentage
- Memory Usage: RAM used vs available
- Disk Usage: Storage space
- Network I/O: Incoming/outgoing network traffic
- GPU Utilization: Graphics card usage
Alerts and Notifications
- Configurable thresholds: For each metric
- Automatic notifications: Email, SMS, webhook
- Escalation: Critical alerts to administrators
- History: Record of past alerts
📈 Historical Charts
Long-term Trends
- Resource usage: Last 24h, week, month
- Performance: Evolution of key metrics
- Patterns: Identification of cycles and trends
- Capacity planning: Prediction of future needs
Event Analysis
- Correlation: Relationship between metrics and events
- Root cause: Analysis of problem causes
- Performance impact: Effect of system changes
- Optimization opportunities: Improvement points
Device Management
📷 Cameras and Sensors
Camera Configuration
- Automatic detection: Search for connected devices
- Parameters: Resolution, FPS, exposure, gain
- Calibration: Lens and distortion adjustment
- ROI (Region of Interest): Specific analysis areas
Device Status
- Online/Offline: Connectivity of each device
- Health: Temperature, component status
- Statistics: Images captured, errors
- Maintenance: Cleaning or calibration alerts
🔌 Communication Interfaces
Supported Protocols
- HTTP/HTTPS: REST APIs for integration
- MQTT: Lightweight IoT communication
- Modbus TCP/RTU: Standard industrial protocols
- OPC-UA: Advanced industrial communication
- Serial RS232/485: Legacy devices
Connectivity Configuration
- Network parameters: IP, ports, timeouts
- Security: Certificates, authentication
- Retry logic: Disconnection handling
- Load balancing: Load distribution
Diagnostics and Troubleshooting
🔍 Diagnostic Tools
System Health Check
- Automatic test: Critical component verification
- Benchmarks: Performance tests
- Connectivity test: Connection verification
- Resource check: Resource availability
Log Analysis
- Pattern detection: Error pattern search
- Log aggregation: Multiple source consolidation
- Filtering: By severity, component, time
- Export: Log download for external analysis
⚠️ Common Problems
Controller Not Responding
- Check network connection: Ping, traceroute
- Review services: Critical process status
- Restart services: Controlled restart
- Complete reboot: If necessary
High CPU/Memory Usage
- Identify processes: Top resource consumers
- Load analysis: Usage patterns
- Optimization: Adjust configurations
- Scaling: Add resources or distribute load
Disconnected Devices
- Check physical connectivity: Cables, ports
- Communication test: Ping, telnet
- Review configuration: Connection parameters
- Driver updates: Update controllers
Maintenance and Optimization
🔄 Preventive Maintenance
Scheduled Tasks
- Log cleanup: Rotation and archiving
- Database maintenance: Optimization and indexes
- Automatic backup: Configuration and datasets
- Health checks: Scheduled verifications
Updates
- System updates: Security patches
- Software updates: New Rosepetal versions
- Driver updates: Device controllers
- Security patches: Vulnerability fixes
⚡ Performance Optimization
System Tuning
- Kernel parameters: OS optimization
- Network tuning: Network parameters
- I/O optimization: Disk configuration
- Memory management: Memory management
AI Optimization
- GPU optimization: CUDA configuration
- Model optimization: Quantization, pruning
- Batch processing: Efficient grouping
- Pipeline optimization: Task parallelization
Security and Access
🔒 Access Control
Access Levels
- Administrator: Full access to all functions
- Operator: Basic monitoring and control
- Viewer: Metrics read-only
- Guest: Very limited access
Authentication
- Secure login: Multi-factor authentication
- Sessions: Timeout and session control
- Audit trail: Action logging
- Roles: Granular permission assignment
🛡️ System Security
Protection
- Firewall: Traffic filtering
- SSL/TLS: Encrypted communication
- VPN: Secure remote access
- Intrusion detection: Intrusion detection
Compliance
- Data privacy: Personal data protection
- Industry standards: ISO 27001, NIST
- Audit logs: Compliance logging
- Data retention: Retention policies