View the change history

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

Figure 1. Application process with unsuccessful run
Component or component process in an application process that did not run successfully

Figure 2. Component or component process with unsuccessful run
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 .
  
  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 .
    
    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

Open the home page of the Automation Platform web UI by browsing to https://<cloudbees-flow-server>/commander/.
Go to the Artifacts tab.
Choose an artifact.
Click the Track Changes button.

Figure 3. Track changes

The Change History for the selected artifact opens.

The default time increment is Past 60 Minutes.

Figure 4. Time increment

Jobs

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

To go to the Job Details page, do one of the following:
- Use the Jobs tab.
- Use the Jobs Quick View list.
If you use the Jobs tab, follow these steps:
1. Click the Jobs tab.
  
  The Jobs page opens.
  
  Figure 5. Jobs page
2. Click a job name to select a job.
  
  The Job Details page opens.
  
  Figure 6. Job Details page
If you use the Jobs Quick View list, click a job name to select a job.

The Job Details page opens.
Choose a job or job step.
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:

Go to the Projects tab.
Choose a project.
Click the Track Changes button.

The Change History for the project opens.

Figure 7. Change history

Workflows

Starting from the Home page:

Go to the Workflows tab.
Choose a workflow.
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:

Figure 8. Change history page

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:

Figure 9. Change history page for the job

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:
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.
9	Click the View button to see more details about the object.

Timeline

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.

Figure 10. Timeline with default range

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.

Figure 11. Timeline for past 60 minutes

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

Figure 12. Timeline for past 7 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.

Figure 13. Select range for change history

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.

Figure 14. Change history since last successful 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.

Figure 15. Manually move the start and end times

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

Figure 16. Specify the time range

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

Select Between.

A dropdown opens.

Figure 17. Custom start time and date
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.
Click OK.

A dropdown opens at the other end of the timeline.

Figure 18. Custom end time and date
Select the time and date for the end of the timeline.

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

Figure 19. Time and date for end of timeline
Click OK.

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

Figure 20. Custom change history

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.

Figure 21. Number of changes

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

Figure 22. Change 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.

Figure 23. View path

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

Figure 24. View path before and after change

Detailed Object Changes

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

Figure 25. View change in property

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.

Figure 26. Custom changes

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.

Figure 27. Filter users

Click the down arrow to see the other users.

Figure 28. View additional users