Viewing the history of a configuration

Show history to understand and explore the relationships between and properties for streams and baselines of a component. History results show all configurations of a component. You can show history from a component or a configuration; if you show history from a configuration, it is preselected in the history results.

About this task

Viewing the history of a configuration or component can help teams to see when a new stream or baseline was derived from a configuration, and to view the state of a configuration when the derive occurred. Find configurations in specific past states by using the segmented buttons in the toolbar to expand events, and then searching for events (date, user name, event) by pressing Ctrl+F.

For example, you open the history for a component called Car, which was the first product offering. Other cars were derived from Car, such as SuperCar, LuxuryCar, EconomyCar, and SportsCar. Each of these cars has streams and baselines, and many past states, too. The history graph is dense, and all you need to find is a baseline of Car, created by Pete on February 20, 2016. You can expand all configurations and events, and then search (Ctrl+F) the page for Pete or Feb 20, 2016.

Procedure

  1. Select a configuration in the tree view or a component on the Browse Components page and then click the Show History icon at the top of the page.
    Tip: To expand or collapse nested configurations in the tree, click the configuration above it and click Expand All or Collapse All.
  2. Examine the history.

    The graph initially shows all configurations contracted. Double-click any configuration to expand it and then click Expand Events to view the events. The following images show how to expand all configurations or all configurations and events.

    The graph shows the initial baseline in the first column. It then shows the evolution of the selected configuration or component. You can see the history of state changes (such as adding or removing configurations, tags, and attributes) and derivation changes (such as creating baselines, baseline staging streams, and streams).

    The following image explains how to read the history.

    Shows the history for an Automated Meter Reader configuration

    The following legend explains the purpose of icons used on the History page.

    Plus sign icon Shows that a configuration was added. A replace operation is shown as separate add and remove operations.

    Minus sign icon Shows that a configuration was removed. A replace operation is shown as separate add and remove operations.

    Arrows icon Shows that a configuration was reordered. A reorder operation might cause other configurations to shift position in the tree view because the change impacts the order in which configurations are sorted. Read about sort order in Unexpected local configuration in Current Configuration menu.

    Stream and clock icon Shows that this is a past state of a stream.

    Baseline and clock icon Shows that this is a past state of a baseline.

  3. Act on configurations in the graph by using the toolbar at the top of the History page.

    Shows the history toolbar at the top of the History page

    • Show different states (Current and Past States or Current States) of configurations in the graph by setting the Show list box. Alternatively, set the number of recent configurations to show in the graph.
    • Type any part of a title to filter the results of the graph. For example, for a title of Automated Meter Reader-v1 to be displayed, you can type v1 to filter the results of the graph. To remove the entry, click the small x at the end of the field.
    • Collapse and expand configurations or configurations and events by using the segmented buttons.
    • Show or hide an overview map of the graph by clicking the Show/Hide Overview Map icon. Drag the highlighted square to quickly explore parts of the graph.
    • Select two configurations to compare and then click the Compare Selected icon to open the comparison in the Compare Configurations page.
    • Additionally, you can remove the current column or a column to the right of the selected column by selecting the menu icon at the top of each column.

    When finished with the history graph, open a configuration in the tree view by clicking Menu and then selecting View Configuration. You can also use the browser back button to return to the tree view.

  4. Continue exploring configurations by expanding and collapsing events and past states, filtering by title, and comparing configurations.

video icon Video

Jazz.net channel
Software Education channel

learn icon Courses

IoT Academy
Skills Gateway

ask icon Community

Jazz.net
Jazz.net forums
Jazz.net library

support icon Support

IBM Support Community
Deployment wiki