Add XXH3 Converter function to converts a value to a XXH3 hash/digest

[Frapschen]

Description

Link to tracking issue

Fixes #42792

Testing

Documentation

[lahsivjar]

LGTM (checked the diff for elasticsearchexporter and signaltometricsconnector)

[edmocosta]

Thank you for working on this, @Frapschen! I've left a few suggestions.

[Frapschen]

@edmocosta Please review

[Frapschen]

wire error:

make --no-print-directory -C pkg/pdatatest lint
Check License finished successfully
running /home/runner/work/opentelemetry-collector-contrib/opentelemetry-collector-contrib/.tools/misspell -error
/home/runner/work/opentelemetry-collector-contrib/opentelemetry-collector-contrib/.tools/golangci-lint run
Error: pkg/ottl/ottlfuncs/func_xxh3.go:34:76: xxh3HashString - result 1 (error) is always nil (unparam)
level=warning msg="[runner/exclusion_paths] The pattern \"third_party\" match no issues"
level=warning msg="[runner/exclusion_rules] Skipped 0 issues by rules: [Text: \"cachedBytes\", Path: \"pagefile.go\", Linters: \"unused\"]"
level=warning msg="[runner/exclusion_rules] Skipped 0 issues by rules: [Path: \"third_party\", Linters: \"gci, gofumpt\"]"
func xxh3HashString[K any](target ottl.StringGetter[K]) (ottl.ExprFunc[K], error) {
                                                                           ^
make[2]: *** [../../Makefile.Common:282: lint] Error 1
make[1]: *** [Makefile:253: pkg/ottl] Error 2
make[1]: *** Waiting for unfinished jobs....
level=warning msg="[runner/exclusion_paths] The pattern \"third_party\" match no issues"
level=warning msg="[runner/exclusion_rules] Skipped 0 issues by rules: [Text: \"cachedBytes\", Path: \"pagefile.go\", Linters: \"unused\"]"
level=warning msg="[runner/exclusion_rules] Skipped 0 issues by rules: [Path: \"third_party\", Linters: \"gci, gofumpt\"]"
make[1]: Leaving directory '/home/runner/work/opentelemetry-collector-contrib/opentelemetry-collector-contrib'
make: *** [Makefile:213: golint] Error 2

I didn't figure out why the xxh3HashString encountered this error; however, the similar SHA1HashString is ok to pass it.

[edmocosta]

wire error:

make --no-print-directory -C pkg/pdatatest lint
Check License finished successfully
running /home/runner/work/opentelemetry-collector-contrib/opentelemetry-collector-contrib/.tools/misspell -error
/home/runner/work/opentelemetry-collector-contrib/opentelemetry-collector-contrib/.tools/golangci-lint run
Error: pkg/ottl/ottlfuncs/func_xxh3.go:34:76: xxh3HashString - result 1 (error) is always nil (unparam)
level=warning msg="[runner/exclusion_paths] The pattern \"third_party\" match no issues"
level=warning msg="[runner/exclusion_rules] Skipped 0 issues by rules: [Text: \"cachedBytes\", Path: \"pagefile.go\", Linters: \"unused\"]"
level=warning msg="[runner/exclusion_rules] Skipped 0 issues by rules: [Path: \"third_party\", Linters: \"gci, gofumpt\"]"
func xxh3HashString[K any](target ottl.StringGetter[K]) (ottl.ExprFunc[K], error) {
                                                                           ^
make[2]: *** [../../Makefile.Common:282: lint] Error 1
make[1]: *** [Makefile:253: pkg/ottl] Error 2
make[1]: *** Waiting for unfinished jobs....
level=warning msg="[runner/exclusion_paths] The pattern \"third_party\" match no issues"
level=warning msg="[runner/exclusion_rules] Skipped 0 issues by rules: [Text: \"cachedBytes\", Path: \"pagefile.go\", Linters: \"unused\"]"
level=warning msg="[runner/exclusion_rules] Skipped 0 issues by rules: [Path: \"third_party\", Linters: \"gci, gofumpt\"]"
make[1]: Leaving directory '/home/runner/work/opentelemetry-collector-contrib/opentelemetry-collector-contrib'
make: *** [Makefile:213: golint] Error 2

I didn't figure out why the xxh3HashString encountered this error; however, the similar SHA1HashString is ok to pass it.

Linter is complaining because the function xxh3HashString[K any](target ottl.StringGetter[K]) (ottl.ExprFunc[K], error) is returning ottl.ExprFunc[K] and error, being the second always nil. To fix that, just drop the error returned by that function, and return nil on the createXXH3Function instead.

[Frapschen]

@edmocosta Done