This Configuration Guide shows how to view a log remotely using the Command Shell in Cumulocity Cloud or Telekom Cloud of Things.

Situation

You want to have a look at the log files of the router from remote without having to access the web interface of the device. This can be achieved using the Command Shell.

Solution

It is prerequisite that you have a cloud service account.
The router must be registered in the cloud service. [1]
The version of the icom Data Suite must be 1.3 or later.

  1. Log in to your Cumulocity Cloud account.

  2. Click on Other applications () in the top right corner and select Device management.

  3. Click on All devices and select your router in the list of all devices.

  4. Click on Shell ()

  5. For viewing the complete log, go to the >_ Command field and enter:
    M3.status.log.view [2]

  6. Click on Execute to output the log.

  7. For viewing one or more specific logs, go to the >_ Command field and enter:
    M3.status.log.view[<log_name>] [3]

  8. Click on Execute to output the log(s).

  9. For viewing a log and applying a filter or special functions using grep, go to the >_ Command field and enter:
    M3.status.log.view=grep -h [4]

  10. Click on Execute to output the grep options.

The prefix M3. determines that the commands are sent to the router. The prefix IDS. would determine that the commands are sent to the icom Data Suite.
To show a log of the icom Data Suite, replace M3 by IDS in the example above.

Troubleshooting

  • The commands entered in the Command Shell are case-sensitive.


1. Refer to the Configuration Guide Registering and Sending a Value to the Cumulocity Cloud to see how to register a router in the Cumulocity Cloud
2. This command outputs the last ten lines of each log file.
3. This command outputs the last ten lines of the specified log(s); separate the log names using a comma, e.g. M3.status.log.view[<deviced,cli>].
4. This command outputs the options of the filter tool grep.