Reports

Data collected by Longitude is available for historical reports. Reports on performance metrics collected by Longitude are available in both graphic and tabular formats. Events displayed by Longitude can also be used to generate text reports. The length of time data is kept will vary by application, but performance data is generally kept longer than event data.

Performance Reports

Longitude reports are produced by the data collected from monitoring, and from Events created through analyzing the data. Reports can either be Summary reports, comparing data across computers, or detail reports, looking at the data on a specific computer over time. To run reports:

  1. Click on the Reports tab.
    Reports with notes
  2. Select an Application from the Select an application… drop down list. This list will only include applications for which Longitude is collecting data.
  3. The available reports for the selected application are listed as tabs in the right pane.
  4. Reports are either Summary reports, comparing the same metrics across a group of computers, or Detail reports, displaying metrics on an individual computer over time. To produce a summary report, select Enterprise for all computers, or a specific Computer Group in the Groups tab. To produce a detail report, select an individual computer in either tab. The labels for each computer name in a Summary report are links to the Detail report for the selected computer for the same metrics and time range.
  5. Hovering over the graph will generate a tool tip displaying the value of the graph at that location.
  6. The left pane of the report can be collapsed or expanded through a button on the frame separating the two panes.
  7. Expand the Report Options section in the left pane for options on filtering data and changing the format of the report. The options avialable on this tab will vary depending on the selected report:
    Report options for summary disk report Report options for summary disk report Report options for summary disk report
    Windows Disk Summary Report Options Windows Disk Detail Report Options Windows Network Detail Report Options
    • Report Display Buttons:
      • Timeline and Hourly options are available for Detail reports only.
      • Timeline reports will show the metric over the selected time period. Timeline reports are useful for looking at data trends over time.
      • Hourly reports will show the average value of the metric vs. hour of the day for the selected time period. Hourly reports are useful for identifying specific times of the day when problems recur.
      • Reports for items with multiple devices on a server will also display an icon for the devices in Report Options. For example, Disk reports will display a Disk button, or Network reports will display an Interface button.
      • Graph and Table formats are available for both Summary and Detail reports.
    • Options
      • By default Table reports will display values in the same colors used in the Graph. Uncheck the Show table colors check box to display all values in black.
      • Some reports will display more than one metric – e.g. CPU displays System % and User %. Checking the Sum usage checkbox will display the total value rather than the component value. Sum usage is only visible on reports which display multiple metrics.
      • Summary reports for multpiple devices will have the option to display individual items – e.g. summary disk reports will provide the option to view all the disks averaged over a device, or to view all the disks for a device.
    • Items
      • In Summary reports, the options are to view:
        • All computers
        • Top 25 computers
        • Top 10 computers
        • Select computers to be included in summary

        The Top computer lists are sorted based on the item reported – e.g. a CPU report will sort based on highest CPU usage.

      • Detail reports will only have an Items section if there are entities to select (Disks, Network Interfaces, etc.). If there are no entities, the Items section is not listed.
  8. Expand the Date & Time section in the left pane for controls to adjust the time period covered by the report
    Time options Calendar Time options
    Time/Date selections Calendar selection
    • Expanding the Date & Time tab will collapse the Report Options tab – only one tab can be open at a time.
    • The default Date Range is Today, and the default Hours of the Day setting is All.
    • Selecting the Today, Yesterday, or This Week tabs will populate the values for the Date Range field. This Week is calculated as starting on Monday.
    • Removing a selection in Days of the Week, or setting a time range in Hours of the Day will remove samples in those time periods from both Summary and Detail reports. In Summary reports, the values removed from the selections will not be used in calculating the reported averages. In Detail reports, data points before and after the excluded period will be connected by a line.
    • The Date Range values may be typed in manually, or may be selected from a calendar by clicking on the icon to the right of the date range field.

    Report menu options

  9. The Print and Email buttons are only available for Graphs.
  10. The Export button will provide the numeric values for the report in comma separated format.
  11. See the Report Scheduler documentation for instructions on
    how to configure automated reporting.

 

Virtualization Reports

Virtualization reports are available under Hyper-V and VMware – Standard Reporting.
Virtualization reports provide timeline performance reporting for both hosts and VMs, and summary comparison reports between VMs or between hosts. To use these reports, go to Reports and select Hyper-V or VMware – Standard Reporting from the drop down list.

Virtualization reports are divided into VM reports and host reports:


VMware VM reports

  • VM CPU%
  • VM CPU Ready
  • VM Memory
  • VM Disk
  • VM Network
  • VM Storage
  • VM File
  • VM Zombies

 
VMware Host Reports

  • Host CPU
  • Host Memory
  • Host Disk
  • Host Network
  • Datastore Storage
  • Datastore File
  • Cluster CPU
  • Cluster Memory

 
Hyper-V VM reports

  • VM CPU%
  • VM Memory
  • VM Memory Pressure
  • VM Disk I/O
  • VM Queue Length
  • VM Network Data
  • VM Network Packets

 
Hyper-V Host Reports

  • Host CPU%
  • Host Processor CPU%
  • Host Memory
  • Host Mem Pressure
  • Host Disk I/O
  • Host Queue Length
  • Host Disk Storage
  • Host Network Data
  • Host Network Packets

If you select Enterprise in the Computers tab, or a group in the Groups tab, the right pane will display a summary comparison of hosts to other hosts or VMs to other VMs. If multiple entities are available for a summary report, such as multiple processors for a host or multiple virtual NICs for a VM report, there will also be an option to display individual entities or the total value.

 

Hyper-V host summary report:

Vmware Standard VM CPU Summary Report
 

VMware VM summary report:

Vmware VM Network detail summary

For VMware – Standard Reporting selecting an individual vCenter server in the Computers or
Groups tab will display reports for the hosts and VMs managed by that vCenter server.

Vmware Standard CPU summary by VM

 

VMware Capacity Planning

NOTE: VMware capacity planning reports run much faster in Chrome or Firefox than in Internet Explorer.

As with VMware Standard reports, VMware Capacity Planning uses the data collected by Longitude from monitoring vCenter servers and ESX hosts. VMware Capacity Planning may be run by selecting the VMware – Capacity Planning option in the drop down list on the Reports tab.

To run a capacity planning report, select the vCenter server you want to use for capacity planning, navigate through the Real Data Centers tree located in the left panel and click on a host, resource pool, datastore, or virtual machine. Use the tabs above the center panel to view different types of reports.

Run Report

You can change the format of the reports by clicking the Timeline or Hourly Average buttons, located in the Report Options window at the bottom of the left panel. Reports can also be viewed as graphs or tables by clicking the Graph or Table buttons.

Change Format

Clicking an item in the legend on the right side of the chart will show or hide the item. If you mouse over a point on the chart, a tooltip will be displayed giving information about that data point.

Tool Tip

The Report Options window also contains additional customization for each report. To change the settings for the currently displayed report, check or uncheck one of the configuration boxes. Note that some reports will have no options.

Report Options

The Date & Time window, located underneath the Report Options window, allows you to change the time range of the reports.

Date and Time Options

When viewing a host or datastore report, the values for the host or datastore (ie the black line) are always visible, no matter which boxes in the Report Options window are checked. However, when viewing a resource pool report, if any of the virtual machine boxes in the Report Options window are checked, the report will not show the resource pool values. Instead, it will only show the virtual machine values for that resource pool.

Resource Pool VMs Checked

To see the actual resource pool values, uncheck all virtual machine checkboxes in the Report Options window.

Resource Pool VMs Unchecked

 

Capacity Planning Scenarios

Scenarios are modifiable copies of the current vCenter structure. They allow you to try out different configurations and determine the effects of adding or deleting virtual machines. To create a new scenario, click the plus sign button in the top right corner of the left panel (make sure that with Scenarios is checked).

New Scenario

Items in scenarios can be moved around by dragging and dropping. The following example shows what would happen if we moved virtual machine CRM from host vmprod1 to host vmprod2:

Before move:

Before Move

After move:

After Move

Right clicking an item in a scenario brings up a menu with a number of options:

  • Rename – Change the name of the item.
  • Properties – View and/or change various properties of the item.
  • Clone – Create a copy of the current item.
  • Alphabetize – Orders the items underneath the current item by name.
  • Revert – Restore the item to its real configuration.
  • Delete – Remove the item from the tree.

Right Click Menu

You can change the CPU, memory, disk, and network usage of a virtual machine by modifying the Multiplier field in the Properties menu (right click the item, then select Properties). Setting the multiplier greater than 1.0 will increase usage values, setting the multiplier less than 1.0 will decrease usage values, and setting the multiplier equal to 1.0 will leave usage values unmodified. For example, a multiplier of 2.0 will double all values, while a multiplier of 0.5 will cut all values in half.

Multipliers

Note that all changes made to scenarios are automatically saved.

 

Report Scheduler

The Scheduler button will allow you to automatically produce the report you are
currently viewing, email the report, and write it out to a specified directory.

 

The available report schedules and retention times are:

Schedule Report Runs Retention Period
Hourly Hourly, 8am to 6pm 3 days
Daily 00:00, Daily 1 month
Weekly 23:59, Sunday 3 months
Monthly 23:59, 1st day of Month 6 months
Quarterly 23:59, 1st day of Quarter 1 year

 

To Schedule a Report:

  1. Click on Scheduler >> Add Scheduled Report
  2. Modify the Description – this will be the label used for the report under Scheduler >> Manage Scheduled Reports.

    Scheduling a report
  3. Select a Report Schedule from the Schedule drop down list – refer to the schedule table for report times and retention periods.
    Scheduled report times
  4. To automatically email the report, check the Email Report box and enter a comma separated list of addresses. There should not be any spaces between the addresses in the list.
  5. To automatically write the report out to a file:
    • If the report destination is on a network share, check that the account used by the Heroix Longitude Web UI Service has write permission for the share. By default, the Web UI service runs under the LocalSystem account, and this account will need to be changed to an account that has permissions to write to the destination folder, and the Web UI service will need to be restarted for the new permissions to be effective.
    • Check the Export Report box.
    • Enter the destination folder.
    • Enter the File Name for the report, without a file extension. The report will be saved as a “.xhtml” file.
  6. Select the number of Days of Data for the report. The default is 1 day.
  7. Select the hours of the day the report will cover. The default is All Hours.
  8. Click Save to save the report.

 

To Manage Reports:

  • Click on Scheduler >> Manage Scheduled Reports
  • The Count column lists the number of reports that have been produced for each
    Description. Click on the Plus icon to view the list of available archived
    reports.
  • The Date column lists when the reports were generated. Reports created by the Scheduler will
    display a Date only. Reports that have been run manually will display both Time and Date.
  • The Description is the text entered when the report was created. Editing the Description field will also change the description for archived reports. The Description may be edited by using the Edit icon.
  • The View Archive icon to the right of the archived reports creates a pop up window with the archived report.
  • The Delete archived report icon removes the archived report. Before deleting the report, a pop up window will ask you to confirm that you want to delete the report.
  • The Edit icon brings up the Modify Scheduled Report form,
    which will provide the option to change the Scheduled report settings and Description. In order to view report modifications, click on the Refresh button in the lower right of the Manage Scheduled Reports window.
  • The Delete Scheduled Report icon will remove the report from the Scheduler. Before removing the report, a pop up window will ask you to confirm that you want to remove the report. Removing a scheduled report will remove all the previously archived reports it produced.
  • The Run Report icon will manually run the scheduled report, including
    emailing or exporting the report if those options have been configured. In order to view newly run reports, click on the Refresh button in the lower right of the Manage Scheduled Reports window.

Managing Scheduled Reports

 

Real Time Monitor

Click the Real Time tab to run a real time performance monitor. A real time performance monitor graphs the current values of preselected Network Device, Unix or Windows metrics at a 10 second interval.

To display the Real Time Monitor select the computer or network device in the Real Time Performance Monitors panel.

The real time performance monitor performs multiple collections at a 10 second interval for as long as the monitor is running. This display can be resource intensive. It should not be left running if it not being interactively viewed. To stop a real time performance monitor, click another computer or device in the tree to start another one, click Enterprise or one of the application names in the tree, or click another tab.

Real Time Windows