System monitoring is one of the key features of Remote Manager support in Digi Embedded Yocto. It is enabled by default and allows you to remotely monitor some interfaces and system parameters that determine device health. Remote Manager represents these parameters in dynamic graphics. You can also retrieve their values using the Remote Manager web services.
System monitoring is configured to take a sample of each monitored parameter and interface every 30 seconds and store the data temporarily in the device. When there are two stored samples of each monitored parameter, the module uploads all the samples. That is, the device uploads samples every 60 seconds.
This default behavior can be modified via the Cloud Connector configuration file at /etc/cc.conf
:
-
Open a serial connection to the serial port to which the device is connected. Use the following settings:
-
Port: Serial port to which your device is attached
-
Baud rate: 115200
-
Data Bits: 8
-
Parity: None
-
Stop Bits: 1
-
Flow control: None
-
-
Power on the device.
-
Edit Cloud Connector configuration file
/etc/cc.conf
, and modify the System Monitor settings. You can:-
Enable/disable System Monitor service (setting
enable_system_monitor
). -
Change the Sample rate (setting
system_monitor_sample_rate
) at which the samples are captured. -
Increase or decrease the Number of samples to collect before uploading (setting
system_monitor_upload_samples_size
). -
Configure the list of metrics and interfaces to monitor (setting
system_monitor_metrics
).System monitor configuration#=============================================================================== # Cloud Connector System Monitor Settings #=============================================================================== # Enable System Monitor: Set it to 'true' to let Cloud Connector to gather # system information periodically and send it to Device Cloud via Data Points. # Enable Data Service option must be set to 'true'. # Enabled by default. enable_system_monitor = true # System monitor sample rate: Determines the frequency at which the service # gathers system information to store it in the samples buffer (in seconds). # By default, 5 seconds. system_monitor_sample_rate = 30 # System monitor upload samples size: Determines the number of samples of each # channel that must be stored in the buffer before performing an upload # operation. # By default, 10 samples. system_monitor_upload_samples_size = 2 # System monitor metrics: Specifies the list of individual metrics and # interfaces that will be measured and uploaded to Remote Manager. # Available individual metrics are: # - "free_memory" # - "used_memory" # - "cpu_load" # - "cpu_temperature" # - "frequency" # - "uptime" # Available network interfaces may vary for each platform; the most common ones # are: # - "ethX" # - "wlanX" # - "canX" # - "hciX" # - ... # Where "X" represents the interface index of that network type. # For every network interface, three metrics are measured and uploaded: # - "<iface>/state" # - "<iface>/rx_bytes" # - "<iface>/tx_bytes" # Metrics must be separated by commas. # Wildcards can be used for network metrics ("wlan*", "can*", "eth*/state", etc.). # The default value is set to "*", which means "all available metrics". system_monitor_metrics = { "*" }
-
-
Execute the
cloud-connector
application:# cloud-connector
If the module is disconnected from Remote Manager, it stores the samples locally and uploads them next time it connects to Remote Manager.
Analyze the samples from Remote Manager
You can view the recording of data (in charts and in text format) from Remote Manager. To do so:
-
Log in to your Remote Manager account (https://remotemanager.digi.com).
-
Go to the Data Streams tab.
-
Select the parameter you want to analyze from the list of streams.
-
On the right, select the format to represent the values (Tabular, Line Chart, Area Chart, etc.).
See Remote ConnectCore Cloud Services demo for an example using Remote Manager APIs. For extended Remote Manager usage and reference information, see the Digi Remote Manager User Guide. |