Logs

In the zeuz control panel (ZCP), you can use the Logs page to filter, query, view, and export log entries generated from running payloads. The logs can help you understand the status of payloads.

Filter logs

  1. On the ZCP, click Logs on the left-hand panel.
  2. On the Logs page, you can use the following filters to display the log entries you’re interested in:

Image: Filter criteria for log entries on the Logs page of the ZCP.

The following table describes the filters available on the Logs page:

FilterDescription
Projects drop-down fieldSelect the environment for which you want to view payload logs.
Calendar date-picker
From date –> To date
Select the date range for which you want to view log entries. The To date defaults to today’s date; you can select an earlier date.
MIN SEVERITYSelect the minimum severity level of log messages that you want to view:
NOTE: All payload logs have a severity of ‘3-Info’.

Select one of the following values:
3- Info
4-Warn: Levels 4, 5, and 6 only contain warnings and errors from the payload runner.
5-Error
6-Fatal.

Logs for the selected severity and above are displayed. For example:
4-Warn returns all log entries with the following statuses:
4-Warn
5-Error
6-Fatal

NOTE: The following are not used currently:
0-Spam
1-Trace
2-Debug
Payload IDOptional.

Enter the payload ID for which you want to view logs.

If you don’t enter a payload ID, zeuz displays log entries for all payloads for the current environment. This may take longer to display due to a higher volume of records.
Elasticsearch simple query fieldOptional.

Enter an Elasticsearch simple query to find and display matching Log Entries.

zeuz applies the query criteria in addition to the other filters.

Click SYNTAX DOCS to view online help for Elasticsearch syntax.

Elasticsearch examples:

+test
Returns all Log entries containing the string test.

-test
Returns all Log entries that don’t contain the string test.

Changing any of the filter values instantly refreshes the list of Log Entries on the page.

View log entries

zeuz displays log entries that match your filter criteria in the Log Entries section. You can change the display order of log entries; click TIME to switch between ascending and descending date/time order.

NOTE
zeuz displays an error message in the MESSAGE line if a particular log entry is too large to display.

Image: Selection of logs entries based on the selected filter values.

View log details

You can view detailed information for a log entry; click on the log entry MESSAGE. The Log details panel appears to the right of the log entry and shows the following additional details:

Image: Log details panel for a selected log entry.

The Log details panel displays the following additional information for the selected log entry.

DetailDescription
ContainerThe ID of the container that is running the payload.
SubroutineThe name of the application component in the payload runner that generated the message.
Project IDThe ID of the project associated with the payload.
Environment IDThe ID of the environment associated with the project.
Allocation IDThe ID of the allocation that the payload is running in.
Payload IDThe ID of the payload that generated the log.
Machine IDThe ID of the machine that was running the payload.

Export log entries

You can export the list of Log Entries to a CSV file for later use, as follows:

  1. In the ZCP, click Logs on the left-hand panel.
  2. Enter your search criteria to display the log entries you’re interested in. See Filter logs for more information. zeuz displays log entries matching your filter criteria in the Log Entries section.
  3. Click EXPORT CSV. When the file is ready, the button label changes to DOWNLOAD CSV; click to download the CSV file to your machine.

The file contains all the details from the Log Entries plus the Log details for each entry.


2021-sep-24 Page added with editorial review.


Last edited on: October 15, 2021 (4db86fbb)