View event logs

2 minute readAutomation

The Event log entries page displays a log of events generated anywhere in the system, including jobs and workflows.

To access the Event log entries page, navigate to Administration  Configurations  Event log.

  • To see only events for a single workflow, select the Workflows tab and then a workflow name to navigate to the Workflow Details page and select the View Log link at the top of the page.

  • To see only events for a single job, select the Jobs tab, the Job name to go to the Job details page, and then select View Log at the top of the page. For more information, refer to Procedure run details.

When running a job in a cluster, the name of the server managing the job is recorded in the job log. If the management of the job moves to a different node (if the current node crashes, for example) the change is logged into the job log as well.
  • To see only events for a specific object, you can search and filter.

    For example, you may want to select the object type, "Log Entry", and then select Add Intrinsic Filter. Select the down-arrow where you see "Container" auto-populated and select "Container Type". Use the equals operator, and then select the next down-arrow to choose an object. Select OK to start the search.

  • From the Administration tab, the default view for the Event Log page is the warning (WARN) level.

  • For workflow and job event logs, the default view from their respective pages is the information (INFO) level.

Column descriptions

  • Time: This is the time the event was logged.

  • Severity: Can be either INFO, WARN, or ERROR. Use the pull-down menu at the top of the table to change between these views.

  • User: The user associated with the event—the user of the session at the time the event was generated. Clicking on a project link in this column takes you to the Project Details page for that project.

  • Container: Typically, this is the type and name of the workflow or job with a corresponding ID. Clicking on a link in this column takes you to the Job Details page for that job or workflow.

  • Subject: The object associated with the message. Clicking on a link in this column takes to you the source for this object.

  • Message: The message text will either be informational or display the warning or error message. The message may contain important information about a resource or workspace issue.

Configure the event log

Since log entries can accumulate in large numbers, you can configure the event log for auto-deletion. By default, Event log retain time is 30 days. The CloudBees CD/RO server automatically marks old log entries for deletion and the background deleter cleans out old log entries along with its other tasks.

To change the default settings:

  1. Navigate to Administration  Server settings  System Settings and modify the following fields:

    • Event log retain time: Default is 30 days (in "minute" units).

      Setting the "retain" period to "0" disables the automatic deletion mechanism, allowing you to use an external cleanup script to implement a custom cleanup policy.
    • Maximum background delete delay: Default is 3600 seconds (or one hour).

  2. Select OK to save your changes.