Module Log

The Module Log tab provides insight into the logs generated by the selected module. The available logging features depend on the module’s implementation and capabilities.

If the module is built using the Nexus Device SDK, it supports structured historical logging as well as real-time log streaming from the device to the platform. For modules that do not use the SDK, basic console output may still be available.

The tab is divided into two views:

  • Historical Log Displays a paginated list of structured log entries collected from the module. This view is available only for modules that support the Nexus SDK, and allows filtering, searching, and expanding log entries for full detail.

  • Console Log Streams real-time standard output and error messages from the module container, if supported by the device runtime. This view provides basic runtime visibility even for non-SDK modules.

💡 When SDK-based logging is available, the platform enables advanced features such as log-level filtering, grouping, and live updates.

Historical Log

The Historical Log view displays a structured, paginated list of recent log messages emitted by the selected module. Each entry includes metadata to support efficient filtering, sorting, and analysis.

Columns:

  1. Timestamp The exact time the log entry was generated, useful for correlating events across modules and devices.

  2. Level The severity of the message, such as:

    • Information

    • Warning

    • Error

    • Debug

    • Verbose

💡 Log verbosity is configurable via the Module Log Level Setting dropdown.

  1. Message A short summary of the log event (e.g., JobEnded, DeviceConnectionStateChanged, Synchronizing Cold Path Measurements).

➕ Clicking the plus icon to the left of a log entry expands the row to show full log details, such as structured data or stack traces (if provided).

Tool Bar

"Live Stream Log" Toggle When enabled, new log messages are pushed into the view in real time without requiring manual refresh.

"Refresh" Button Reloads the log list to show the most recent entries based on current filter settings.

Search Field Allows filtering logs by message content.

Console Log

The Console Log view provides a real-time stream of unstructured text output from the module’s standard output (stdout) and standard error (stderr) streams. This view is useful for live debugging or observing the raw behavior of the module as it runs.

Unlike the Historical Log, which shows structured, indexed entries (available only for Nexus SDK-enabled modules), the Console Log presents raw line-based output similar to traditional terminal logs.

Features and Controls

  • Scroll to Bottom When enabled, the log view automatically scrolls to show the most recent messages, ensuring you’re always seeing the latest output.

  • Auto Refresh Automatically maintains the connection and updates the stream, even if new content is arriving rapidly.

  • Refresh Button Manually reloads the log output from the current module container.

Last updated

Was this helpful?