fix for disk usage measurements - #692
Open
MarkWolters wants to merge 4 commits into
Open
Conversation
Contributor
|
Before you submit for review:
If you did not complete any of these, then please explain below. |
ashkrisk
reviewed
Aug 20, 2026
| * <p>Call {@link #appendTo(List)} to emit these as {@link Metric} entries so they can be selected for | ||
| * console/CSV reporting.</p> | ||
| */ | ||
| private static final class BuildOnDiskResult { |
Contributor
There was a problem hiding this comment.
The Javadoc above refers to the wrong class now that BuildOnDiskResult has been inserted here. I'd also suggest moving this definition up to before the buildOnDisk methods are defined.
Contributor
Author
There was a problem hiding this comment.
Done, thanks for catching that
Contributor
There was a problem hiding this comment.
The positioning issue is now fixed, but looks like the original Javadoc for ConstructionMetrics looks to have been accidentally removed along with it
Contributor
Author
There was a problem hiding this comment.
restored ConstructionMetrics javadoc
…ct comment for BuildOnDiskResult
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
This PR is a fix for an issue in how file sizes were calculated by the JVector test harness, i.e. BenchYAML and AutoBenchYAML.
Problem 1: The index cache directory accumulates across runs
In Grid.runOneGraph (and runAllAndCollectResults), BenchmarkDiagnostics monitors two directories:
diagnostics.startMonitoring("testDirectory", workDirectory);
diagnostics.startMonitoring("indexCache", Paths.get(indexCacheDir)); // "index_cache/"
getTotalBytes() sums both. The index_cache/ directory is persistent — it is never wiped between runs. So the reported disk figure grows monotonically across the run, regardless of which configuration is under test. The delta
between a fused-PQ run and a non-fused-PQ run is invisible.
Problem 2: Even within a single run, the snapshot captures all feature sets, not just one
When multiple feature sets are built in the same runOneGraph call, the directory total covers all of them. You can't attribute disk usage to a specific configuration from that number.
There is even a TODO in the code acknowledging this at line 233:
// TODO this does not capture disk usage for cached indexes. Need to update
The fix
Rather than directory-level monitoring, measure the specific graph file for each feature set directly after it is written. In buildOnDisk, the path for each feature set's graph file is already computed:
if (handles.containsKey(features)) {
graphPath = handles.get(features).writePath();
} else {
graphPath = outputDir.resolve("graph" + n++);
}
After the build completes, Files.size(graphPath) gives the exact on-disk size for that specific configuration. This value should be returned from buildOnDisk (as part of a result map keyed by feature set) and then included
in the BenchResult params or metrics map alongside the other per-configuration numbers.