View event logs

2 minute readAutomation

The Event log entries page displays a log of events generated anywhere in the system.

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

  • To see only events for a single job, navigate to DevOps essentials  Procedure runs, select a link under Run instance to go to the Job details page, and then select the View Log icon in the Log column. 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 node managing a job changes, for example, the current node crashes and another node assumes control of the jobs it managed, the change is logged into the job log.
  • To see only events for a specific object, you can search and filter.

    For example, to see events for the "Log Entry" object type, do the following:

    1. Select the object type, "Log Entry", and then select Add Intrinsic Filter.

    2. Select the down-arrow where you see "Container" auto-populated and select "Container Type".

    3. Use the equals operator, and then select the next down-arrow to choose an object.

    4. Select OK to start the search.

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

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

  • By default, job events logs are filtered by Severity level INFO.

Column descriptions

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

  • Severity: The available filters are INFO, WARN, or ERROR. Use the Severity pull-down menu at the top of the table to change between these filters.

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

  • Container: This displays the Job type, name, and ID. Selecting a link in this column takes you to the Job Details page for the job.

  • Subject: The object associated with the message. Selecting a link in this column takes you to 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 flags outdated log entries for deletion, and the background deleter removes flagged log entries.

To change the default event log retention policy:

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

    • Event log retain time: Default is 43200 minutes (30 days).

      1. From the Server settings menu, navigate to System Settings, and locate the field.

      2. Enter retain time.

        Setting the Event log retain time to 0 disables logs from being automatically deleted. This configuration is typically used with external cleanup scripting to implement custom log retention policies.
    • Maximum background delete delay: Default is 3600 seconds (one hour).

      1. From the Server settings menu, navigate to Scheduler settings, and locate the field.

      2. Enter the delay time.

  2. Select OK to save your changes.