This documentation relates to an earlier version of FishEye.
View this page in the current documentation or visit the current documentation home.

Skip to end of metadata
Go to start of metadata

The changelog is a record of the commits, reviews and issues for a repository, branch, directory or file. You can view the recent activity in the changelog when browsing a repository/branch/directory or viewing a file. This information is displayed in an "activity stream" on the relevant screen.

On this page:

Viewing the Changelog Activity

To view the changelog activity for a repository/branch/directory or file,

  1. Browse to the desired repository/branch/directory or view the desired file.
  2. (optional) Select the branch or tag of the repository that you want to view information for, using the branch/tag selector (non-ClearCase repositories only). Only information related to the selected branch/tag will be displayed, when browsing your repositories.
    • Click the tab for the default branch (e.g. 'trunk') to view only information related to it. The default branch (e.g. 'trunk') is determined by FishEye.
    • Click the icon and enter the desired branch/tag, to view information related to the branch/tag.
    • Click the 'All' tab to view information related to all branches/tags.
      Screenshot: Branch/Tag selector
  3. Click the 'Activity' tab. The recent changelog activity of your repository/branch/directory or file will be displayed.
  4. Use the following functions in the 'Activity' tab to filter/show and navigate through the changelog activity:
    • All tab — Click to show commits, reviews¹ and JIRA issues² activity in the activity stream. This is the default view.
    • Commits tab — Click to show only commits in the activity stream.
    • Reviews¹ tab — Click to show only review activity in the activity stream. This tab will not be displayed unless you have integrated FishEye with Crucible¹.
    • Issues² tab — Click to show only issue activity in the activity stream. This tab will not be displayed unless you have integrated FishEye with JIRA².
      This tab is currently only enabled when viewing a repository, due to technical constraints.
    • Filter commits (see below) — See Filtering Commit Activity for the Changelog for more information.
    • Show Revisions — Click to expand every changeset in the activity stream to show all modified files related to the changesets. Click this button again to collapse the changesets.
    • Scroll to Changeset — Enter a changeset ID (e.g. 107856) and press Enter on your keyboard to scroll to the relevant changeset in the activity stream.
      ¹ Requires Crucible
      ² Requires JIRA

Screenshot: Viewing the changelog activity for a file

Filtering Commit Activity for the Changelog

You can filter the commits that are displayed in the activity stream, i.e. Commits in the 'All' and 'Commits' sub-tabs under the 'Activity' tab.

Note, you cannot use the commits filter to filter reviews or issues displayed in the activity stream. If you apply a commits filter to your activity stream, the following will occur:

  • The 'Issues' tab will be disabled.
  • The 'Reviews' tab will be enabled, but the commits filter will be disabled if you view the reviews activity (i.e. reviews will not be filtered).

To filter commit activity,

  1. View the 'Activity' tab for the desired repository/branch/directory or file.
  2. Click either the 'All' or 'Commits' sub-tab. The relevant activity will be displayed.
    (info) The 'Filter commits' button will be disabled on the 'Reviews' and 'Issues' tabs.
  3. Click the 'Filter commits' button. The filter fields will be displayed.
  4. Enter your criteria for the commits to be displayed:
    • 'Committer' — Shows only changesets checked in by the given committer/author.
    • 'Log Comment' — Shows only changesets where the commit comment matches the given text.
    • 'File Extension' — Shows only changesets that contain files with the specified file extension.
    • 'File Name' — Shows only changesets that contain a given file.
    • 'Start Date' — Shows only changesets created on or after that date. Must be of the form YYYY-MM-DDTHH:mm:ss, YYYY-MM-DD, YYYY-MM or YYYY (you can use '/' instead of '-').
    • 'End Date' — Shows only changesets created on or before that date. Must be of the form YYYY-MM-DDTHH:mm:ss, YYYY-MM-DD, YYYY-MM or YYYY (you can use '/' instead of '-').
  5. Click the 'Apply' button to apply the filter to the activity displayed.
    • If you want to clear the filter, click the 'Clear' link. This link will only display when the filter is active.
      You can also click the 'Filter commits' button again. The filter fields will be hidden and the filter removed.

Screenshot: Using the Filter

Watching the Changelog Activity

You can "watch" a changelog's activity stream in FishEye/Crucible. Watching the activity stream allows you to receive emails when updates occur in the activity stream. You can view all of your watches and configure the frequency of your watch emails in your user profile. See Changing your User Profile for more information.

Note, the option to add a watch will only be available if the administrator has enabled watches for the repository.

To watch an activity stream,

  1. Navigate to the activity stream that you want to watch.
  2. Click the 'Tools' menu and click 'Watch'. The page will reload and a watch will be set up for the activity stream (the watch icon will be coloured, not grey).
    • If you want to remove the watch, navigate the activity stream, click the 'Tools' menu and click 'Watch'. The watch will be removed (the watch icon will be coloured, not grey).
      (info) You can also remove watches via your user profile.