[Exporter.Prometheus] Improve performance

Draft
MA
6mo ago
+1043-227

Changes

  • Improve the performance of PrometheusSerializer by:
    • Using SearchValues<T> on .NET 8+
    • Writing common label value types directly instead of relying on ToString()
    • Formatting numeric values directly as UTF-8 on .NET 8+
    • Caching serialized metric names, metadata names, units, and static tag prefixes
    • Reusing serialized tags across histogram bucket/sum/count output
    • Use stackalloc for small temporary tag buffers on .NET 8+

Benchmark Results

See https://github.com/open-telemetry/opentelemetry-dotnet/pull/7170#issuecomment-4337589404 for latest results.

Copilot Summary

  • Overall duration: PrometheusSerializer-perf is 0.833x geometric mean versus main.
  • Allocations: unchanged in all 3 cases (0.0% / 1.00x).

Per-config summary

ConfigMethodDuration changeAllocation change
NumberOfSerializeCalls=1WriteMetric-16.1% / 0.839x0.0% / 1.00x
NumberOfSerializeCalls=1000WriteMetric-20.1% / 0.799x0.0% / 1.00x
NumberOfSerializeCalls=10000WriteMetric-13.9% / 0.861x0.0% / 1.00x

Takeaways

PrometheusSerializer-perf shows consistent runtime improvement.

Detailed Results

Expand to view

main


BenchmarkDotNet v0.15.8, Windows 11 (10.0.26200.8246/25H2/2025Update/HudsonValley2)
13th Gen Intel Core i7-13700H 2.90GHz, 1 CPU, 20 logical and 14 physical cores
.NET SDK 10.0.203
  [Host]    : .NET 10.0.7 (10.0.7, 10.0.726.21808), X64 RyuJIT x86-64-v3
  .NET 10.0 : .NET 10.0.7 (10.0.7, 10.0.726.21808), X64 RyuJIT x86-64-v3

Job=.NET 10.0  Runtime=.NET 10.0  Toolchain=net10.0  

MethodNumberOfSerializeCallsMeanErrorStdDevAllocated
WriteMetric13.365 μs0.0672 μs0.1262 μs-
WriteMetric10003,559.816 μs69.3908 μs121.5324 μs-
WriteMetric1000032,891.695 μs582.1268 μs940.0263 μs-

This PR


BenchmarkDotNet v0.15.8, Windows 11 (10.0.26200.8246/25H2/2025Update/HudsonValley2)
13th Gen Intel Core i7-13700H 2.90GHz, 1 CPU, 20 logical and 14 physical cores
.NET SDK 10.0.203
  [Host]    : .NET 10.0.7 (10.0.7, 10.0.726.21808), X64 RyuJIT x86-64-v3
  .NET 10.0 : .NET 10.0.7 (10.0.7, 10.0.726.21808), X64 RyuJIT x86-64-v3

Job=.NET 10.0  Runtime=.NET 10.0  Toolchain=net10.0  

MethodNumberOfSerializeCallsMeanErrorStdDevAllocated
WriteMetric12.823 μs0.0561 μs0.0873 μs-
WriteMetric10002,844.279 μs55.7913 μs97.7139 μs-
WriteMetric1000028,306.433 μs561.5490 μs922.6411 μs-

Merge requirement checklist

  • CONTRIBUTING guidelines followed (license requirements, nullable enabled, static analysis, etc.)
  • Unit tests added/updated
  • Appropriate CHANGELOG.md files updated for non-trivial changes
  • Changes in public API reviewed (if applicable)