How to change span name for handle request spans?

[andrew-demb]

Summary

OpenTelemetry docs states, that span name should not contain variables to avoid high cardinality [1]. But NextJS uses a default span name like "GET /requested/pathname".

I read the documentation [2] which states, that NextJS can use route patterns as a part of span tags and mentioned the same wording ("next route") for root span about handling requests.

next.route - The route pattern of the request (e.g., /[param]/user).
But searching in code about generating span logic leads to this - [3], which uses req.url (not route) and I can't find a way how to override span name.

Questions:

1. How can I change the default logic?
2. Is it intended - to use the request URL in the span name, but not the route name/pattern?

[1] https://github.com/open-telemetry/opentelemetry-specification/blob/v1.28.0/specification/trace/api.md#span

[2] https://github.com/vercel/next.js/blob/v14.0.5-canary.13/docs/02-app/01-building-your-application/06-optimizing/08-open-telemetry.mdx#L218
[3]

next.js/packages/next/src/server/base-server.ts

Lines 791 to 797 in 05eb811

	{
	spanName: `${method} ${req.url}`,
	kind: SpanKind.SERVER,
	attributes: {
	'http.method': method,
	'http.target': req.url,
	},

Additional information

No response

Example

No response

[devjiwonchoi]

HTTP span names SHOULD be {method} {target} if there is a (low-cardinality) target available. If there is no (low-cardinality) {target} available, HTTP span names SHOULD be {method}.

x-ref: OTel docs

As the OTel docs recommend, changed the behavior at #75416 to use only the {method} if the available {target} is a high cardinality URL. Sorry for the late response, and thank you for reporting the issue!