Home

Welcome to the MetricsManager wiki!

What is it?

• It is necessary to know something about BAM so please read BAM wiki first.

• Metrics Manager or BAM Manager is a web user interface which is meant to simplify maintaining BAM, especially creating, editing, removing and refreshing bugzilla metrics.

• It is extension of BAM so you can use BAM without BAM Manager, but not vice versa.

How to use it?

1. Create new statistic

• In this tab you can create new statisics. Fill at least all nessessary fields. Move cursor over [?] to read some tips.
• It is possible to create also new list of products at the same time (press 'Create new list of products' link).
• It is also possible to create subset of existing statistics. Remember: Subset in BAM means subset of components. Bugzilla search is the same as in parent statistics.

Bugzilla search - like in BAM, you cannot just paste bugzilla search here.

Example: https://_link_to_bugzilla_/buglist.cgi?query_format=advanced&bug_severity=critical&bug_severity=major&bug_status=RESOLVED&component=comp1&resolution=FIXED&product=prod1&classification=class1

• Remove https://*bugzilla*/buglist.cgi?query_format=advanced
• Remove bug_status=RESOLVED
• Remove component=comp1&product=prod1 -> list products and components should be defined in 'list of products' config file
• Change bug_severity=critical&bug_severity=major to bug_severity=critical,major

=> correct bugzilla search for BAM is bug_severity=critical,major&classification=class1 in this case

Run methods:

• Run statistics now - create config files, add entry to cron and run statistics now! Results will be visible in few minutes.
• Wait for automatic run (time of automatic run defined in settings) - create config files, add entry to cron. Statistics will be run automatically the next day (as defined in cron)

2. Remove statistics

In this tab it is possible to remove statistics.

3. Lists of products

In this tab it is possible to remove, edit existing or create new list of products.

4. Common parameters

In this tab it is possible to edit common parameters for all statistics.

5. Refresh statistics

In this tab it is possible to refresh all or selected statistics. Refresh means delete today's data and fetch actual data again.

It is possible to refresh only selected statistics -> select at least one from the directory tree and press 'Refresh selected statistics'. If you'd like to refresh all, just press 'Refresh all' button

6. Settings

This tab is visible only if you are logged in as 'admin'. You can set/edit location of BAM scripts and edit crontab job.

7. Users

This tab is visible only if you are logged in as 'admin'. You can create/remove BAM Manager users here. It is not possible to remove/change password of Admin in this tab.

To change password, tap 'Change password' link in the right up corner.

Technologies used

• BAM Manager has been written mostly in php and Javascript, but some parts are done in Perl. Also few basic linux commands are used in the code.

Give your feedback and get involved!

We appreciate all contributions. Feel free to report issues, propose new features or submit your code :)

License

Use, reuse but don't abuse :p Licensed under the MIT license