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:

  1. Open a serial connection with the device. You can use any serial terminal program such as Tera Term, Minicom, CoolTerm, or HyperTerminal.

    PuTTY terminal program is not recommended due to an incompatibility with the USB/serial driver.

    Open a serial connection with the following settings:

    Parameter Value

    Port

    Serial port where the device is connected

    Baud rate

    115200

    Data bits

    8

    Parity

    None

    Stop bits

    1

    Flow control

    None

  2. Power on the device.

  3. Stop Cloud Connector:

    # systemctl stop cloud-connector.service
  4. 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 Remote Manager 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 = { "*" }
  5. Relaunch Cloud Connector:

    # systemctl start cloud-connector.service

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:

  1. Log in to your Remote Manager account (https://remotemanager.digi.com).

  2. Go to the Insights > Data Streams tab.

  3. Select the parameter you want to analyze from the list of streams.

  4. On the right, select the format to represent the values (Tabular, Line Chart, Area Chart, etc.).

See Step 5 - Manage your device remotely for an example using Remote Manager APIs.

For extended Remote Manager usage and reference information, see the Digi Remote Manager User Guide.