[trask]

Add fluent typed-point assertions to MetricAssert. For the common Java instrumentation pattern below, removing the intermediate histogram callback saves eight spaces of indentation throughout the point assertions.

Before:

testing.waitAndAssertMetrics(
    "io.opentelemetry.spring-webflux-5.0",
    metric ->
        metric
            .hasName("http.client.request.duration")
            .hasHistogramSatisfying(
                histogram ->
                    histogram.hasPointsSatisfying(
                        point ->
                            point.hasAttributesSatisfyingExactly(
                                equalTo(HTTP_REQUEST_METHOD, "GET"),
                                equalTo(HTTP_RESPONSE_STATUS_CODE, 200),
                                equalTo(NETWORK_PROTOCOL_VERSION, "1.1"),
                                equalTo(SERVER_ADDRESS, uri.getHost()),
                                equalTo(SERVER_PORT, uri.getPort())))));

After:

testing.waitAndAssertMetrics(
    "io.opentelemetry.spring-webflux-5.0",
    metric ->
        metric
            .hasName("http.client.request.duration")
            .hasHistogramPointsSatisfying(
                point ->
                    point.hasAttributesSatisfyingExactly(
                        equalTo(HTTP_REQUEST_METHOD, "GET"),
                        equalTo(HTTP_RESPONSE_STATUS_CODE, 200),
                        equalTo(NETWORK_PROTOCOL_VERSION, "1.1"),
                        equalTo(SERVER_ADDRESS, uri.getHost()),
                        equalTo(SERVER_PORT, uri.getPort()))));

The shortcuts cover all seven metric types, accept varargs or iterable point assertions, and return MetricAssert for continued chaining.

[opentelemetry-pr-dashboard]

Pull request dashboard status

Merged · refreshed 2026-11-03 22:03 UTC

Status above doesn't look right?

• Anything look wrong? Report it with what you expected; it helps us improve the dashboard.

[otelbot]

⚠️ API changes detected — additional maintainer review required

@jack-berg @jkwatson

This PR modifies the public API surface area of the following module(s):

• opentelemetry-sdk-testing

Please review the changes in docs/apidiffs/current_vs_latest/ carefully before approving.

[Copilot]

🟢 Approval recommended

There are no active review issues for the new fluent metric assertion shortcuts.

No open issues 🎉

What changed in this PR

Adds fluent, typed point assertions directly to MetricAssert, reducing nested callbacks while preserving existing type-level assertions and matching behavior.

Changes:

• Adds varargs and iterable shortcuts for all seven metric types, returning MetricAssert for continued chaining.
• Tests chaining, any-order and exact matching, mismatched points, and null and wrong-type failures.
• Updates the API compatibility report with the new overloads.

File	Description
sdk/​testing/​src/​test/​java/​io/​opentelemetry/​sdk/​testing/​assertj/​MetricAssertionsTest.java	Tests the shortcuts and their success and failure behavior.
sdk/​testing/​src/​main/​java/​io/​opentelemetry/​sdk/​testing/​assertj/​MetricAssert.java	Adds 14 fluent overloads delegating to existing typed assertions.
docs/​apidiffs/​current_vs_latest/​opentelemetry-sdk-testing.txt	Records the new public assertion methods.

_{Review effort: Balanced}

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 90.38%. Comparing base (dc3019e) to head (e84f018).

Additional details and impacted files

@@             Coverage Diff              @@
##               main    #8994      +/-   ##
============================================
+ Coverage     90.36%   90.38%   +0.02%     
- Complexity    10995    11012      +17     
============================================
  Files          1020     1020              
  Lines         30096    30112      +16     
  Branches       3929     3929              
============================================
+ Hits          27197    27218      +21     
+ Misses         1942     1937       -5     
  Partials        957      957              

☔ View full report in Codecov by Harness.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

[jack-berg]

Looks good to me. Tried out the new APIs locally on some metric tests and the assertions become flatter and more readable.