[xscraperhelper] init package

[florianl]

Description

Along with scraper/xscraper this package is needed to enable OTel Profiling signal receivers, such as receiver/pprofreceiver.

Link to tracking issue

Fixes #

Testing

Documentation

[codspeed-hq]

Merging this PR will not alter performance

⚠️ Unknown Walltime execution environment detected

Using the Walltime instrument on standard Hosted Runners will lead to inconsistent data.

For the most accurate results, we recommend using CodSpeed Macro Runners: bare-metal machines fine-tuned for performance measurement consistency.

Summary

✅ 62 untouched benchmarks
⏩ 20 skipped benchmarks¹

---

_{Comparing florianl:xscraperhelper (5f888fd) with main (4db9157)}

Footnotes

1. 20 benchmarks were skipped, so the baseline results were used instead. If they were deleted from the codebase, click here and archive them to remove them from the performance reports. ↩

[codecov]

Codecov Report

❌ Patch coverage is 97.16599% with 7 lines in your changes missing coverage. Please review.
✅ Project coverage is 92.23%. Comparing base (4db9157) to head (5f888fd).
⚠️ Report is 10 commits behind head on main.

Files with missing lines	Patch %	Lines
...er/scraperhelper/internal/controller/controller.go	95.00%	2 Missing and 1 partial ⚠️
...craper/scraperhelper/internal/testhelper/helper.go	94.44%	2 Missing ⚠️
...perhelper/internal/metadata/generated_telemetry.go	93.33%	1 Missing and 1 partial ⚠️

Additional details and impacted files

@@            Coverage Diff             @@
##             main   #14235      +/-   ##
==========================================
+ Coverage   92.21%   92.23%   +0.02%     
==========================================
  Files         670      676       +6     
  Lines       41472    41641     +169     
==========================================
+ Hits        38242    38407     +165     
- Misses       2193     2196       +3     
- Partials     1037     1038       +1     

☔ View full report in Codecov by Sentry.
📢 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.

[jade-guiton-dd]

It looks like xscraperhelper duplicates a lot of code from scraperhelper, which is probably why the PR is so large. This is not ideal, since it makes maintenance a lot more difficult (any change in scraperhelper would have to be copied over to xscraperhelper). I think a better approach would be to move the "generic" components used in all signals into scraperhelper/internal/xxx packages, so that you can reuse them in scraperhelper/xscraperhelper without duplicating their code.

[florianl]

@jade-guiton-dd with 92bc761 I have started to deduplicate code. But the win of deduplication is limited.

While it seems that a good portion of code is duplicate, they differ in essential elements, like receiver vs xreceiver, consumer vs xconsumer, scraper vs xscraper. Due to these fundamental differences, there seems to be a huge overlapp but it is actually not.

[jade-guiton-dd]

I think this looks good, just one more issue.

I'll ask if another maintainer can take a look.

[jade-guiton-dd]

LGTM. I'd like a second approval on this before merging however, since it's a fairly large PR.

[atoulme]

lgtm