This is an automated email from the ASF dual-hosted git repository.
davsclaus pushed a commit to branch main
in repository https://gitbox.apache.org/repos/asf/camel.git
The following commit(s) were added to refs/heads/main by this push:
new bed32b3b5446 CAMEL-26490: docs - add the span attribute upgrade note
to the 4.22.3 and 4.18.6 sections of the upgrade guides on main (#29051)
bed32b3b5446 is described below
commit bed32b3b5446a91ca835b1f7833837fcf580d50d
Author: Claus Ibsen <[email protected]>
AuthorDate: Tue Nov 3 09:11:59 2026 +0100
CAMEL-26490: docs - add the span attribute upgrade note to the 4.22.3 and
4.18.6 sections of the upgrade guides on main (#29051)
The backports (#28994, #28995) added the note to the 4_22 and 4_18 upgrade
guides on the maintenance branches. main holds the upgrade guides of every
release line, so the note goes there as well.
Signed-off-by: Claus Ibsen <[email protected]>
Co-authored-by: Claude Opus 5.5 <[email protected]>
---
.../modules/ROOT/pages/camel-4x-upgrade-guide-4_18.adoc | 17 +++++++++++++++++
.../modules/ROOT/pages/camel-4x-upgrade-guide-4_22.adoc | 17 +++++++++++++++++
2 files changed, 34 insertions(+)
diff --git
a/docs/user-manual/modules/ROOT/pages/camel-4x-upgrade-guide-4_18.adoc
b/docs/user-manual/modules/ROOT/pages/camel-4x-upgrade-guide-4_18.adoc
index 7348254e86fd..1603524c35a5 100644
--- a/docs/user-manual/modules/ROOT/pages/camel-4x-upgrade-guide-4_18.adoc
+++ b/docs/user-manual/modules/ROOT/pages/camel-4x-upgrade-guide-4_18.adoc
@@ -594,6 +594,23 @@ The generated Endpoint DSL header accessors on the Swift
`HeaderNameBuilder` are
`openstackSwiftVersionsLocation()`, `xContainerRead()` ->
`openstackSwiftContainerRead()`, `xContainerWrite()` ->
`openstackSwiftContainerWrite()`).
+=== camel-telemetry, camel-tracing - the http.url, url.path and server.address
span attributes are presented like camel.uri
+
+This applies to `camel-opentelemetry2`, `camel-micrometer-observability`,
`camel-telemetry-dev`, `camel-opentelemetry`
+and `camel-observation`. The `http.url`, `url.path` and `server.address`
attributes of a span are now presented the same
+way as the `camel.uri` attribute, which shows the endpoint URI as
`Endpoint.toString()` does:
+
+* `http.url`, when the message has neither a `CamelHttpUrl` nor a
`CamelHttpUri` header, is now the HTTP address the
+ endpoint sends to, with the query parameters it sends but without the Camel
endpoint options. Before, it was the
+ endpoint URI from the last `http:` onwards, with all the endpoint options. A
`camel-http` endpoint with an `https`
+ address now sets the attribute as well, and for a `camel-vertx-http`
endpoint with an `https` address the value no
+ longer starts with `http://https://`.
+* `url.path` no longer includes the user info in front of the host of the
endpoint URI.
+* `server.address`, and `http.url` taken from the `CamelHttpUrl` or
`CamelHttpUri` header, are presented as `camel.uri`
+ is.
+
+Dashboards or queries that use the old values may need a change.
+
== Upgrading from 4.18.4 to 4.18.5
=== camel-azure-eventhubs
diff --git
a/docs/user-manual/modules/ROOT/pages/camel-4x-upgrade-guide-4_22.adoc
b/docs/user-manual/modules/ROOT/pages/camel-4x-upgrade-guide-4_22.adoc
index 1dcd49a6d72e..9b14837eb472 100644
--- a/docs/user-manual/modules/ROOT/pages/camel-4x-upgrade-guide-4_22.adoc
+++ b/docs/user-manual/modules/ROOT/pages/camel-4x-upgrade-guide-4_22.adoc
@@ -445,6 +445,23 @@ The generated Endpoint DSL header accessors on the Swift
`HeaderNameBuilder` are
`openstackSwiftVersionsLocation()`, `xContainerRead()` ->
`openstackSwiftContainerRead()`, `xContainerWrite()` ->
`openstackSwiftContainerWrite()`).
+=== camel-telemetry, camel-tracing - the http.url, url.path and server.address
span attributes are presented like camel.uri
+
+This applies to `camel-opentelemetry2`, `camel-micrometer-observability`,
`camel-telemetry-dev`, `camel-opentelemetry`
+and `camel-observation`. The `http.url`, `url.path` and `server.address`
attributes of a span are now presented the same
+way as the `camel.uri` attribute, which shows the endpoint URI as
`Endpoint.toString()` does:
+
+* `http.url`, when the message has neither a `CamelHttpUrl` nor a
`CamelHttpUri` header, is now the HTTP address the
+ endpoint sends to, with the query parameters it sends but without the Camel
endpoint options. Before, it was the
+ endpoint URI from the last `http:` onwards, with all the endpoint options. A
`camel-http` endpoint with an `https`
+ address now sets the attribute as well, and for a `camel-vertx-http`
endpoint with an `https` address the value no
+ longer starts with `http://https://`.
+* `url.path` no longer includes the user info in front of the host of the
endpoint URI.
+* `server.address`, and `http.url` taken from the `CamelHttpUrl` or
`CamelHttpUri` header, are presented as `camel.uri`
+ is.
+
+Dashboards or queries that use the old values may need a change.
+
== Upgrading from 4.22.1 to 4.22.2
=== camel-lra - only an LRA hosted by the configured coordinator is joined
