Viewing all devices

To view all devices connected to your account, click All devices in the Devices menu in the navigator.

A detailed device list will be displayed.

Device list

Default columns

For each device, the device list shows the following information provided in columns:

Column Description
Status An icon representing the connection status. For details, see Connection monitoring.
Name Unique name of the device.
Model Model type of the device. Not always displayed, depends on browser width.
Serial Number Serial number of the device. Not always displayed, depends on browser width.
Group Group the device is assigned to, if any.
Registration Date Date when the device was registered to your account.
System ID System ID of the device.
IMEI IMEI of the device.
Alarms The alarm status of the device, showing number and type of alarms currently unresolved for the device. Only includes alarms for the parent device. See Working with alarms for further information on working with alarms.

For users with global roles the devices list displays the items in a paginated manner. You can select the number of items per page and directly jump to any page. Users with inventory roles see up to 50 items initially. If there are more than 50 devices available more devices are loaded as you scroll down the list.

Configuring columns

The columns shown in the device list may be configured to your needs.

To show/hide standard columns

  1. In the table header, click Configure columns.
  2. In the resulting dropdown, select/clear the checkboxes for all columns as required.

The device list will reflect your changes and only show the selected columns.

To add custom columns

Moreover, you can add custom columns to show additional device properties.

  1. In the Configure columns dropdown, click Add custom column.
    Configure columns
  2. In the Header field, enter a header for the new custom column.
  3. In the Fragment path field, enter the property of the device to be shown. Nested properties will be accepted. However, for nested properties its only possible to select Cumulocity IoT standard fragments like c8y_Mobile.mcc.
  4. Switch the Add another column after saving this one toggle to active to create another custom column right after saving the current one without leaving the dialog.
  5. Click Save.

The new column will be added and displayed in the device list.

Info
While standard columns can only be shown/hidden as required, custom columns may be deleted permanently.

To filter devices

The device list offers a filtering functionality to filter devices in the list for specific criteria.

Filtering is available on every column. Click the filter icon next to the name of the column you want to set a filter for.

Specify your filter options in the dropdown list.

Most columns represent text fields. You can filter these columns by simply entering an arbitrary text into the textbox as in the search field. Click + Add next to add another textbox if you want to filter for more than one term.

Apart from filtering for text there are several other options:

  • In case of date fields (for example Registration date), you specify a date range to filter for.
  • In the Status column you can filter for various criteria representing the send, push or maintenance status of the device.
  • In the Alarm column the filtering options you may select correspond to the alarm types (critical, major, minor, warning, no alarms).
  • For custom columns, select Only rows where value is defined to filter based on whether the fragment exists, or specify one or more filter terms the entry must match.

Finally, click Apply to carry out the filtering.

The devices list will now only display devices matching the filtering options.

Sorting is available on every column. Click the sort icon in the respective column header once to sort the entries in ascending order and twice to sort the entries in descending order. Click the sort icon once more to remove sorting for this column.

Click Clear filters in the table header if you want to clear all filters and view all devices.

Info
If you select to sort a text field, for example, device name, in ascending or descending order, keep in mind that the resulting alphabetical sorting is based on ASCII/UTF: A < B < … < Z < … < a < b … < z. Names starting with lower case letters will be sorted below all names with uppercase letters or vice versa.

To replace a device

The device list supports the replacement of a physical device with another by preserving the original device representation in the platform including all its generated data. A wizard guides you through this process. Access the wizard by hovering over the device you want to replace in the device list and click the Replace device button.

Info
Currently LWM2M devices are not supported and the Replace device button is not available for this type of devices.

In the Replacement device step you can see the list of devices available in the platform excluding the device which you are going to replace. Select a replacement device from the list.

Info
In order for a particular replacement device to show up in the list, you must register it through the corresponding registration process for this device.

The Select external IDs step lists the external IDs assigned to the replacement device. Select those you want assigned to the device representation of the replaced device. You must select at least one external ID. This links the data which your new physical devices sends to the original device representation object.

Before proceeding with the actual replacement, you must confirm this action. Click Replace in the Replace device dialog.

Important
The replacement process removes the replacement device from the Cumulocity IoT database including all the data generated for it so far.

The Replace step displays the progress of the replacement process and the result of every step executed.

Replace device

If a step has been skipped you will find an icon with a tooltip which contains the reason why the step has been skipped.

If the execution of a given step has failed, you can see the error details by expanding the step details. Note that an error in one of the steps will not prevent the next steps from being executed. The wizard will try to execute as many steps as possible and provide information about failed steps. If you are able to resolve the reason for the failure(s), you can retry all failed steps by clicking the Retry button in the bottom bar. If you wish to retry a single failed step you can only do so by clicking the Retry this step button form the step actions dropdown.

The Close button brings you back the the updated device list. The replacement device will have been removed from Cumulocity IoT while all data sent by the new physical device will be linked to the platform representation of the original device. This ensures that the physical replacement remains transparent to users.

In order to keep track of the replacements done for a given device an event and an audit log are created for every replacement.

To delete a device from the list

  1. Hover over the row of the device you want to delete.
  2. Click the delete icon at the right of the row.
  3. Confirm the device removal. Optionally, select whether to delete child devices of the device or to delete the associated device owner. Note that it is not possible to select both options.

The device will be permanently deleted from the platform.

Important
Deleting a device means to remove the device from the Cumulocity IoT database including all its generated data. Alternatively, you can arrange all retired devices in one group, see Grouping devices). This ensures that all reports remain correct. To prevent alarms from being raised for the retired devices, disable connection monitoring. Deleting a device does not delete the data of its child devices.