Product Description
ElectricInsight® is a reporting and visualization tool for ElectricAccelerator®. ElectricInsight (”Insight”) reads an annotation file, which is produced by Electric Make® (”eMake”), to provide a graphical representation of the build structure for performance analysis. Insight provides detailed information and reports for each job on each host in the build cluster. Insight shows how a build is structured and run, which lets you find performance problems or conflicts in a parallel build.
You can use Insight for at-a-glance diagnostics by examining which jobs are being performed, when they are being performed, and the files that are associated with them. You can also use Insight to help identify makefile problems and compare certain differences between an annotation file and a file from a similar build to help solve performance, job cache misses, and other issues. Insight is a simpler alternative to examining the file itself to find errors and tune performance.
What’s New or Modified
New Features and Functionality
-
The command-line version of the Longest Jobs report is extended to allow filtering of jobs by type (such as the 10 longest parse jobs or compile jobs). For details, see the “Command-Line-Enabled Reports” section in the “Reports” chapter of the ElectricAccelerator 5.4 ElectricInsight User Guide. (EI-796)
-
The job classifier now includes first-class support for Yocto BitBake task types. This allows the classifier to identify BitBake tasks natively for conversion into annotation.
You can use this functionality to view BitBake build statistics in ElectricInsight via downloadable scripts at https://github.com/electric-cloud/electricaccelerator/tree/master/Bitbake_buildstats2anno. These scripts convert BitBake build statistics into ElectricAccelerator annotation format. For details about this first-class support, see the “Optimizing Yocto BitBake Statistics for Conversion into Annotation” section in the “Getting Started” chapter of the ElectricAccelerator 5.4 ElectricInsight User Guide. (EI-795)
-
The Job Details window now includes a Prereq jobs tab, which lists each job prerequisite (a file or target that must be current before a job is run). For details, see the “Reports” chapter of the ElectricAccelerator 5.4 ElectricInsight User Guide. (EI-794)
-
You can now find jobs that are part of a given job (such as all continuation jobs that are logically part of an original rule job). For details, see the “Searching for Jobs” section in the “Build, Job, and Make Information” chapter of the ElectricAccelerator 5.4 ElectricInsight User Guide. (EI-793)
-
The Serialization Analysis report now indicates jobs that are serialized only because one of them has an incorrect input event count (possibly because of stale history). For details about this report, see the “Reports” chapter of the ElectricAccelerator 5.4 ElectricInsight User Guide. (EI-791)
-
The ElectricSimulator report now incorporates terminator lag into the simulation. This improves report accuracy (especially for builds with terminator lag issues) and lets you assess the effect of different scheduling orders on terminator lag. For details about this report, see the “Reports” chapter of the ElectricAccelerator 5.4 ElectricInsight User Guide. (EI-790)
Documentation
The ElectricInsight User Guide is available online. To view the user guide, choose Help > User Guide in the Insight application or read it online along with the rest of the ElectricInsight documentation on the CloudBees Accelerator product documentation page.
These documents are updated periodically.