Skip to content

Conversation

@aviralgarg05
Copy link

Description

This commit addresses issue #14111 by documenting the investigation into performance change detection tooling for the OpenTelemetry Collector.

Changes:

  • Created comprehensive performance-benchmarking.md guide covering:
    • Running benchmarks locally (make gobenchmark, timebenchmark)
    • Writing benchmark tests following Go conventions
    • CodSpeed continuous performance monitoring integration
    • Best practices for performance-sensitive code changes
    • Troubleshooting common benchmark issues
  • Updated CONTRIBUTING.md with Performance Testing section
  • Added changelog entry documenting the enhancement

The investigation found that CodSpeed (integrated in PR #14160) provides continuous performance regression detection on all PRs and commits to main, with <1% variance and commit-level differential flamegraphs.

This documentation enables contributors to understand the performance testing infrastructure and follow best practices when making changes that could affect collector performance.

Link to tracking issue

Fixes #14111

Testing

NA

Documentation

Created Performance Benchmarking Guide
File: docs/performance-benchmarking.md
Updated CONTRIBUTING.md
File: CONTRIBUTING.md

This commit addresses issue open-telemetry#14111 by documenting the investigation
into performance change detection tooling for the OpenTelemetry Collector.

Changes:
- Created comprehensive performance-benchmarking.md guide covering:
  * Running benchmarks locally (make gobenchmark, timebenchmark)
  * Writing benchmark tests following Go conventions
  * CodSpeed continuous performance monitoring integration
  * Best practices for performance-sensitive code changes
  * Troubleshooting common benchmark issues
- Updated CONTRIBUTING.md with Performance Testing section
- Added changelog entry documenting the enhancement

The investigation found that CodSpeed (integrated in PR open-telemetry#14160) provides
continuous performance regression detection on all PRs and commits to main,
with <1% variance and commit-level differential flamegraphs.

This documentation enables contributors to understand the performance
testing infrastructure and follow best practices when making changes
that could affect collector performance.
@aviralgarg05 aviralgarg05 requested a review from a team as a code owner November 29, 2025 10:47
@linux-foundation-easycla
Copy link

linux-foundation-easycla bot commented Nov 29, 2025

CLA Signed
The committers listed above are authorized under a signed CLA.

  • ✅ login: aviralgarg05 / name: Aviral Garg (6b93093)

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Investigate tooling to help identify performance changes

1 participant