KBEA-00132 - When and How to Use Annotation Detail

Article ID:360033188571
1 minute readKnowledge base

Summary

This article contains helpful information to collect when analyzing/troubleshooting ElectricAccelerator builds.

ElectricInsight provides useful reports that you can used to analyze build performance issues and/or troubleshoot problems.

Solution

Report Description

ElectricSimulator

Use performance information from this build to predict approximate performance on a variety of cluster sizes. This requires --emake-annodetail=basic,waiting.

Files modified multiple times

Show files that were modified (created, rewritten, or deleted) multiple times. This requires --emake-annodetail=basic,file.

Longest serial chain

Find the sequence of serialized jobs with the longest end-to-end runtime in the build. This requires --emake-annodetail=basic,waiting,history.

Serialization analysis

Find the explicit and implicit dependencies that cause serialization of any two jobs in the build. This requires --emake-annodetail=basic,waiting,history.

When troubleshooting problems related to missing targets or input files, it is very helpful to use --emake-annodetail=basic,file,lookup.

When file/network corruption is suspected during a build, using --emake-annodetail=md5 will generate md5 checksums of files that are read/written during the build.

Available --emake-annodetail options

basic

Basic annotation

env

Extended environment tracking

file

Files read or written

history

Serialization details

lookup

All file names accessed

md5

MD5 checksums for reads/writes

registry

Registry updates (Windows only)

waiting

Complete dependency graph

Applies to

  • Product versions: ElectricInsight, ElectricAccelerator

This article is part of our Knowledge Base and is provided for guidance-based purposes only. The solutions or workarounds described here are not officially supported by CloudBees and may not be applicable in all environments. Use at your own discretion, and test changes in a safe environment before applying them to production systems.