Create Batch Reports (via the Browser)

Note: Only system administrators can create a report.
  1. To create a batch report, go to the History Batch Reports page. There are report options to choose from when creating a report.
  2. Complete the required fields:
    Option Description
    Time Interval Specify the time interval of the report.
    Filters Select types of filters you wish applied to the report. Current tag, feature, host, user, project, and version filters are available. User groups will also show up as filters.
    User-Specific Batch Reports If this option is selected, a list of known user-specific scripts will be listed, and various input form elements will be hidden since they are no longer applicable. The directories $VOVDIR/etc/lm/reports and $VOVDIR/local/lm/reports will be searched for user scripts.
    Output Format Choose between outputting report to HTML or to CSV. If CSV is selected, only tabular report components will be available.
    Report Components
    • Feature Statistics (only tag/feature filters apply)
    • Efficiency Statistics (only tag/feature/project filters apply)
    • Efficiency Histogram (only tag/feature filters apply)
    • Sampling Plot (only tag/feature filters apply)
    • Checkout Statistics (all filters apply)
    • Checkout Pie Charts (count, duration) (all filters apply)
    • Denial Statistics (all filters except project/version apply)
    • Denial Pie Charts (all filters except project/version apply)
    • Heatmaps (checkout, checkin, denial) (all features apply)
    • Utilization Plot (all features apply)
    • Denials Plot (all filters except project/version apply)
    Table Row Limit Specify the max number of table rows to display for statistics report components.
    Features Options Specify whether to breakdown results by feature.
    Data Source Specify whether data comes from lmstats samples, from debug logs, or from both.
    Report File Options Specify whether report output should be placed into a single file, or whether it should be split up by tags and placed in multiple files (per tag).
    Report File Name Specify name of report output file.
  3. Click Create Reports.
    This redirects the input criteria to the CLI utility ftlm_batch_report in the form of a job, and the page will be redirected to a page that will display information similar to what is shown below:


    Figure 1. Example of reports

    This table contains all report jobs for the given time interval directory path, along with the size, the age, and the current status of the each report. Clicking the report name brings up the report contents. Clicking the report status displays the detailed batch report job page. The actions column provides a means of invalidating, executing, and deleting the report. If a report is new, it will be invalid (an empty stub) and will need to be executed. Each report will output either an HTML file or a CSV file.

An available reports tree listing will be shown when the directory path does not contain actual report files. In this case, visual information similar to the following will be displayed:


Figure 2. Example of reports

This shows that the directory 2023/ exist in the licmon.swd/html/reports directory, containing the Q3/m07/ subdirectories. The time intervals (directories) with links indicate that there are actual reports for these time intervals. The trash icons allow the user to delete all reports contained at that level and in all subdirectories.