Skip to main content

Device Management

Function Overview​

Device management is the core device monitoring and management module of the IO-AI Data Platform, providing full lifecycle management capabilities for robot devices. Through the Agent client program, the platform can monitor device operating status and resource usage in real-time, access video streams for remote visual monitoring, and provide remote takeover functions to help administrators, project managers, and collectors efficiently manage distributed devices, ensuring stable operation of devices and smooth progress of data collection tasks.

Applicable Roles and Scenarios​

  • Administrators: Centrally monitor the operational health of all devices, remotely takeover and enforce security policies.
  • Project Managers: Master device resources within the project, coordinate collection tasks and track data quality.
  • Collectors: Monitor the status and screen of assigned devices in real-time, quickly provide feedback on abnormalities.

Main Functions​

Device Registration and Detection​

Device Registration​

Support registering new robot devices on the platform, including basic information such as device unique number, remark description, robot and project association. After device registration, the system will generate a unique Agent ID for the device, used for subsequent Agent installation and identity recognition.

Registration Process:

  1. Click the "Robot Device Registration" button to open the registration dialog
  2. Fill in the device unique number (required field, used to identify the device)
  3. Fill in remark description (optional, used to record device purpose, location, etc.)
  4. Select affiliated robot (optional, associate the device with a specific robot)
  5. Select project (optional, assign the device to a specific project)
  6. Click "Register Device" to complete registration

After successful registration, the device will appear in the device list and can proceed with subsequent Agent installation and monitoring operations.

Device Detection​

The system automatically detects the online status and Agent installation status of registered devices. For devices without Agent installation, the system will display "Not Installed" status and provide installation guidance. For devices with Agent installed, the system will display device online status, last reporting time and other information in real-time. For devices that have not reported for a long time, the system will mark them as offline.

Detection Mechanism:

  • The system automatically checks device status every 5 minutes
  • Judge device online status through Agent reporting information
  • Display last inspection time for easy understanding of device status update
  • Mark as offline status for devices that have not reported for a long time

Agent Client Installation​

Automatic Operating System Detection​

The Agent installation program supports automatic detection of the target device's operating system type and architecture, including:

  • macOS: Supports both Intel and Apple Silicon (ARM64) architectures
  • Linux: Supports both X64 and ARM64 architectures
  • Windows: Supports X64 architecture

The system will automatically select the corresponding Agent executable file based on the detected operating system to ensure simple and efficient installation process.

Command Line Installation​

Provide one-click command line installation method, applicable to Linux and macOS systems. The installation command will automatically set necessary environment variables, including:

  • EMBODIFLOW_AGENT_ID: Device's unique Agent ID
  • EMBODIFLOW_SERVER_URL: Platform server address
  • EMBODIFLOW_INTERVAL: Data reporting interval (default 300 seconds, i.e., 5 minutes)

Installation Steps:

  1. In the device management page, select the device that needs to install Agent
  2. Click the "Install Agent" button to open the installation dialog
  3. Copy the installation command to execute in the target device terminal
  4. The system will automatically detect the operating system and complete installation
  5. After installation, Agent will automatically start and begin reporting device information

Executable File Download​

For scenarios requiring manual installation, the system provides executable files for each platform download:

  • macOS (Intel)
  • macOS (Apple Silicon)
  • Linux (X64)
  • Linux (ARM64)
  • Windows (X64)

After download, users can directly run the corresponding executable file on the target device to complete Agent installation.

Installation Status Monitoring​

The system monitors Agent installation status in real-time, including:

  • Not Installed: Device has not installed Agent, displays installation guidance
  • Installed: Agent has been installed and is running, displays last reporting time
  • Offline: Agent has been installed but has not reported for a long time, possibly device offline or Agent abnormal

For devices in not installed or offline status, the system will provide corresponding operation suggestions and fault troubleshooting guidance.

Device List Management​

Device List Display​

The device management page provides a complete device list, supporting:

  • Multi-project filtering: Filter devices by project, supporting "All Projects" and specific projects
  • Search function: Quickly search devices by device name
  • Status filtering: Filter by online status, Agent installation status, etc.
  • Bulk operations: Support selecting multiple devices for batch operations

Device Information Display​

The device list displays detailed information for each device:

  • Device Name: Device's unique identification name
  • Affiliated Project: Project associated with the device (displays "-" if not associated)
  • System Information: Operating system type and hardware information
  • Device IP: Device's network IP address (supports multiple IPs)
  • CPU Usage: Real-time CPU usage and progress bar
  • Memory Usage: Real-time memory usage and progress bar
  • Online Time: Device's last online time (such as 5 minutes ago, 1 day ago)

Bulk Operations​

Support batch operations on multiple devices:

  • Batch Delete: Delete selected devices (requires confirmation)
  • Batch Issue Collection Tasks: Assign collection tasks to selected devices in batches
  • Batch Install Agent: Install Agent for multiple devices in batches

Device Details Page​

Detailed Information Display​

Click the device name to enter the device details page and view the device's complete information:

Real-time Monitoring Card:

  • CPU usage and temperature
  • Memory usage
  • Disk usage
  • Network connection status

Resource Trend Chart:

  • Support switching between "Resource Trends" and "Temperature and Load" views
  • View historical data for 4 hours, 1 day, 7 days
  • Multi-indicator comparative analysis

System Information:

  • Complete system configuration information
  • Device running time
  • Network configuration information

Operation Function Area​

The device details page provides convenient operation functions:

  • Edit Device Information: Modify device name, remarks and other information
  • Install Agent: Install or reinstall Agent for the device
  • Remote Control: Execute operations such as restart, SSH, configuration management
  • Video Monitoring: View device's real-time video stream

Resource Monitoring​

Real-time Resource Monitoring​

The Agent client regularly collects the device's system resource usage, automatically reporting once every 5 minutes, including:

CPU Monitoring:

  • CPU usage rate (percentage)
  • CPU temperature (Celsius)
  • CPU core number and usage
  • CPU load trend

Memory Monitoring:

  • Memory usage rate (percentage)
  • Used memory (GB)
  • Total memory capacity
  • Memory usage trend

Disk Monitoring:

  • Disk usage rate (percentage)
  • Used disk space (GB)
  • Available disk space (GB)
  • Disk read/write speed

Network Monitoring:

  • Number of active TCP connections
  • Network traffic statistics
  • Network interface status

Resource Trend Analysis​

The system provides resource usage trend charts, supporting viewing data of different time ranges:

  • 4 hours: View resource usage trends in the past 4 hours
  • 1 day: View resource usage in the past day
  • 7 days: View resource usage trends in the past week

Trend charts display CPU, memory, disk usage rate changes in line chart format, helping users:

  • Identify resource usage peaks and valleys
  • Discover abnormal resource usage patterns
  • Predict resource requirements and plan in advance
  • Optimize device configuration and resource allocation

System Information Display​

The system automatically collects and displays the device's detailed system information, including:

  • Operating System: Operating system type and version (such as: linux (ubuntu))
  • Hostname: Device hostname (such as: orangepi5plus)
  • Kernel Version: System kernel version information
  • Running Time: Device continuous running time (such as: 49 days 5 hours)
  • Device IP: Device's network IP address (supports multiple IP display)

This information helps administrators quickly understand the device's basic configuration and running status.

Video Stream Access and Monitoring​

Video Stream Access​

The Agent client supports pushing the device's video stream to the platform, enabling remote visual monitoring. Through video stream access, administrators and project managers can:

  • View robot device's camera perspective in real-time
  • Monitor device running environment and status
  • Remotely observe data collection process
  • Discover device abnormalities in time

Video Stream Characteristics:

  • Support simultaneous access of multiple video streams
  • Low-latency real-time transmission
  • Adaptive bitrate adjustment
  • Automatic reconnection on disconnection

Video Monitoring Interface​

The platform provides a professional video monitoring interface, including:

  • Real-time Player: Display device's real-time video stream, support full-screen playback
  • Connection Status: Display video stream connection status (Connected/Not Connected)
  • Refresh Function: Support manual refresh of video stream connection
  • Playback Control: Support play, pause, volume control and other basic operations

When the device is not connected to the video service, the system will display a prompt message and provide a refresh button to reconnect.

Video Stream Management​

The system supports unified management of video streams:

  • View video stream status of all devices
  • Batch enable/disable video streams
  • Configure video stream parameters (resolution, frame rate, bitrate, etc.)
  • View video stream historical records

Remote Takeover Function​

Remote Control Operations​

The platform provides various remote control functions to help administrators remotely manage devices:

Device Restart:

  • Support remote restart of devices without physical contact
  • Perform security checks before restart to prevent misoperations
  • Automatically restore Agent connection and monitoring after restart

SSH Connection:

  • Provide SSH remote login function
  • Support direct SSH connection to devices through the platform
  • Convenient for advanced configuration and fault troubleshooting

Configuration Management:

  • Remotely view and modify device configuration
  • Support upload and download of configuration files
  • Configuration change history records

Remote Takeover Scenarios​

The remote takeover function is particularly useful in the following scenarios:

  • Device Fault Handling: When the device has abnormalities, remote restart or diagnosis can be performed
  • Configuration Update: Update device configuration remotely without on-site operation
  • Data Collection Monitoring: Monitor collection process in real-time through video stream to ensure data quality
  • Device Maintenance: Execute maintenance operations remotely to improve maintenance efficiency

Operation Permission Control​

The remote takeover function follows strict permission control:

  • Only administrators, project managers, and collectors can use remote takeover functions
  • Different roles have different operation permissions
  • All remote operations will be recorded in operation logs
  • Support operation approval process (optional)

Applicable Roles​

Administrators​

Responsible for global device asset management: uniformly register devices, monitor running health, audit remote operations, and take remote takeover or fault troubleshooting when abnormalities occur, ensuring overall platform stability.

Project Managers​

Focus on device resource scheduling within the project: view device resources by project dimension, coordinate collection task assignment, track resource usage trends, and confirm collection quality in combination with video streams, ensuring project progress.

Collectors​

Directly face field execution: monitor the status and screen of assigned devices in real-time, timely feedback abnormalities, and apply for remote assistance when needed (such as restart or configuration update), ensuring smooth completion of collection tasks.