Main reports page

To run a report

1. In the BMC Helix Discovery UI, go to Explore > Reports.
   The available reports are listed under various categories.
   
   
   
   
2. Hover your mouse over a report name to read more about what it does, and then click the report you want to run. For example, click Host Endpoints with Session Issues.
   A list of endpoints that fulfil the report criteria are displayed. 
3. To refine the report listing, click Customize.
   
   
   
   The default columns available in the report are listed in the Columns Displayed section. Three tabs are displayed, Customize Columns, Query Constructor, and Raw Query. For information on using the tabs, see Query-Builder and Customizing-list-views. 
4. Choose the data you want to report on by specifying the parameter fields.
   • The search is not case-sensitive.
   • Where a drop-down list is provided, you can select a specific value or where available you can choose All to match all values.
   • For dates, you can choose a day and month from drop-down lists and enter a year (in yyyy format). You can also specify a time (hours and minutes).
5. Click Refine Results.
   The results are summarized in the form of a list object page. For information about list object pages and the charting and filtering tools available, see Viewing-summary-list-pages.

Report results

• The returned list displays selected attributes and relationships of each object. Click an item in the list to access the View Object page which displays all of an object's relationships and attributes.
• From the Actions list, you can export a report in CSV format.

To run reports on nodes

Where reports list nodes, each node has a check box next to it. You can select and deselect individual or multiple nodes using these check boxes. The Select All option selects all nodes on all pages of the report.

To use chart reports

There are a number of functions available when viewing chart reports.

To view details of a chart

When viewing a chart, you can drill down into any part of that chart to see the details for that particular section. For example, the Host Vendor Distribution report.

1. From the pie chart view you can change the chart type. To do this, select the chart type from the list below the chart. The available chart types are:
   • Pie Chart
   • Bar Chart
   • Column Chart
2. Choose the data slice, or bar if you are viewing a bar chart, that you want to view in detail and click that area of the chart to view the details for that area.
   From the details view you can choose to view specific information from the list of available data.

To rotate a pie chart

When viewing a pie chart, you can rotate the angle of the pie chart and the annotations for each data slice.

1. Go to Explore > Reports and select a pie chart.
2. With the mouse pointer positioned anywhere on the data slices of the chart, hold down the left-click and drag your mouse pointer clockwise or anti-clockwise. Release the mouse pointer to display the chart in the required position.

To view a list from a chart

When viewing a pie, bar, or column chart, you can click any of the colored data slices or bars to convert that information into a regular report with multiple columns. You can also use the Customize option in the UI, as explained earlier, and generate customized reports.

To download report usage analysis

You can download information containing details on report usage in your environment. The information enables you to view and analyze which reports have been run and how often. This function can help you to identify the most and least valuable reports used in your network over time.

1. Go to the Administration page and in the Appliance section, click Appliance Support.
2. In the Miscellaneous section, select the Reports Usage check box.
3. Specify a Name for your usage report, such as April Reports.
   You can also add a Description to elaborate the report details.
4. Click *Gather*.
   You can select the check box corresponding to any gathered data file and delete that file by clicking Delete. You can also see a read-only summary of each file by clicking View in the Summary column.

5. To download the report, click the corresponding link in the Name column.
   The output for this example is as follows:

   Report Counter
   Name,Counter
   DataCentreStand.Reports.HostByVendorDist,2
   DataCentreStand.Reports.UnixDist,1
   Databases.Reports.MySQL,2
   Databases.Reports.SQLServer,1
   Resiliency.Report.WindowsServicePackDist,1
   
   Context Report Counter
   Name,Counter
   Host__Observed Communicating Hosts,2
   
   Chart Counter
   Name,Counter
   DataCentreStand.Reports.HostByVendorPie,25
   DataCentreStand.Reports.SoftwareByCategoryPie,4

The report is divided into three areas:

• Report Counter
• Context Report Counter
• Chart Counter
  For each one there is a unique ID. You can download the report as a text file.