---
title: "Viewing a Log File - icom Data Suite"
slug: "viewing-a-log-file-en"
updated: 2024-10-01T15:36:33Z
published: 2024-10-01T15:36:33Z
canonical: "docs.insys-icom.com/viewing-a-log-file-en"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.insys-icom.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Viewing a Log File - icom Data Suite

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. Refer to the Configuration Guide [Registering and Sending a Value to the Cumulocity Cloud](/kb/docs/en/cumulocity-cloud-registering-and-sending-a-value-en) to see how to register a router in the Cumulocity Cloud. 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`
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>]`
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`
10. Click on *Execute* to output the grep options.

> [!NOTE]
> Please note!
> 
> The first command outputs the last ten lines of each log file. The second 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>]`. The third command outputs the options of the filter tool **grep**. 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.