Logs

3 minute read Last updated on September 04, 2024

Dispatcher Stratus automatically logs actions involving workflows, devices, and users which can be used for analytics, reporting, and troubleshooting.

Log Viewer

Activity Log files are recorded every time a workflow’s, device’s, or user’s status changes.

To access the Log Viewer, click the Logs tab in the left-hand menu. The Log Viewer will look similar to the following illustration:

Log Viewer

Activity Logs

To view logs, do the following:

  1. Select a Log Section by using the drop-down menu. Options include:

    • Devices
    • Users
    • Workflows
  2. Select an individual option from the second drop-down menu. For example, if you selected “Workflows” from the first drop-down menu, the options presented in the second drop-down menu will be the available workflows.

  3. Select a date or date range to view the logs for. Options include:

    • Today
    • Yesterday
    • Last 7 Days
    • Last 30 Days
    • Custom

If you select Custom, you will then have the option of selecting a Start Date and End Date.

  1. You can further Customize your Log Viewer results by selecting an option from the Customize menu. These will filter the various logs by type, including:

    • Information
    • Warning
    • Error
    • Critical
    • Debug

Generated Logs

The individual logs are displayed on the right-hand side of the Logs page . Each log includes the following information:

Column Description
Date The exact date and time the event was logged
Type Which type of event Dispatcher Stratus logged: Information, Warning, Error, Critical, or Debug. Each type is shown as an icon.
Error Code The error code associated with the log. This column is hidden by default, but can be displayed by using the Refine filter options.
Details A short description of exactly what occurred within Dispatcher Stratus

Logs can also be refined by selecting the Refine icon (Refine). Tenant Admins can show or hide a column in the displayed logs by selecting or deselecting one of the options from the Refine drop-down menu.

Administrators can adjust the view of their Activity Logs in several ways. The default organization is in reverse chronological order, with the most recent event at the top. To change the order, do the following:

  1. Click the arrow next to the column you would like to sort by.

    Note: Columns are automatically sorted alphanumerically.

  2. To sort in reverse alphanumeric order, click the arrow again.

Logs can also be searched, using the Search Logs field in the upper-right corner.

Logs can be Exported by selecting the Export button at the top of the page. Note that this option is only available after Logs have been generated. Logs can be generated in the following formats:

  • CSV
  • TXT

Using Logs

Log information is vital for monitoring systems and troubleshooting issues that arise. A typical user will not need access to logs. However, in the event that something unexpected happens within the tenant, logs can be helpful for diagnosing the problem so it can be fixed. If a tenant admin cannot fix the issue, attaching the relevant logs can be helpful when submitting Customer Feedback.