Manuals / HP / Computer Equipment / Software

HP UX IPFilter Software manual Diagnostics View, Help View

Models: UX IPFilter Software

1 277

Download 277 pages 61.39 Kb

Page 38

Diagnostics View

The Diagnostics view contains any warning messages that HP Caliper might generate when measuring your application or retrieving its performance data for viewing. By default, this view overlays the Console view at the bottom of the GUI window. Any errors produced will appear in popup dialogs.

The figure below shows the Diagnostics view:

Figure 10 Diagnostics View

Help View

The Help view contains classic help information on how to use the GUI, what to do next, what the measurements mean, and so forth. This view appears on either the right side of the GUI window or in its own window, depending on the type of help requested.

The figure below shows the Help view:

Figure 11 Help View

38 Getting Started with the HP Caliper GUI

Image 38

HP UX IPFilter Software manual Diagnostics View, Help View

Contents

HP Caliper User Guide Copyright 2014 Hewlett-Packard Development Company, L.P Contents HP Caliper Measurement Configuration Files HP Caliper OptionsContents Configuring HP Caliper Using the HP Caliper AdvisorUsing the HP Caliper Advisor in the GUI Controlling the Content of Reports 105Producing a Sampled Call Graph Profile Analysis 122 Producing a Sampled Call Stack Profile Analysis 134Descriptions of Measurement Reports 171 Contents Systems 211 Event Set Descriptions for CPU Metrics HP-UX only 232Metrics for Integrity Servers Itanium 2 Systems 211 212Glossary 268 Index 273 HP secure development lifecycle About This Document Computer output CommandTypographic Conventions File nameRelated Documents HP Encourages Your Questions HP Caliper at a Glance What is HP Caliper?What is HP Caliper? HP Caliper Components User Interfaces HP Caliper at a GlanceSupported Compilers and Application Environments What Does HP Caliper Run On?Supported Hardware and Operating Systems What Does HP Caliper Run On?Summary of HP Caliper Features Getting Started with the HP Caliper Command-Line Interface Getting Started with the HP Caliper Command-Line Interface CpucyclesTarget Getting Started with the HP Caliper Command-Line Interface Example Adding Instructions to an fprof Report Example Adding Instructions to an fprof ReportGetting Started with the HP Caliper Command-Line Interface Sampled Measurements Types of MeasurementsGlobal Measurement Precise MeasurementsCaliper measurement caliperoptions program programarguments What to Look for in Using HP CaliperSyntax for caliper Command MeasurementStopping HP Caliper Basic Tasks a Quick ReferenceStarting HP Caliper Showing HP Caliper OptionsCreating a Text Report for Analysis Using the HP Caliper AdvisorRestrictions on Using HP Caliper Creating a Report Based on Your Collected DataCaliper info Additional HP Caliper CommandsGetting Information About HP Caliper Caliper report merge diffWindow Basics What Is the HP Caliper GUI?Getting Started with the HP Caliper GUI Getting Started with the HP Caliper GUIProjects View Window BasicsCollect View Projects ViewAnalyze View Collect ViewAdvisor View Analyze ViewConsole View Advisor ViewDiagnostics View Help ViewMaking Measurements Tips for Using ViewsHints on How to Make Measurements Making MeasurementsGetting Performance Tuning Advice Exploring Performance DataNative Local GUI Getting HelpStarting the GUI Remote GUILogin Screen HP Caliper Measurement Configuration Files Measurement Configuration Files Provided with HP CaliperFprof DtlbEcount IcacheOverview Measurement Overview MeasurementSimultaneous fprof Sampling on Multiple PMU Counters Location of Measurement Configuration FilesSpecifying Option Values in Measurement Configuration Files Location of Measurement Configuration Files See Hierarchy for Processing an Option Value pMultiple Ways to Specify HP Caliper Option Values HP Caliper OptionsBasic Information About Options ExamplesHierarchy for Processing an Option Value Or --databaseOr --duration ExamplesOr --help Or --options-fileOr -? Or --metricsOr --output-file CpueventFor PMU Histogram Reports Or --processOr --report-details For Function Coverage ReportsRate Or --sampling-specSperiod Srate ,variation ,cpuevent VariationCPUCYCLES,10000,10% Advice-classesOr --version BrancheventAnalysis-focus Advice-cutoffAdvice-details Branch-sampling-specBus-speed int Bus-speedCallpath-cutoff Callpath-cutoffpercentcutoff,cumpercentcutoff,mincountCpu-counter Context-linesCpu-aggregation Cpu-detailsDcache-hits Dcache-data-profileDatabase Dcache-storesDescription-details Db-saveDebug-file-path= DetailsExample Etb-freeze-delayDuration Etb-walkback-cycles Event-defaultsEvent-defaults privilege-level-mask=levelthreshold=int Etb-walkback-cycles integerFold Exclude-caliperExclude-idle Frame-depthIbrp HelpHotpaths Join InfoInlines JreMeasure-on-interrupts Kernel-stackLatency-buckets Memory-usage=Module-exclude Module-defaultMetrics Module-includeOmr Module-search-pathNoinlines Module-search-path directorydirectoryOverflow-block Options-fileOutput-file Per-module-dataSee -p or --process p ProcessProcess-cutoff Process-cutoffpercentcutoff,cumpercentcutoff,mincountReport-details Read-init-fileReport Rule-filesUsing --scope system for System-Wide Measurements Psetid psetidSort-by SearchSkip-functions Sort-bymetric,cpueventSummary-cutoff Source-path-mapStop-functions Summary-cutoffpercentcutoff,cumpercentcutoff,mincountSystem-usage= Sw-process-list=System-model Linux only System-modelmodel-number,number-of-cellsTraps-reported Term-displayThreads Version User-regions defaultrum-sumUser-regions Rum and sumExample of an HP Caliper Advisor Report Using the HP Caliper AdvisorWhat Is the HP Caliper Advisor? Limitations to Keep in MindExample 1 HP Caliper Advisor Report Steps in Using the AdvisorUsing the HP Caliper Advisor Where adviseoptions are Command Line to Invoke the AdvisorCommand line is Command Line to Invoke the AdvisorAdvice-details Advice-classesAdvice-cutoff Max-countMore Typical Examples Getting Started with the Advisor ExamplesSimplest Example Then, run the Advisor on the composite performance data Explanation of Report OutputFollowed by How to Read an Advisor Report How to Read an Advisor ReportSuggestions for Using the HP Caliper Advisor How the HP Caliper Advisor Works How the HP Caliper Advisor WorksUsing the HP Caliper Advisor in the GUI Using the HP Caliper Advisor in the GUIBasic Steps in Using the HP Caliper Advisor in the GUI Making Performance Measurement RunsSelecting Performance Data to Analyze Optional Selecting Performance Data to Analyze OptionalProjects View, with a Single Project Selected Generating Advice Generating AdviceReviewing and Acting on the Advice HP Caliper GUI Advisor MenuReviewing and Acting on the Advice Advisor Report in the HP Caliper GUIExample of a .caliperinit File Configuring HP CaliperConfiguring HP Caliper Caliperinit file, you can then simply typeSuppressinitwarnings = TrueFalse Setting Constants in the .caliperinit FileDisasmtargetnamelimit = limit Suppressstatementdata = TrueFalseShortening CPU Event Names Configuring Data CollectionSpecifying Which CPU Events to Measure Specifying Which Load Modules to Collect Data For Default Settings for Load Module Data CollectionModule-default Module-include Module-exclude Module-include modulelistHow to Specify Load Module Names Process Tree Report Controlling Granularity of Data Collection and ReportsSpecifying Processes to Measure For more information, see -s or --sampling-spec pRoot-forks DefaultSyntax for -p Option CustomfunctionnameSomeopt1,opt2,...pattern Using -p someGlob1glob2 Examples of the -p Option Using HP Caliper in Your Build ProcessUsing HP Caliper in Testing and Quality Assurance Process Origin Options Used with -p someCaliper measurement options pid pid Using HP Caliper to Generate Test Suite ReportsAttaching to a Running Process to Perform Measurements Ccounternamekeywordall Options for the caliper info CommandOr --cpu-counter Or --output-file Examples of the caliper info CommandOr --details Or --reportHP Caliper Environment Variables Layout of an HP Caliper Text or CSV Report Controlling the Content of ReportsLayout of an HP Caliper Text or CSV Report Controlling the Content of Reports Metrics You Can Use for Report Sorting and CutoffsMetrics You Can Use for Report Sorting and Cutoffs Available Metrics for Report Sorting and Cutoffs This produces a report similar to this truncated report Module-Centric ReportsFor example, assume that you perform this HP Caliper run Process Summary for a Diff Run Process SummaryProcess Summary for a --group-by none Run Function Details Disassembly ListingFunction Details Address Types Shown Branch Targets in Disassembly ListingsSource Position Correlation Source Line DataUnnamed Functions How Functions Are Named in ReportsVSE Information Shown in Report Output Unknown FunctionsControlling the Content of Reports Names and Locations for the Databases Changing the Default Name and LocationHow HP Caliper Saves Data in Databases Or simplyCaliper report merge diff reportoptions databases You can use the caliper report merge diff command toCreating Reports from Multiple Databases Database2 database1 for caliper diffCreating Reports from Multiple Databases Caliper report reportoptions databaseCaliper merge reportoptions database1 database2 Example 2 Example of a caliper merge Run CpucyclesPmutrace Scgprof Caliper diff reportoptions database2 database1Example 3 Example of a caliper diff Run As cc1 ld Example of How to Use the caliper diff CommandCstack Pmutrace Scgprof As cc1Differences Between scgprof and cgprof Producing a Sampled Call Graph Profile AnalysisHow Sampled Call Graph Profile Analysis Works Producing a Sampled Call Graph Profile AnalysisCaliper scgprof caliperoptions program programarguments Running the HP Caliper Sampled Call Graph ProfileSampled Call Graph Text Report Example Running the HP Caliper Sampled Call Graph ProfileSampled Call Graph Text Report Example Sampled Call Graph Text Report Example Producing a Sampled Call Graph Profile Analysis Br.cond.dpnt.many self+0x2db0 Producing a Sampled Call Graph Profile Analysis Sampled Call Graph Text Report Example Producing a Sampled Call Graph Profile Analysis Root Call Graph Part of the Report Sampled Call Graph Profile Report DetailsFlat Profile Part of the Report Hot Call Paths Part of the ReportGprof Fallacy and Possibly Misleading Results Diagnostic MessagesDiagnostic Messages appear at the end of the report Gprof Fallacy and Possibly Misleading ResultsCall Stack Profile Text Report Example for HP-UX Producing a Sampled Call Stack Profile AnalysisRunning HP Caliper to Produce a Call Stack Profile Caliper cstack caliperoptions program programargumentsCall Stack Profile Text Report Example Call Stack Profile Text Report Example for HP-UXProducing a Sampled Call Stack Profile Analysis Call Stack Profile Text Report Example for HP-UX Root Call Stack Profile Text Report Example for HP-UX Producing a Sampled Call Stack Profile Analysis Function Indexes Thread 6065598@startroutine Name Call Stack Profile Text Report Example for Linux An example report for HP Caliper on Linux is shown hereCall Stack Profile Text Report Example for Linux Call Stack Profile Text Report Example for LinuxProducing a Sampled Call Stack Profile Analysis Root Producing a Sampled Call Stack Profile Analysis Call Stack Profile Text Report Example for Linux Producing a Sampled Call Stack Profile Analysis Samples-running HP-UX only Samples-blocked HP-UX only Call Stack Profile Report DetailsBlocking Primitives Summary Part of the Report Call Stack Profile Report DetailsExample 4 Sample cstack Report Blocking Primitives Details Pstack like functionality Limitations to Using cstackAvoids gprof Fallacy Sample report followsProducing a Sampled Call Stack Profile Analysis Performing CPU Metrics Analysis 153HP Caliper Features Specific to HP-UX Measuring Memory Usage Concurrently with Other MeasurementsMemory-usage=all Examples of the --memory-usage= OptionSome examples of the option follow Memory-usage=beginendExample Report Output How to Read the ReportsSystem Memory Configuration Table Process Memory Usage Table Measuring System Usage Concurrently with Other Measurements Example System Usage Report Output Measuring System Usage Concurrently with Other MeasurementsInterpreting the Data Caliper measurement options pidRun ./myprog and find the process ID of the process Taking PMU Samples in Your CodeTriggering PMU Samples in Specific Code Regions Taking PMU Samples in Your CodePrecautions When Using Triggered Samples 162 shows part of the resulting reportRestricting PMU Measurements to Specific Code Regions Caliperpmuenable Restricting PMU Measurement to Specific Code Documentation feedback Documentation feedbackError #28 Caliper Invalid Measurement Combination HP Caliper Diagnostic and Warning MessagesError #28 Caliper Invalid Measurement Combination Instructions Labeled StubHP Caliper Diagnostic and Warning Messages Mispredicted Branches ExamplePMU Sample Hits Outside Function Range PMU Sample Hits Outside Function RangeScgprof Reports Require Kernel Patch HP Caliper Diagnostic and Warning Messages Descriptions of Measurement Reports Example Command Line for Text ReportExample Command Line for CSV Report Alat Measurement Report DescriptionMetrics for Integrity Servers Itanium 2 Systems INSTCHKALDCALAT.INT INSTFAILEDCHKALDCALAT.FPAlatstorehit Alat Measurement Report MetricsAlatentryreplaced SeeBranch Metrics Summed for Entire Run Branch Measurement Report DescriptionHow Alat Metrics Are Obtained BRMISPREDDETAIL.ALL.CORRECTPREDBRMISPREDDETAIL.IPREL.CORRECTPRED BRMISPREDDETAIL.ALL.WRONGTARGETBEFLUSHBUBBLE.ALL BRMISPREDDETAIL.IPREL.WRONGPATHNumber of IP-relative branch types with mispredicted path BRPREDDETAIL.IPRELCORRPREDBRPREDDETAIL.IPRELWRONGPATH BRPREDDETAIL.IPRELWRONGTARGETBRPREDDETAIL.NONRETINDWRONGTARGET BRPREDDETAIL.NONRETINDCORRPREDBRPREDDETAIL.RETURNWRONGPATH BRPREDDETAIL.RETURNCORRPREDBranch Measurement Report Metrics Information in branch Measurement ReportsHP Caliper Call Graph Profile Results Accuracy Cgprof Report DescriptionHow branch Metrics Are Obtained Available only on HP-UXCall Graph Profile Metrics Information in cgprof Measurement Report Fields Flat ProfileInformation in cgprof Measurement Report Parent Listings Cpu Measurement Report Description Information in cgprof Measurement Report Children ListingsExample Command Lines for Text Report CPU Event SetsL2icache L2dcache,l2icacheL2dcache L3cacheCstack Measurement Report Description Cstack Measurement Report MetricsHP-UX only Sample Hits Waiting Be resolved to a symbolColumn Description HP-UX only Sample Hits BlockedParent Func Hits Cycles Measurement Report DescriptionColumn Run + Block Hits HP-UX only ChildrenCycles Metrics Summed for Entire Run CYCBEBUBBLE.ANY BERSEBUBBLE.ALL CPUCPLCHANGES.ALL CPUOPCYCLES.ALLRetiredinstnop CYCBEWB2FLUSH.ANY CYCBEIBDSTALL.ANY CYCBEIBDSTALL.GRLOAD CYCBEDETREPLAY.GRLOADHow cycles Metrics Are Obtained From that bundle are split issuedCycles Measurement Metrics Information in cycles Measurement ReportsDcache Measurement Report Description Dcache Measurement Report DescriptionL1DREADMISSES.ALL Dcache Metrics Summed for Entire RunL1DREADS DatareferencesTo RAW hazard in an instructions GR load Bubbles, or partial replaysRAW or WAW dependency condition of the instruction Dcache Measurement Report Metrics Source statement Instruction Information in dcache Measurement ReportsExample dcache Reports Dcache Measurement Report Description How Data Cache Metrics Are Obtained How the Data Summary Information Is Obtained Dtlb Measurement Report DescriptionHow Latency Bucket Metrics Are Obtained Dtlb Measurement Report DescriptionDtlbinsertshpw Dtlb Metrics Summed for Entire RunL2DTLBMISSES L2DTLBMISSES / DatareferencesFLDTLBINSREQ.NONRETIRED IA64INSTRETIRED L1DTLBTRANSFER L1DREADS L2DTLBMISSESFLDTLBLOADMISS.ANY FLDTLBINSREQ.RETIREDL2 Dtlb Dtlb Measurement Report MetricsDTLBHPWREQBLKMISS.FAIL HPWHow Data TLB Metrics Are Obtained Information in dtlb Measurement ReportsCpucycles Ecount Measurement Report DescriptionEcount Metrics Summed for Entire Run Ecount Measurement Report Description Fcount Measurement Report Description Only on HP-UXFcover Measurement Report Metrics Fcover Measurement Report DescriptionFcount Measurement Report Metrics Information in fcount Measurement ReportsDirectory Fprof Measurement Report DescriptionUnknown Source Files FunctionFprof Metrics Summed for Entire Run BERSEBUBBLE.ALLFlushing of instructions CYCBEWB2FLUSH.ANYNumber of CPU cycles spent in WB2 Write back Dispersal without issuing instructionsFprof Measurement Metrics How fprof Metrics Are Obtained Information in fprof Measurement ReportsL1IREADS Icache Measurement Report DescriptionIcache Metrics Summed for Entire Run L2INSTDEMANDREADSL2IREADS.ALL.ALL L2IDEMANDREADSL2IPREFETCHES L2IREADS.MISS.ALLL1 instruction cache misses per Icache Measurement Report Metrics Information in icache Measurement ReportsHow Instruction Cache Metrics Are Obtained Itlb Measurement Report DescriptionFunction Details Itlb Measurement Report DescriptionITLBMISSESFETCH.L2ITLB Itlb Metrics Summed for Entire RunITLBMISSESFETCH.L1ITLB BELOSTBWDUETOFE.ALLMlitlbmiss L1ITLBINSERTSHPW L1IREADSFlitlbmiss MlitlbhpwabortsCycles lost due to branch execution Itlb Measurement Report MetricsFlitlbinserthpw Information in itlb Measurement ReportsItlb HPW Fill How Instruction TLB Metrics Are ObtainedColumn Description Itlb L2 Fill Itlb Soft FillScgprof Measurement Report Metrics Flat Profile Pmutrace Measurement Report DescriptionScgprof Measurement Report Description Scgprof Measurement Report Description Scgprof Measurement Report Metrics Call Graph ProfileIs profiled otherwise blank Column Description Call Total Information in scgprof Measurement Report Parent ListingsInformation in scgprof Measurement Report Children Listings Column DescriptionTraps Measurement Report Description Traps Metrics Summed for Entire Run Cycles lost due to pipeline-flush stalls Cycles lost due to RSE stallsTraps Measurement Metrics Information in traps Measurement ReportsHow traps Metrics Are Obtained Metrics Available from this Measurement Event Set Descriptions for CPU MetricsBrpath Event Set Include idle --exclude-idle FalseBrpred Event Set Brpred Event SetIprel C2c Event Set C2c Event SetCpi Event Set Mips Pred-OffCPI Cpi Event SetCpubus Event Set Available only on Itanium 2 and dual-core Itanium 2 systemsCspec Event Set Cspec Event SetDispersal Event Set Dspec Event Set Dspec Event SetMetrics Available from this Measurement Fp Event Set FCVT.fxSIR L1dcache Event Set L1dcache Event SetL1icache Event Set NON RSE Misses per KinstL1icache Event Set L2cache Event Set L2cache Event Set L2dcache Event Set L2icache Event Set L2icache Event SetMetrics Available from this Measurement L3cache Event Set L3cache Event SetEvent Set Descriptions for CPU Metrics Memreq Event Set Memreq Event SetMetrics Available for Intel Itanium 9500 series systems Queues Event Set Queues Event Set Snoop Event Set Replay Event Set Stall Event SetInclude idle --exclude-idle False Dcache Sysbus Event SetMetrics Available for Intel Itanium 9500 series systems Sysbus Event SetCPU Threadswitch Event Set Hint Stall MLD use or HPW miss or IBQ being empty Tlb Event Set Tlb Event Set Glossary GlossarySet p 269EAR Measurement Configuration Files p 271TLB 273 SymbolsIndex CPU event names shortening, 94 CPU events Daemon processes measuringEnvironment variables HP Caliper, 104 Error messages 275Sampled measurements performing Useparensforstatementdata constant 277