apm: use url.template for OTLP HTTP client resource names

pkg/trace/otel/traceutil/otel_util_test.go

@@ -406,6 +406,7 @@ func TestGetOTelResource(t *testing.T) {
 		name       string
 		rattrs     map[string]string
 		sattrs     map[string]string
+		spanKind   ptrace.SpanKind
 		normalize  bool
 		expectedV1 string
 		expectedV2 string
@@ -427,6 +428,13 @@ func TestGetOTelResource(t *testing.T) {
 			expectedV1: "GET",
 			expectedV2: "GET",
 		},
+		{
+			name:       "HTTP client method and URL template resource",
+			sattrs:     map[string]string{"http.request.method": "GET", "url.template": "/users/{user_id}"},
+			spanKind:   ptrace.SpanKindClient,
+			expectedV1: "GET",
+			expectedV2: "GET /users/{user_id}",
+		},
 		{
 			name:       "HTTP method and route resource",
 			sattrs:     map[string]string{string(semconv.HTTPMethodKey): "GET", string(semconv.HTTPRouteKey): "/"},
@@ -534,6 +542,7 @@ func TestGetOTelResource(t *testing.T) {
 		t.Run(tt.name, func(t *testing.T) {
 			span := ptrace.NewSpan()
 			span.SetName("span_name")
+			span.SetKind(tt.spanKind)
 			for k, v := range tt.sattrs {
 				span.Attributes().PutStr(k, v)
 			}
@@ -821,6 +830,32 @@ func TestGetOTelResourceV2_HTTPRequestMethodResource(t *testing.T) {
 			spanKind: ptrace.SpanKindClient,
 			expected: "POST",
 		},
+		{
+			name:     "http.request.method with URL template for client",
+			sattrs:   map[string]string{"http.request.method": "POST", "url.template": "/api/users/{user_id}"},
+			spanKind: ptrace.SpanKindClient,
+			expected: "POST /api/users/{user_id}",
+		},
+		{
+			name: "client uses URL template and ignores route",
+			sattrs: map[string]string{
+				"http.request.method":        "POST",
+				"url.template":               "/api/users/{user_id}",
+				string(semconv.HTTPRouteKey): "/api/users/:user_id",
+			},
+			spanKind: ptrace.SpanKindClient,
+			expected: "POST /api/users/{user_id}",
+		},
+		{
+			name: "server uses route and ignores URL template",
+			sattrs: map[string]string{
+				"http.request.method":        "POST",
+				"url.template":               "/api/users/{user_id}",
+				string(semconv.HTTPRouteKey): "/api/users/:user_id",
+			},
+			spanKind: ptrace.SpanKindServer,
+			expected: "POST /api/users/:user_id",
+		},
 		{
 			name:     "http.method (semconv 1.6.1) only",
 			sattrs:   map[string]string{string(semconv.HTTPMethodKey): "DELETE"},

pkg/trace/semantics/mappings.json

@@ -316,6 +316,16 @@
         }
       ]
     },
+    "url.template": {
+      "canonical": "url.template",
+      "fallbacks": [
+        {
+          "name": "url.template",
+          "provider": "otel",
+          "type": "string"
+        }
+      ]
+    },
     "http.status_code": {
       "canonical": "http.status_code",
       "fallbacks": [

pkg/trace/semantics/semantics.go

@@ -58,6 +58,7 @@ const (
 	ConceptHTTPStatusCode Concept = "http.status_code"
 	ConceptHTTPMethod     Concept = "http.method"
 	ConceptHTTPRoute      Concept = "http.route"
+	ConceptURLTemplate    Concept = "url.template"
 	ConceptGRPCStatusCode Concept = "rpc.grpc.status_code"
 	ConceptSpanKind       Concept = "span.kind"
 	ConceptDDBaseService  Concept = "_dd.base_service"

pkg/trace/transform/otelutil.go

@@ -339,13 +339,17 @@ func getOTelResourceV2[A semantics.Accessor](span ptrace.Span, accessor A) (resN
 		return
 	}
 
-	// HTTP: use method + route (if available)
+	// HTTP: use method + URL template for clients or route for servers.
 	if m := lookupString(accessor, semantics.ConceptHTTPMethod, false); m != "" {
 		if m == "_OTHER" {
 			m = "HTTP"
 		}
 		resName = m
-		if span.Kind() == ptrace.SpanKindServer {
+		if span.Kind() == ptrace.SpanKindClient {
+			if template := lookupString(accessor, semantics.ConceptURLTemplate, false); template != "" {
+				resName = resName + " " + template
+			}
+		} else if span.Kind() == ptrace.SpanKindServer {
 			if route := lookupString(accessor, semantics.ConceptHTTPRoute, false); route != "" {
 				resName = resName + " " + route
 			}

releasenotes/notes/apm-otel-http-client-url-template-bb18ccb97dbbbb0b.yaml

@@ -0,0 +1,6 @@
+---
+enhancements:
+  - |
+    APM : Use the OpenTelemetry ``url.template`` attribute in HTTP client
+    resource names when available, while retaining method-only resource names
+    as the fallback.