FAQ
General#
How to contact support?
Please ask for support on our web portal (support.Bitergia.com) or by email (support@bitergia.com).
See more information here
Identities#
How to add a new organization?
You can add a new organization via SortingHat.
See more information here
How to remove an organization?
You can remove an organization via SortingHat.
See more information here
How to assign an e-mail domain to an organization?
You can assign an e-mail domain to an organization via SortingHat.
See more information here
How to enroll a person to an organization during a time interval?
You can enroll profiles via SortingHat.
See more information here
How to prevent that affiliations removed from a contributor are restored?
You can do it via SortingHat.
See more information here
How to un-enroll a person from an organization?
You can un-enroll a person via SortingHat.
See more information here
How to correctly enroll a person to different organizations during consecutive time periods avoiding overlapping dates?
You need to understand how dates work.
See more information here
How to enroll a person to two organizations during the same time intervals?
Intervals should not overlap.
See more information here
How to mark an identity as a bot?
You can mark identities as bots via SortingHat.
See more information here
How long does it take to see the changes in SortingHat reflected in the dashboard?
The time depends on the amount of data available in the data source
See more information here
What is the organization JSON file?
The organization JSON file contains a list of organizations and their domains.
See more information here
Data sources management#
Dashboards#
How to properly save a new visualization or dashboard?
You have to mark Save as new visualization.
See more information here
How to edit a visualization?
You have to click on Edit, then the gear and then Edit visualization.
See more information here
How to edit the name of a visualization?
You have to edit the visualization.
See more information here
How to create a visualization?
You have to click on Edit and then on Create new.
See more information here
How to edit a dashboard?
You have to click on Edit to enter in edition mode.
See more information here
How to create a dashboard?
You have to go to Dashboard section and perform editions on edition mode.
See more information here
How to edit the quick ranges offered by the time filter?
You have to go to the left of the dashboards bar, next to the wise owl icon and
open the dropdown menu. Then, find the Dashboards Management section and select
the Advanced Settings option. Then, go to the Time filter quick ranges section
and edit them as needed. Remember to re-load the page after saving your changes.
Metrics#
Why are results sometimes inaccurate?
OpenSearch Dashboards' counts are approximated. It uses a cardinality aggregations algorithm to count data, which prioritize performace over accuracy. These cardinality algorithms are designed to handle big ammounts of data, offering results fast. For this reason, there's always an error associated to these counts. Usually, you will find these problems with unique counts (e.g. total count of commits).
You can learn more about this topic and the precision error in the cardinality aggregation section of the OpenSearch Dashboards' documentation.
User Management#
How to change my password?
When you are logged in, at the right end of the dashboard toolbar, next to the OpenSearch help icon, there's a letter in a circle signalling your user management options. Click on it and a menu will drop down.
The Reset password option lets you modify your password, provided you
know your current one.
SortingHat provides a similar procedure. For simplicity, we tend to provide the same credentials for both tools. Consider changing both to keep having only one password.
How to add/exclude other users to my dashboard?
If we already trust you (you are the contract signee or you were authorized by her), please ask for it in our web portal (support.Bitergia.com). If you are not, please ask her to ask us.
See more information here
We'll need the email address of each user to be added, so we can send them their credentials.
If the dashboard is private, we need to know if the requested access is read-only
or the user must be able to edit dashboards and save permalinks (write access).
By default, we don't grant access to SortingHat. If you want to grant a user access
to SortingHat we need you to specify if this access is read-only or write-enabled.