View the change history

6 minute readData analyticsAutomation

You can open and view the change history from the following objects in CloudBees CD/RO:

  • Applications List and Microservices List

  • Application Editor and Microservice Editor

  • Application Process Designer and Microservices Process Designer

  • Artifacts

  • Components

  • Component Process Designer

  • Environments Designer

  • Environment Tier

  • Jobs

  • Process Steps (Application, Microservice, and Component)

  • Projects

  • Resources

  • Workflows

View the Change History from the Applications List

You may want to view the Change History for these objects in an application:

  • An application process that did not run successfully

  • Component or component process in an application process that did not run successfully

    application list unsuccessful
  • Resource that was not deployed successfully

    1. Open the home page of the CloudBees CD/RO web UI by browsing to https://<cloudbees-flow-server>/flow/.

    2. Go to the applications list in one of these ways:

      • Click Applications.

      • Click the Main menu button in the upper left corner and then select Applications.

    3. Choose an application.

    4. Click the View button view running process.

      A list of the application processes for the application appear.

    5. To view the Change History of an application process:

      1. Choose a process.

      2. Click the Change History button change history search icon.

        The Change History for the application process opens.

    6. To view the change history for an object in the application process,

      1. Click the View Details button.

        A list of objects in the application process (components and component processes) appears, and the breadcrumb changes to Applications/View Run .

      2. Choose an object.

      3. Click the Change History button to see the change history for the object.

Viewing the Change History for Artifacts, Jobs, Projects, and Workflows

When troubleshooting why a job failed, you can view the Change History for artifacts, jobs, projects, and workflows in the automation platform.

Artifacts

  1. Open the home page of the Automation Platform web UI by browsing to https://<cloudbees-flow-server>/commander/.

  2. Go to the Artifacts tab.

  3. Choose an artifact.

  4. Click the Track Changes button.

    change history artifact

    The Change History for the selected artifact opens.

    The default time increment is Past 60 Minutes.

    time increment default

Jobs

Starting from the Home page (https://<cloudbees-flow-server>/commander/):

  1. To go to the Job Details page, do one of the following:

    • Use the Jobs tab.

    • Use the Jobs Quick View list.

  2. If you use the Jobs tab, follow these steps:

    1. Click the Jobs tab.

      The Jobs page opens.

    2. Click a job name to select a job.

      The Job Details page opens.

      job details page
  3. If you use the Jobs Quick View list, click a job name to select a job.

    The Job Details page opens.

  4. Choose a job or job step.

  5. Click Track Changes for the job or job step.

    The Change History for the job or job step opens.

    The default time increment is Past 60 Minutes.

Projects

Starting from the Home page:

  1. Go to the Projects tab.

  2. Choose a project.

  3. Click the Track Changes button.

    The Change History for the project opens.

    project change history

Workflows

Starting from the Home page:

  1. Go to the Workflows tab.

  2. Choose a workflow.

  3. Click Track Changes.

    The Change History for the workflow opens.

Change History Page

How to get here : Click the Search button to open the "Change History—Search" form, and enter the search criteria.

The search results appear in the Change History page and include the following information:

change history ui

How to get here :

From the Home page in the Automation Platform (https://<cloudbees-flow-server>/commander/), use one of the following methods to open and view the change history for jobs, projects, workflows, and artifacts:

  • Select a job that failed > Click the job name to go to the Job Details page > Click Track Changes in the upper right of the page

  • Click the Jobs tab > Select a job that failed to the Job Details page > Click Track Changes in the upper right of the page.

The search results appear in the Change History page for the job and include the following information:

change history comm ui

1

Time range.

The end time is the current time. You can change the end time after you run the search and get the search results.

2

Name of the tracked object.

3

Path to the tracked object.

Example:

change history path to app

4

After making a change, you can revert or export the object.Click this to go to the undo or redo the last action on the page.

5

Click this to run a new change history search.

6

Time line.

The start time is based on the time range that you selected.

The end time is the current time.

You can manually change the start and end times after you run the search and get the search results.

7

Filters for the change history.

You can view all changes or view only selected changes.

The objects in the list are the objects in the change history search results.

8

Change history for the selected object.

  • When—The date and time that the object changed.

  • What—The type of object.

  • Name—The name of the object.

  • By—The "user" that changed the object, which can be a project or a user.

  • Change—The type of change.

  • Path–Click the View Path button to see the path to the object.

change history view path

9

Click the View button to see more details about the object.

Time Line

The timeline for the change history is at the top of the Change History page.

The timeline is automatically separated into divisions based on the number of minutes, hours, or days between the end time and the start time.

Default Settings

These are the default settings for the timeline:

  • The start time is the selected time range in the upper left of the page.

  • The end time is Most Recent when the latest change to the object occurred.

  • The default range is from the Last Successful Run to the Most Recent.

  • The entire timeline is displayed, and all the changes are in the list below the timeline.

The timeline on this page has the default range.

The Last Successful Run range is available only after the first time that you run an application.
timeline auto determine

When the range is changed to Past 60 Minutes, the timeline changes:

  • The start time is 60 minutes from Now.

  • The end time is when the Most Recent change occurred ( Now ).

  • The timeline has four divisions.

timeline past sixty minutes

If the increment is Past 7 Days, the timeline has seven one-day divisions.

timeline past seven days

You can view the change history in different ways depending on the time range for the timeline.

Selecting the Time Range

You can view the change history in different ways depending on the time range for the timeline.

Click the down arrow next to the time range to select a different range for the change history.

change history time range

You can see the change history since the last successful run. Notice that the information on the left side shows a summary of the changes, which is a subset of the results that you got.

change history last run

Moving the Start and End Times

You can manually move the start and end times on the timeline.

When you move the start time to 18:00 and the end time to 6:00, notice that the list of objects in the change history changes.

timeline manually start end

When you move the start time to 18:00 and the end time to 6:00, notice that the list of objects in the change history changes.

Specifying the Time Range

custom time increment

To manually set the times and dates for the start and end times:

  1. Select Between.

    A drop down dialog box opens.

    custom time date time
  2. Select the time and date for the start of the timeline.

    The default settings are 3:30 pm and eight days before the current date.

  3. Click OK.

    A drop down dialog box opens at the other end of the timeline.

    custom time end
  4. Select the time and date for the end of the timeline.

    The defaults are 3:30 pm and the current date.

    timeline default date time
  5. Click OK.

    The timeline changes to show only the changes from the start and end times and dates that you selected.

    timeline update start end

Number of Changes

The time range at the top of the change history shows the number of changes.

  • There have been 233 changes in the last 24 hours.

  • There have been 213 changes in the last 12 hours.

  • There have been 20 changes in the last 6 hours.

When you change the time range, the number of changes also changes. In the last 60 minutes, there have been only two changes.

number changes time increment

Paths to Objects

Click the View Path button next to the "Change History for JPetStore" title to see the path to the application.

change history path to app

Click the View Path button to see the change in the path to the object before and after the change.

change history view path

Detailed Object Changes

Click the View button to see the change in the property called jobcounter.

change history view change

Filters

You can use filters to view changes to specific objects, the types of changes, and the users how made those changes.

Instead of selecting View All Changes, you can select specific objects, such as only properties, processes, property sheets, process steps, and process dependencies that have been modified by the Project:Default and Admin users.

change history view some

When the list of filter criteria is long, not criteria may appear in the filter list. To see all criteria, use the up or down arrows to see all the options.

This list does not show users. Use the up and down arrows to see all four of the users.

Click the down arrow to see the other users.

filter users scroll