Skip to main content

Device Actions

Use Device Actions to manage a single device from the Devices table.
You open these actions from the ellipsis ( … ) button in the device row.

This page explains:

  • Restart Client
  • Download / View Logs
  • Change License
  • Remove Device

Before you start​

  • The device should be Connected for most actions. (See Connectivity & Sessions.)
  • Some actions may briefly interrupt monitoring or sessions.
info

If the device is Offline, only limited actions are available (for example, removing the device).
If the device is Online but not yet Connected, Cordatus will try to connect automatically.
If the automatic connection fails, connect the device manually before running actions.

Restart/Shutdown OS​

Use Power actions to restart or shut down the operating system of a connected device.
Unlike Restart Client, these actions affect the entire operating system — not just the Cordatus Client.

Before you start

  • The device must be Connected.
  • Active SSH or Remote Desktop sessions will be terminated when the device restarts or powers off.
  • After a reboot, the device typically transitions Connected → Offline → Online automatically.
  • After a shutdown, the device remains Offline until manually powered on.

Steps

  1. Go to Devices → find your device.
  2. In the Actions column, click the Metrics icon.
  3. In the top-right control bar, choose one of the following:
    • Restart — Restarts the entire operating system.
    • Shutdown — Powers off the device safely.
  4. Confirm the action in the dialog.

Results

  • During reboot, you may briefly see the status change sequence Connected → Offline → Online.
  • During shutdown, the device remains Offline until it is powered on.

Restart and Shutdown

Restart / Shutdown OS

 

caution

Performing a shutdown or reboot will terminate active sessions and may interrupt running workloads.
Be sure to save any important data before proceeding.

Restart Client​

Restarting the Cordatus Client refreshes its services and connection on the device. It does not reboot the operating system.

Steps

  1. Go to Devices → find your device.
  2. In the Actions column, click the ellipsis ( … ).
  3. Click Restart Cordatus.
  4. Confirm in the dialog.

Results

  • Client stops and starts again.
  • Status may show Connected → Online → Connected during the restart (a few seconds).
  • Monitoring and remote sessions resume after the client is back.

Restart Client

Restart Cordatus Client

tip

Use a client restart when metrics freeze, the SSH/Remote Desktop will not start, or after changing license/settings.

Logs (Download or Live View)​

You can download log files for support or view live logs in your browser during troubleshooting.

Download Logs​

  1. Go to Devices → find your device.
  2. In the Actions column, click the ellipsis ( … ).
  3. Click Download Logs.

Download Logs

Download Logs

View Live Logs​

  • Shows real-time log lines in the browser (tail).
  • Useful when you want to reproduce and observe a problem.

Steps

  1. Go to the Logs page.
  2. In the Select Device menu, choose your device.
  3. In the Log Scope menu, select the type: Client Logs or Stream Engine Logs.
    This will show the live logs for your device.
  4. Use the filters to narrow results: Topic, Sub Topic, or Log Type.
  5. Use the Show Logs drop-down to set how many logs appear at once.
  6. (Optional) Use Start Date and End Date to filter by a specific time range.

 

info

Log contents may include technical details (timestamps, process IDs).
Credentials are never stored in plaintext by Cordatus.

Logs in the Client (on-device)​

You can also access logs directly from the Cordatus Client installed on the device.
This is useful if the device cannot connect to the cloud, or if you are working locally.

Steps

  1. Open the Cordatus Client on the device.
  2. Go to Settings → Logs tab.
  3. Select Client Logs or Stream Engine Logs.
  4. Scroll through log entries.

Client Logs

Logs in the Client

info

Client-side logs show the same categories (Client, Metrics, Sessions, Stream Engine).
They are local and do not depend on cloud connectivity.

note

When requesting support, make sure to include the renderer.log file for a thorough examination of the issue.

Enabling / Disabling Logs​

You can control whether the Client Logs and Stream Engine Logs are collected and stored.
This is useful to reduce disk usage or stop unnecessary logging in production.

There are two ways to manage these settings:

1. From the Web (Device Hub)​

  1. Go to Devices → select your device.
  2. Open the Metrics Panel (click the metrics icon in the device row).
  3. Go to Settings → General Settings.
  4. Toggle:
    • Enable Client Logs
    • Enable Stream Engine Logs

Toggle Logs

Enable / Disable Logs on Web

2. From the Cordatus Client (on-device)​

  1. On the device, open the Cordatus Client.
  2. Click the settings icon in the bottom-left corner.
  3. In the General tab, toggle:
    • Enable Client Logs
    • Enable Stream Engine Logs

Toggle Logs

Enable / Disable Logs on Client

caution

If logging is disabled, some diagnostic data may not be available for support or troubleshooting.
Enable logs when investigating issues, and disable them again to save resources if needed.

Change License​

Use this to move a device to a different plan or to apply an expired/renewed license.

Steps

  1. Devices → device row → ellipsis ( … ) → Change License.
  2. Select an available license.
  3. Click Change License.
  4. Wait for confirmation.

What happens next

  • The client validates the new license with Cordatus.
  • Some features may enable/disable based on the new license.
  • The client may restart automatically.

Remove Device​

Removes the device from your Cordatus account.
You can choose what to do with the data associated with this device.

Steps

  1. Devices → device row → ellipsis ( … ) → Remove.
  2. In the dialog, choose whether the Stream and Inference Engines should keep running after removal: select Continue Without Closing, or choose Close and Continue.
  3. On the next page, if you also want to remove data with the device, toggle Remove Device with Cordatus data, select the data types to remove, then click Continue.
  4. Type DELETE in the confirmation box and click Delete.

Results and notes

  • The device disappears from Devices.
  • If the same physical machine reconnects later, it appears as a new device.
  • Deleted data cannot be recovered.
caution

This action cannot be undone.
Be sure to export any needed logs or reports before removal.

Troubleshooting​

  • Logs are empty
    • Check Monitoring → Check Device Metrics is ON (for metrics-related logs).
  • License change did not apply
    • Retry after a Restart Client. Confirm there is network access.
  • Remove failed
    • Try again after the device is Disconnected, or contact your admin.