Installing and Administering N1 Grid Console - Container Manager 1.0

Resource Utilization Reports and Extended Accounting Data

If you have the Performance Reporting Manager software installed, you can generate reports that detail the CPU and the memory resources used per container, host, or resource pool. Both of these graph reports are available from the Utilization tab located in the Container Manager GUI. These graph reports become available in the GUI two hours after the Performance Reporting Manager software is installed. This waiting period is needed to allow data to be collected and stored in the database for use in the graph reports. The waiting period for weekly and monthly graphs is 24 to 48 hours.

The following six types of resource usage graph reports are available from the Container Manager GUI.

Container Definition: Data returned is the average of the resources used by all containers, which can include both active and inactive containers. Historical data is provided for inactive containers. The addition of historical data enables you to determine whether your containers are controlling resource consumption effectively. The data is represented as a percentage of the resource reservations for minimum CPU and memory cap for all active containers. This percentage compares the actual resources used to the resources reserved.
Active Container: Data returned is the number of CPUs and memory currently being used for the selected active container.
Container Group: Data returned is the average of the resource used for all containers in the selected group. This percentage compares the actual resources used to the resources reserved for the selected containers.
Host: Data returned is the aggregation of all active containers on the selected host.
Host Group: Data returned is the average resource utilization of all hosts located in that group. The data is represented as a percentage used of the total host resources.
Resource Pool: Data returned is the aggregation of all the active containers in the selected resource pool.

If the requested graph is for multiple containers across different hosts, the data returned is the average of the percentage being used on each host.

Report data can also be exported to a text file in comma-separated values (CSV) format for an active container, resource pool, or host. The text file can be used as an interface file for a billing and accounting application, for example. A report in CSV format is available 2 hours after installation of the Performance Reporting Manager software. This waiting period enables report data to be collected and stored in the database for use in a CSV report. The exported data is more detailed and granular than the data that appears in the graph reports. Data for the last 24 hours is available in a CSV report.

The exported CSV reports contains the following categories of information:

Host name: Name of the host with which the container is associated
Timestamp: Date and time for the record.
CPU Reservation: CPU reservation of the container
CPU Usage: Combined CPU usage of all processes in the container
CPU Return of Investment: CPU utilization compared to CPU reserved, expressed as a percentage.
CPU Extended Accounting Information: CPU extended accounting information
Memory Cap: Physical memory cap
Memory Usage: Physical memory used
Percentage of Memory Used: Physical memory utilized of the host expressed as a percentage
Memory Return of Investment: Memory utilized compared to memory reserved, expressed as a percentage.
Container Project ID: Project ID of the container
Project Name: Project name of the container

Data Collection Process

Container Manager uses the Performance Reporting Manager data collection service, which is located on the server layer. This data collection service in turn uses the history logging capabilities of Sun Management Center, which is located on the agent layer. The data collection service on the server layer collects the data from the agent machines and stores it in the database. Additionally, data collected by Performance Reporting Manager is summarized, or “rolled-up,” at predefined intervals. The minimum, maximum, and average values for data are calculated and are stored as hourly data, weekly data, or monthly data. Finally, the minimum, maximum, and average values are calculated for these same intervals.

The reports generated with Container Manager can incorporate any of this data, depending upon the report request parameters. For more information about Performance Reporting Manager data collection methods, see “Data Collection Process” in Sun Management Center 3.5 Performance Reporting Manager User's Guide.

Requesting a Report

Both CPU and memory resource utilization reports are available per host, container, container definition, or resource pool. Before trying to view a report, be sure to set the browser's cache to refresh every time. For a list of the six types of reports available, see Resource Utilization Reports and Extended Accounting Data. Reports for CPU and memory resources used are available for the following intervals:

Daily – Shows data for the last 24 hours, one point per hour
Weekly – Shows data for the last 7 days, one point per day
Monthly – Shows data for the last 30 days, one point per day
Real Time - Shows data every 30 seconds per graph point. Available for active containers only.

You must wait two hours after installation of the Performance Reporting Manager software for the daily graph reports to become available. Data first must be collected and stored in the database from which the report can be drawn. You can also view CPU and memory resource utilization reports for inactive containers and container definitions that are based on historical data.

Real time reports for CPU and memory resources being used are available for active containers only.

Figure 3–26 Sample: Real Time CPU Utilization Graph Report For an Active Container

Screen capture of a sample real time CPU Utilization report. Surrounding text describes the context.

Figure 3–27 Sample: Real Time Memory Utilization Graph Report For an Active Container

Screen capture of a sample real time Memory Utilization report. Surrounding text describes the context.

To Request a Resource Utilization Report For a Host

Use this procedure if you want to obtain a daily, weekly, or monthly report for a host.

Set the browser's cache to refresh every time.

In the Hosts view, select the host from the navigation window.

Select the Utilization tab.

Select the desired report: daily, weekly, monthly.

Real time reports are not available for a host. The graphs for CPU and memory resources used by the selected host appears.

(Optional) To export the last 24 hours of data to a CSV file, click Export Data.

You must wait at least 2 hours after installation of the Performance Reporting Manager software for a CSV report to be available. Data must first be collected and stored in the database from which the report can be drawn. You cannot preview this data in a graph.

Data exported contains the hourly data for the container for the last 24 hours. Therefore, it is not identical to the data obtained from a daily graph.

To Request a Resource Utilization Report for an Active Container

Set the browser's cache to refresh every time.

In the Containers view, select the container from the navigation window.

The Hosts Associated with this Container Definition table appears. All the hosts that the container is associated with are listed in the table.

Select the host for which you want a report by clicking the name.

The Properties sheet for the container on this host appears.

Select the Utilization tab.

Select the desired report: daily, weekly, monthly, real time.

The CPU and memory resource utilization graphs appear. If a Real Time report was selected, use the Refresh button to see more real time data.

(Optional) To export the last 24 hours of data to a CSV file, click Export Data.

You must wait at least 2 hours after installation of the Performance Reporting Manager software for a CSV report to be available. Data must first be collected and stored in the database from which the report can be drawn. You cannot preview this data in a graph.

Data exported contains the hourly data for the container for the last 24 hours. Therefore, it is not identical to the data obtained from a daily graph.

To Request a Resource Utilization Report for a Container Definition

Use this procedure to request CPU and memory utilization reports for a container definition. The data is based on historical data and is an average of the resources used by active containers that are based on the container definition.

Set the browser's cache to refresh every time.

In the Containers view, select the container definition.

Select the Utilization tab in the right panel.

Select the desired report: daily, weekly, monthly.

The CPU and memory resource utilization graphs appear.

To Request a Resource Utilization Report for a Resource Pool

In the Hosts view, select the host to which the resource pool is bound.

A list of all resource pools bound to this host appears in the Resource Pools table in the right pane.

Select the name of the resource pool in the table.

A table listing all containers that are bound to this resource pool appears.

Select the Utilization tab in the right panel.

Select the desired report: daily, weekly, monthly.

The CPU and memory resource utilization graphs appear.

(Optional) To export the last 24 hours of data to a CSV file, click Export Data.

You must wait at least 2 hours after installation of the Performance Reporting Manager software for a CSV report to be available. Data must first be collected and stored in the database from which the report can draw from. You cannot preview this data in a graph.

Data exported contains the hourly data for the container for the last 24 hours. Therefore, it is not identical to the data obtained from a daily graph.