This area of the application gives access to monitor all projects in the system, view all configured data source (and their statuses), manage permissions for other users, monitor visitors of the application. Entry point into this section in the application is the "Global Administration" item in top right navigation menu.
Projects per Data Sources
This section shows configured projects per types of supported data sources - Jira, Sonar, Git, Jenkins, Gerrit, Report Portal. Data source of every type is represented in a separate grid, with paging and sorting.
Not only Admins can view this section - but also all staff associated with appropriate projects.
PERF displays following attributes in each grid:
- Project name / sub-project name
- Last update - a timestamp per UTC of last data import
- Action icon to launch a data load for a specific data source per a specific project (NOTE: only if permissions allow)
- A status of last execution - can be "ok", "error" or "in progress"
- Update time - in seconds, a duration of last data load
- Result - a textual summary of data entries loaded within last launch
- Source - a url to an instance of a tool from where data had been loaded
Visitors
This view is available only for users with Administrator permissions.
You can select in the drop-down Show statistics per: Project or Visitor.
Visitors per Project
This view displays all projects available in the system, with ability to filter them by state in Perf (Active, or Inactive, or All).
Information provided in this grid:
- Project name (or key)
- Action icon to launch all associated data loads for this project, for example if there are multiple data sources configured for it.
- E-mails of contact persons who are responsible for appropriate project.
- Date of setup - a creation date of that project in Perf application.
- Last visit and Last visitor - who and when accessed this project in Perf application.
- Monthly views - a total amount of user visits into this project during last month (-30 days from a current date).
- State - indication if a project is currently Active or Inactive. Inactive means all data loads for such project are disabled and excluded from a regular daily launch.
Additional action button "Get e-mails" generates a full list with emails of people registered in Perf as responsible for particular projects. This can be useful while broadcasting some important information or news to that audience.
Visitors per Visitor
Information provided in this grid:This view displays all users who had even visited the application.
- Name - a user's e-mail
- Last visit - a timestamp (in UTC) of a last view of a project
- Total visits - a total count of application visits by that user
- Projects - a comma-separated list of projects which a user had ever accessed.
Additional action button "Download CSV" generates a CSV file with a row data about each user, visit, project, and so on. This is helpful while analyzing total users activity in the application via Excel e.g. filters, Pivots.
Users and Permissions
This view is available only for users with Administrator permissions.
Every entry is the combination of the following attributes:
- User name (e-mail)
- An indication if a user is Admin
- Project name
- Level of permissions (Project member, Manager or Guest)
Administrator can remove a user by click on a trash bin icon 
next to his name.
Administrator is able to reset a user password by click on a arrow icon 
next to his name.
Reset of permissions is the ONLY place in the application when Administrator can view a user's password. So, it's Administrator's responsibility to communicate passwords to users. If a password is lost or not communicated timely - the only way to restore it is to ask Administrator to reset a new password.
If a user is checked as "Administrator", then a selection of project name and permissions level is not needed and thus hidden.
An action button "Add user" creates a new entry where information about a new user and their permissions should be entered, see a picture below.
Permissions may be granted to access only specific nodes. Click the "Restrictions" button to select nodes that must be available for the user:
User can be added to several projects with different or same role (see the picture below). The user will be able to access any of the projects with the latest given password: supposing user is given access to the project A on Sep 8 and then he's added to the project B on Sep 9, password to both projects is that got when the user added to the project B.
General Settings
General settings is available only for users with Administrator permissions.
Application properties
In this section you can configure general properties of the whole application. PERF will save global parameters in the database, and will be able to use them instead of parameters from config files. PERF will also they will preserve these values between application upgrades.
License key - mandatory - license key for this instance of PERF
Support Email - mandatory - email used to contact a support team for asking a technical team in case of issues with this instance of PERF
Logo URL - optional - path to a customer logo
Logo background - optional - a hexadecimal color specified with: #RRGGBB
Training webinar URL - optional - link to training for PERF usage. If it's given a banner is shown encouraging to join training:
Checkbox "Allow Google Analytics" - optional - when checked you allow to get some info out of using PERF
Checkbox "Enable data load on schedule" - optional- by default it is checked. Data load starts at the time specified in Project Settings→Advanced Settings→Data load initiation (UTC hours)
LDAP URL - optional - a host (with a port) of an LDAP directory
Manager Dn - optional - username (DN) of a "manager" user identity to authenticate an LDAP server. If it's empty anonymous access is used
Manager password - optional - a password for a manager DN. It is required if a Manager DN is specified
User Dn Pattern - optional - used for a bind authentication, e.g. uid={0},ou=people. It works well if all users are stored in the single node of a directory
User search base - optional - used for a bind authentication, e.g. ou=people, to search under a specific DN
User search filter - optional - used for a bind authentication, e.g. (uid={0}), to filter search results under a specific DN
Group search base - optional - used for loading authorities, e.g. ou=groups. It defines a part of the directory tree to perform a group search
Group search filter - optional - used for loading authorities. This filter is used to search for a group membership. The default item is uniqueMember={0}, corresponding to a groupOfUniqueNames LDAP class.
Default credentials
Additional section is available to configure default credentials for PERF Data Sources. This is helpful when some "Technical" user can be created, e.g. for a JIRA instance, so that all further projects in PERF about it would not require login/password to be provided. PERF Administrators can manage the catalog of default credentials.
As soon as an URL is registered here, no need to enter username and password while configuring new data sources in PERF linked to that URL. Just ignore the Login and Password fields on the form, and proceed with other settings.
