Skip to content

Commit

Permalink
In verbose mode, log Error Prone performance details
Browse files Browse the repository at this point in the history
This change introduces a `TaskListener` which logs collected
`ErrorProneTimings` post compilation.

Additionally, since `SuggestedFixes#compilesWithFix` is a very heavy
operation which significantly contributes to overall runtime, any usage
of this method is also logged. Rationale behind this decision is that if
many `compilesWithFix` checks fail, then this can "silently" slow down
the build. By logging such cases one can either invest time in
optimizing the associated check, or manually improving the code that
triggers the compilation attempts.

See google#1474.
  • Loading branch information
Stephan202 committed Aug 29, 2024
1 parent 7a28964 commit 92e050a
Show file tree
Hide file tree
Showing 4 changed files with 61 additions and 0 deletions.
Original file line number Diff line number Diff line change
Expand Up @@ -25,6 +25,7 @@
import com.sun.tools.javac.api.JavacTool;
import com.sun.tools.javac.util.Context;
import com.sun.tools.javac.util.JavacMessages;
import com.sun.tools.javac.util.Log;
import com.sun.tools.javac.util.Options;
import java.io.InputStream;
import java.io.OutputStream;
Expand Down Expand Up @@ -91,6 +92,11 @@ static void addTaskListener(
javacTask.addTaskListener(
new ErrorProneAnalyzer.RefactoringTask(context, refactoringCollection[0]));
}

if (Options.instance(context).isSet("-verbose")) {
javacTask.addTaskListener(
new TimingReporter(ErrorProneTimings.instance(context), Log.instance(context)));
}
}

@Override
Expand Down
43 changes: 43 additions & 0 deletions check_api/src/main/java/com/google/errorprone/TimingReporter.java
Original file line number Diff line number Diff line change
@@ -0,0 +1,43 @@
package com.google.errorprone;

import static java.util.stream.Collectors.joining;

import com.sun.source.util.TaskEvent;
import com.sun.source.util.TaskEvent.Kind;
import com.sun.source.util.TaskListener;
import com.sun.tools.javac.util.Log;
import java.time.Duration;
import java.util.Map;

final class TimingReporter implements TaskListener {
private final ErrorProneTimings errorProneTimings;
private final Log log;

TimingReporter(ErrorProneTimings errorProneTimings, Log log) {
this.errorProneTimings = errorProneTimings;
this.log = log;
}

@Override
public void finished(TaskEvent event) {
if (event.getKind() != Kind.COMPILATION) {
return;
}

Map<String, Duration> timings = errorProneTimings.timings();
if (timings.isEmpty()) {
return;
}

Duration totalTime = timings.values().stream().reduce(Duration.ZERO, Duration::plus);
String slowestChecks =
timings.entrySet().stream()
.sorted(Map.Entry.<String, Duration>comparingByValue().reversed())
.limit(10)
.map(e -> e.getValue() + ": " + e.getKey())
.collect(joining("\n ", " ", ""));

log.printVerbose(
"error.prone.timing", totalTime, errorProneTimings.initializationTime(), slowestChecks);
}
}
Original file line number Diff line number Diff line change
Expand Up @@ -20,3 +20,5 @@ compiler.err.error.prone={0}
compiler.err.error.prone.crash=An unhandled exception was thrown by the Error Prone static analysis plugin.\n Please report this at https://github.com/google/error-prone/issues/new and include the following:\n\n error-prone version: {1}\n BugPattern: {2}\n Stack Trace:\n {0}
compiler.warn.error.prone={0}
compiler.note.error.prone={0}
compiler.misc.verbose.error.prone.compiles.with.fix=Running `compilesWithFix` for {0} in {1}
compiler.misc.verbose.error.prone.timing=Error Prone analysis took {0} (plus {1} for initialization); slowest checks:\n{2}
Original file line number Diff line number Diff line change
Expand Up @@ -105,6 +105,7 @@
import com.sun.tools.javac.tree.JCTree.JCCompilationUnit;
import com.sun.tools.javac.util.Context;
import com.sun.tools.javac.util.JCDiagnostic;
import com.sun.tools.javac.util.Log;
import com.sun.tools.javac.util.Options;
import com.sun.tools.javac.util.Position;
import java.io.IOException;
Expand Down Expand Up @@ -1311,6 +1312,15 @@ private static boolean compilesWithFix(
return false;
}

if (Options.instance(state.context).isSet("-verbose")) {
JCCompilationUnit compilationUnit = (JCCompilationUnit) state.getPath().getCompilationUnit();
Log.instance(state.context)
.printVerbose(
"error.prone.compiles.with.fix",
fix.toString(compilationUnit),
compilationUnit.sourcefile);
}

Result compilationResult = fixCompiler.compile(extraOptions);
URI modifiedFileUri = FixCompiler.getModifiedFileUri(state);

Expand Down

0 comments on commit 92e050a

Please sign in to comment.