This documentation relates to an earlier version of FishEye.
View

Unknown macro: {spacejump}

or visit the current documentation home.

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.

8 Comments

  1. Peter Friberg

    Mar 31, 2010

    At the screenshot on activity-tab, you see "All Activity | Commits | Reviews".

    My Fisheye 2.2.1 says "All Activity | Commits | Issues".

    Is the screenshot out-of-date, or is there a difference if you have Crucible disabled?

    I expected to see the Jira issues related to the commits. But now the screen only says "No activity found.".

    Does this tab only reference to Crucible reviews?

    1. Edwin Dawson [Atlassian Technical Writer]

      Apr 06, 2010

      Hi there Peter,

      Certain tabs and options only appear when you have Crucible or JIRA integration running.

      Best Regards,

      –
      Edwin Dawson
      Technical Writing Team Leader
      edawson@atlassian.com
      ATLASSIAN - http://www.atlassian.com

      1. John Mills

        Jul 20, 2010

        I have JIRA integration set up with FishEye and I can see and hover issue keys in the commit comments. However, the issues tab always says "not activity found". Like Peter, I assumed this would display the JIRA issues, but it doesn't seem to be working. What is the purpose of this tab? 

        1. Anonymous

          Sept 28, 2010

          I seem to be having the same problem: JIRA and Fisheye are fully linked to eachother (i can see the sources per issue in JIRA and can link to issues from the stream in fisheye etc) BUT the issues tab in the activity stream keeps showing: "No activity found."

          1. Anonymous

            Oct 25, 2010

            I'm also having the same issue.  JIRA v4.1.2#531 and FishEye Version:2.3.6 Build:20100824065214 2010-08-24.

            1. Andrew

              Oct 25, 2010

              Hi,

              Can I ask you to raise a request in the 'FishEye' project of our support system: http://support.atlassian.com ?

              Our support staff will respond to you promptly to help you sort out this issue.

              Kind Regards,
              Andrew

  2. Cesy

    Aug 26, 2010

    I get the changelog via email, but it only includes links to the diffs on the website. How can I get the full text of the diffs in my email?

  3. Anonymous

    Dec 19, 2011

    Hi,

     

    Right now in the Activity Tab I can see all changes made to each file during a certain time period. Is there a way to filter out only the start date and end date diffs. Meaning that if I can running 11-1-11 to 11-31-11 is there a way to see what was there on the 1st and then what was there on the 30th?

     

    Thank you!!!



Log a request with our support team.



Raise an issue for our developers.



See answers from the community.



Blog and update our documentation.

 Except where otherwise noted, content in this space is licensed under a Creative Commons Attribution 2.5 Australia License.