Check out our new app to find attachments by file name, format, or uploader in Jira Cloud.

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Reverted from v. 111

...

Numbered Headings

How can I merge two users with different emails who in fact are one person?

Starting from Stash 2.5.0 you can use .mailmap file in the repository to do this. Please, note this affects only commits made after the mailmap file was added. Changing a global .mailmap file in Git won't help (see details here). Also, please see the documentation for e-mail management in Awesome Graphs.

Does Awesome Graphs support

Bitbucket Server

Stash Data Center?

Yes, if you're using the paid version of Awesome Graphs 2.1.0 or higher. See this page for details.

My

Bitbucket Server

Stash instance is used under a Community/OpenSource/Classroom license. Can I get Awesome Graphs for free?

Yes, in this case you can request a free Community/OpenSource/Classroom license for Awesome Graphs directly from Atlassian. To do that, please, follow this link.

Your free Awesome Graphs license is valid only if your organization is approved by Atlassian for a Community/OpenSource/Classroom license type. To learn more about Atlassian Community, OpenSource, Classroom licenses, see this page.

What time zone is used for displaying statistics?

Awesome Graphs uses the time zone set for the Bitbucket Server Stash instance (Bitbucket Server Stash doesn't support user time zones). If all commiters are located in the same time zone, you may want to set the time zone for Bitbucket ServerStash.

To do that, you need to:

  1. Set the -Duser.timezone parameter for JVM on the server where Bitbucket Server Stash is installed. For example, -Duser.timezone=Europe/Berlin. Read more about JVM parameters in the Atlassian JIRA documentation.
  2. Restart Bitbucket ServerStash.
  3. Make sure that the field Time Zone displays correct time in Administration - Atlassian Support Tools - System Information - Bitbucket Server Stash Information.

When does Awesome Graphs index repository data?

After Awesome Graphs is installed on Bitbucket Server Stash it starts indexing all repositories associated with it right away.

I have a instance of

Bitbucket Server

Stash with a lot of heavily branched repositories. Shall I install Awesome Graphs on it right away?

For large Bitbucket Server Stash instances it's highly recommended to try Awesome Graphs on a staging environment first. If it runs smoothly, install it on a production instance. If you run into problems, contact us.

Where does Awesome Graphs store indexed data?

Starting from version 2.0, the indexed data is stored in the Bitbucket Server Stash database. Storing persistent data helps to avoid reindexing each time the add-on is reinstalled or updated.

It takes too long to index my repository. What is the problem?

On large Bitbucket Server Stash instances Awesome Graphs may need some time to index all data. In this case we recommend running Awesome Graphs on staging environment first.

Awesome Graphs is indexing data and completely loads one CPU core. Is it normal?

Yes. On large Bitbucket Server Stash instances, Awesome Graphs can load one core completely. We recommend installing it on a server with at least a dual-core CPU for better performance.

Awesome Graphs crashes

Bitbucket Server

Stash. Why?

Most likely you don't have enough RAM to index all data in your repositories. This can happen on large Bitbucket Server Stash instances (with over 400 000 commits). Please, add more RAM for your JVM, we recommend installing at least 1.5 GB of RAM for a stable performance. If this doesn't help, please, contact us. Also, see #7 in this FAQ.

Are merge commits counted in the Contributors and Contributions graphs?

No. Only regular commits and pull requests are taken into account.

Why there's no link to Contributions from the Contributors graph?

The Contributors graph displays a link to Contribution only if a contributor is a Bitbucket Server Stash user and:

  • either their email is the same as in the Git settings,
  • or their Git username is the same as their Bitbucket Server Stash display name.

See #1 in this FAQ to learn how to merge different user names and emails for one person.

How do I install Awesome Graphs?

Log into your Bitbucket Server Stash as Administrator and install Awesome Graphs directly from Atlassian Marketplace or by file upload. To check whether Awesome Graphs is compatible with your Bitbucket Server Stash version, please, visit Atlassian Marketplace.

Once Awesome Graphs is installed, you'll see the Graphs tab on the left-side navigation bar on each repository page in Bitbucket ServerStash. Awesome Graphs works out of the box and doesn't require any configuration. Please, read the License Policy section to learn which features are free and which require purchasing a commercial license.

Which features are free and which ones are paid?

Awesome Graphs' functionality comprises free and paid features. The features of Basic Functionality are free. Branch Selection, Code Frequency, Contributions, Commit Graph, File Contributors, Managing User E-mails By Using Aliases In The User Profile Settings and Bitbucket Server Stash Data Center Support of Advanced Functionality are paid. Contributors of Advanced Functionality contains both free and paid features.

The free features are available immediately after installation. To use the paid features, you need to generate an evaluation license valid for 30 days. Once your evaluation license expires, Awesome Graphs' functionality will be restricted to free features, and you will need to purchase a commercial license in order to continue using the paid features.

Why choose Awesome Graphs over Commit Graph?

Commit Graph is a new addition to Awesome Graphs' pack. After a while it will have much richer functionality. However, within its initial release, Awesome Graphs' Commit Graph already has advantages over Commit Graph by Chason Choate. Below is the comparison of the two add-ons.

What's compared

Awesome Graphs by StiltSoft

Commit Graph by Chason Choate

Location of Commit Graph

Located in Commits tab, to the left of the Author column. It supplements the standard Author, Commit, Message, Commit Date, Issue columns,  which is illustrative, intuitive, informative and prevents excessive navigation.

Might be inconvenient and a bit confusing. It's located in a separate tab called Network. Network Tab contains the Author, Message, Commit Date columns; and lacks the Commit, Issues, Builds columns:

  • Author in Network Tab has only contributors' initials, while in Commits Tab it has contributors' avatars and full names;
  • Commit Date in Network Tab has the format different from the one in Commits Tab.
Limit of displayed commitsNo limit (infinite scroll).300 (can't view more than 300 commits).

Displaying all branches of a repository

Not yet, Commit Graph is newly added and has this feature coming. At the moment it's possible to switch branches using the Branch Selection Filter.

Available.

Tags and interaction 

You can click a point to highlight the ancestors of a certain changeset and see where it comes from.

Displays tags and provides some interaction with the graph.

Types of available graphs and other visualization

Commit Graph;

Contributors: Summary Graph, Personal Contribution Graphs (with filtering, grouping and time span options);

Interactive Commits Bar Chart, Interactive Commits Scatter Chart;

Punch Card;

Code Frequency Graph;

Contributor Calendar with Activity Stream (with time span options).

Commit Graph (the add-on provides only one graph).

Additional functionality

Branches Selection;

File Contributors;

Emails Management via using aliases in the user profile settings.

No additional functionality.
Bitbucket Server Stash Data Center compatibilityCompatible.Not compatible.
Pricing

Freemium. It has both free and paid functionality. Commit Graph is a part of Paid Features Pack, but it is free for first 50 commits.

Free.
Support

StiltSoft is Atlassian Verified. Verified add-on vendors demonstrate high quality, reliability, and business traction. Learn more

StiltSoft supports Awesome Graphs for Bitbucket ServerStash. You can visit the support site to get help.

Unsupported.
Info

If you have any feedback or requests concerning Commit Graph, please, let us know.

What should I do if I'm having problems with Awesome Graphs?

Contact us providing as much information about your problem as possible.