9 Controlling the Content of Reports

HP Caliper allows you to control the content of reports based on the data collected. Processor Information, Run Information, and Sampling Specifications are present by default in all collection run reports.

Layout of an HP Caliper Text or CSV Report

HP Caliper uses a consistent layout for the sections in all of the measurement reports produced for text or CSV output. While not all of the reports contain all of the sections, the order and format of the sections is consistent.

The general layout of the reports is the following:

•Overall information for the collection run:

◦Processor Information

◦Run Information

◦IP Sampling Specification (possibly)

◦Branch Sampling Specification (possibly)

◦Metrics Summed for Entire Run (possibly)

◦Process Summary (possibly)

◦Unwind Sampling Specification (possibly)

•Information specific to each process:

◦Target Application

◦Target Execution Time

◦IP Sampling Specification (possibly)

◦Branch Sampling Specification (possibly)

◦Load Modules Included (possibly)

◦Load Modules Excluded (possibly)

◦System Memory Configuration (if the --memory-usage=option is specified)

◦Process Memory Usage (if the --memory-usage=option is specified)

◦System Usage (if the --system-usage=option is specified; Run Status, Syscalls, breakdown of I/O usage, and individual CPU usage can be shown, depending on the option parameters)

◦Metrics Summed for Entire Run (possibly)

◦Load Module Summary (possibly)

◦Function Summary (possibly)

◦Function Details (possibly)

◦Unwind Sampling Specification (possibly)

•Report-specific information dependent on the measurement type:

◦Event Counts for ecount

◦Function Count Details for fcount

◦Source Directory Summary, Source File Summary, and other function information for fcover

104 Controlling the Content of Reports