Skip to content

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

  • 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

  1. Check network connection: Ping, traceroute
  2. Review services: Critical process status
  3. Restart services: Controlled restart
  4. Complete reboot: If necessary

High CPU/Memory Usage

  1. Identify processes: Top resource consumers
  2. Load analysis: Usage patterns
  3. Optimization: Adjust configurations
  4. Scaling: Add resources or distribute load

Disconnected Devices

  1. Check physical connectivity: Cables, ports
  2. Communication test: Ping, telnet
  3. Review configuration: Connection parameters
  4. 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