Gin exporter: support reading Client IP from custom headers (and make sure proxy is trusted)

[ItalyPaleAle]

With Gin, it's possible to configure the server to read the Client IP from custom headers; examples include X-Real-Ip or CF-Connecting-IP. This PR makes it possible to set as span attribute the same IP that Gin reads.

Additionally, it makes sure that headers such as "X-Forwarded-For" are used only if Gin is configured to trust the upstream server

[linux-foundation-easycla]

The committers listed above are authorized under a signed CLA.

• ✅ login: ItalyPaleAle / name: Alessandro (Ale) Segala (66ab057, 69fc65d, 4b7a39a, d2bac00, 9149000, 0273b8c, e978ded, 5ea8dec, 83866e7, 27ffeda, 66533fe, fe2b800, 2046f0b, 1de3e69, 666002a, 3a07c40, 5cc0025)

[dmathieu]

PS: Also fixed unit tests, where there were assertions inside handlers, which are executed in separate goroutines

Could you split that into another PR, to make things easier to review?

[ItalyPaleAle]

PS: Also fixed unit tests, where there were assertions inside handlers, which are executed in separate goroutines

Could you split that into another PR, to make things easier to review?

Done

[codecov]

Codecov Report

All modified and coverable lines are covered by tests ✅

Project coverage is 67.1%. Comparing base (aaa6d68) to head (666002a).
Report is 2 commits behind head on main.

Additional details and impacted files

@@          Coverage Diff          @@
##            main   #6095   +/-   ##
=====================================
  Coverage   67.0%   67.1%           
=====================================
  Files        194     194           
  Lines      12658   12691   +33     
=====================================
+ Hits        8492    8523   +31     
- Misses      3888    3889    +1     
- Partials     278     279    +1     

Files with missing lines	Coverage Δ
...stful/otelrestful/internal/semconvutil/httpconv.go	96.1% <100.0%> (+<0.1%)	⬆️
...hub.com/emicklei/go-restful/otelrestful/restful.go	100.0% <100.0%> (ø)
...ation/github.com/gin-gonic/gin/otelgin/gintrace.go	82.6% <100.0%> (+0.4%)	⬆️
...gonic/gin/otelgin/internal/semconvutil/httpconv.go	96.1% <100.0%> (+<0.1%)	⬆️
...rilla/mux/otelmux/internal/semconvutil/httpconv.go	96.1% <100.0%> (+<0.1%)	⬆️
...trumentation/github.com/gorilla/mux/otelmux/mux.go	89.4% <100.0%> (ø)
...entation/github.com/labstack/echo/otelecho/echo.go	100.0% <100.0%> (ø)
...ack/echo/otelecho/internal/semconvutil/httpconv.go	96.1% <100.0%> (+<0.1%)	⬆️
...on.v1/otelmacaron/internal/semconvutil/httpconv.go	96.1% <100.0%> (+<0.1%)	⬆️
...ntation/gopkg.in/macaron.v1/otelmacaron/macaron.go	92.3% <100.0%> (ø)
... and 4 more

... and 1 file with indirect coverage changes

[dmathieu]

This will need a changelog entry.

[ItalyPaleAle]

@dmathieu is this PR ready to be merged?

[dmathieu]

PRs need two approvals.

[ItalyPaleAle]

PRs need two approvals.

@dmathieu is there a way I get a review/approval from another person?

[dmathieu]

Ping @open-telemetry/go-approvers for review.

Note that this instrumentation has no owner, and is therefore in the process of being deprecated/removed unless someone steps up to own it (which also explains the lack of reviews).
#6190