You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@camel.apache.org by pc...@apache.org on 2026/04/22 08:31:11 UTC

(camel) branch main updated (343a1f7ba890 -> 772a51138121)

This is an automated email from the ASF dual-hosted git repository.

squakez pushed a change to branch main
in repository https://gitbox.apache.org/repos/asf/camel.git


    from 343a1f7ba890 CAMEL-23350 - upgrade Maven daemon to 1.0.5
     new 6b7e7c540fbf Document how to configure and use opentelemetry-spring-boot-starter as an alternative to the OpenTelemetry agent.
     new e9aef4e4fee4 Added clarifying notes for the OpenTelemetry BOM import.
     new af53045d0a58 Update components/camel-opentelemetry2/src/main/docs/opentelemetry2.adoc
     new 772a51138121 Corrected clarifying notes for the OpenTelemetry BOM import.

The 4 revisions listed above as "new" are entirely new to this
repository and will be described in separate emails.  The revisions
listed as "add" were already present in the repository and have only
been added to this reference.


Summary of changes:
 .../src/main/docs/opentelemetry2.adoc              | 75 ++++++++++++++++++++++
 1 file changed, 75 insertions(+)


(camel) 04/04: Corrected clarifying notes for the OpenTelemetry BOM import.

Posted by pc...@apache.org.
This is an automated email from the ASF dual-hosted git repository.

squakez pushed a commit to branch main
in repository https://gitbox.apache.org/repos/asf/camel.git

commit 772a51138121c34768c2be425200467d3a809ac8
Author: Bjorn Beskow <bb...@callistaenterprise.se>
AuthorDate: Tue Apr 21 10:43:49 2026 +0200

    Corrected clarifying notes for the OpenTelemetry BOM import.
---
 components/camel-opentelemetry2/src/main/docs/opentelemetry2.adoc | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/components/camel-opentelemetry2/src/main/docs/opentelemetry2.adoc b/components/camel-opentelemetry2/src/main/docs/opentelemetry2.adoc
index a9fe8e799466..5c06dd31bb50 100644
--- a/components/camel-opentelemetry2/src/main/docs/opentelemetry2.adoc
+++ b/components/camel-opentelemetry2/src/main/docs/opentelemetry2.adoc
@@ -116,8 +116,7 @@ As an alternative, you can use the agent's built-in MDC integration.
 An alternative to the OpenTelemetry agent is to use https://opentelemetry.io/docs/zero-code/java/spring-boot-starter/[OpenTelemetry Spring Boot starter].
 
 To ensure version alignment across all OpenTelemetry dependencies, you should
-import the opentelemetry-instrumentation-bom BOM (choose a version that aligns with
-the Opentelemetry dependencies that are used within the given Camel version used).
+import the opentelemetry-instrumentation-bom BOM.
 
 [source,xml]
 ----


(camel) 01/04: Document how to configure and use opentelemetry-spring-boot-starter as an alternative to the OpenTelemetry agent.

Posted by pc...@apache.org.
This is an automated email from the ASF dual-hosted git repository.

squakez pushed a commit to branch main
in repository https://gitbox.apache.org/repos/asf/camel.git

commit 6b7e7c540fbfeb3df6cbcdfa4931fb1996234f52
Author: Bjorn Beskow <bb...@callistaenterprise.se>
AuthorDate: Fri Apr 17 17:25:09 2026 +0200

    Document how to configure and use opentelemetry-spring-boot-starter as an alternative to the OpenTelemetry agent.
---
 .../src/main/docs/opentelemetry2.adoc              | 72 ++++++++++++++++++++++
 1 file changed, 72 insertions(+)

diff --git a/components/camel-opentelemetry2/src/main/docs/opentelemetry2.adoc b/components/camel-opentelemetry2/src/main/docs/opentelemetry2.adoc
index c07087421106..bb502de4e438 100644
--- a/components/camel-opentelemetry2/src/main/docs/opentelemetry2.adoc
+++ b/components/camel-opentelemetry2/src/main/docs/opentelemetry2.adoc
@@ -110,6 +110,78 @@ As an alternative, you can use the agent's built-in MDC integration.
 . Enable the https://github.com/open-telemetry/opentelemetry-java-instrumentation/blob/main/docs/logger-mdc-instrumentation.md[Logger MDC auto-instrumentation]. This automatically adds `trace_id` and `span_id` to the MDC.
 . Configure your logging framework to include these MDC keys in your log format. The exact configuration depends on the logging library you use.
 
+[[OpenTelemetry-SpringBoot-starter]]
+=== Using the OpenTelemetry Spring Boot starter
+
+An alternative to the OpenTelemetry agent is to use https://opentelemetry.io/docs/zero-code/java/spring-boot-starter/[OpenTelemetry Spring Boot starter].
+
+To ensure version alignment across all OpenTelemetry dependencies, you should
+import the opentelemetry-instrumentation-bom BOM:
+
+[source,xml]
+----
+<dependencyManagement>
+    <dependencies>
+        <dependency>
+            <groupId>io.opentelemetry.instrumentation</groupId>
+            <artifactId>opentelemetry-instrumentation-bom</artifactId>
+            <version>2.26.1</version>
+            <type>pom</type>
+            <scope>import</scope>
+        </dependency>
+    </dependencies>
+</dependencyManagement>
+----
+
+Then add the following dependency for the OpenTelemetry Spring Boot starter:
+
+[source,xml]
+----
+<dependency>
+    <groupId>io.opentelemetry.instrumentation</groupId>
+    <artifactId>opentelemetry-spring-boot-starter</artifactId>
+</dependency>
+----
+
+The starter auto-configures most aspects of the OpenTelemetry instrumentation, with two exceptions:
+No `Tracer` or `ContextPropagators` beans are autoconfigured, they need to be configured manually:
+
+[source,java]
+----
+import io.opentelemetry.api.OpenTelemetry;
+import io.opentelemetry.api.trace.Tracer;
+import io.opentelemetry.context.propagation.ContextPropagators;
+
+@Configuration
+public class OpenTelemetryConfiguration {
+
+  @Bean
+  public Tracer tracer(@Value("${spring.application.name}") String serviceName, OpenTelemetry openTelemetry) {
+    return openTelemetry.getTracer(serviceName);
+  }
+
+  @Bean
+  public ContextPropagators contextPropagators(OpenTelemetry openTelemetry) {
+    return openTelemetry.getPropagators();
+  }
+
+}
+----
+
+The instrumentation can be configured using the standard Spring Boot configuration mechanisms (e.g. using application.yml).
+For a complete list of options, see the official https://opentelemetry.io/docs/zero-code/java/agent/configuration/[agent configuration documentation].
+
+For example, to set the service name and exporter type:
+
+[source,yaml]
+----
+otel:
+  service:
+    name: your-service-name
+  traces:
+    exporter: otlp
+----
+
 === Span customization
 
 When you're working at a very low level, you may need to tweak your metrics and add some in-process custom `span` in order to trace some specific measure of your application. If you need this advanced use case, you can create it during your process by configuring an Opentelemetry Tracer object and share it to your route. For example, in Java DSL:


(camel) 02/04: Added clarifying notes for the OpenTelemetry BOM import.

Posted by pc...@apache.org.
This is an automated email from the ASF dual-hosted git repository.

squakez pushed a commit to branch main
in repository https://gitbox.apache.org/repos/asf/camel.git

commit e9aef4e4fee46084d0746ca5f8edf99b4d250a20
Author: Bjorn Beskow <bb...@callistaenterprise.se>
AuthorDate: Mon Apr 20 21:03:08 2026 +0200

    Added clarifying notes for the OpenTelemetry BOM import.
---
 components/camel-opentelemetry2/src/main/docs/opentelemetry2.adoc | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/components/camel-opentelemetry2/src/main/docs/opentelemetry2.adoc b/components/camel-opentelemetry2/src/main/docs/opentelemetry2.adoc
index bb502de4e438..2deaeecad883 100644
--- a/components/camel-opentelemetry2/src/main/docs/opentelemetry2.adoc
+++ b/components/camel-opentelemetry2/src/main/docs/opentelemetry2.adoc
@@ -116,7 +116,8 @@ As an alternative, you can use the agent's built-in MDC integration.
 An alternative to the OpenTelemetry agent is to use https://opentelemetry.io/docs/zero-code/java/spring-boot-starter/[OpenTelemetry Spring Boot starter].
 
 To ensure version alignment across all OpenTelemetry dependencies, you should
-import the opentelemetry-instrumentation-bom BOM:
+import the opentelemetry-instrumentation-bom BOM (choose a version that aligns with
+the Opentelemetry dependencies that are used within the given Camel version used).
 
 [source,xml]
 ----
@@ -133,6 +134,9 @@ import the opentelemetry-instrumentation-bom BOM:
 </dependencyManagement>
 ----
 
+Note: Import the OpenTelemetry BOMs before any other BOMs in your project. For example, if you
+import the spring-boot-dependencies BOM, you have to declare it after the OpenTelemetry BOMs.
+
 Then add the following dependency for the OpenTelemetry Spring Boot starter:
 
 [source,xml]


(camel) 03/04: Update components/camel-opentelemetry2/src/main/docs/opentelemetry2.adoc

Posted by pc...@apache.org.
This is an automated email from the ASF dual-hosted git repository.

squakez pushed a commit to branch main
in repository https://gitbox.apache.org/repos/asf/camel.git

commit af53045d0a58b018f01aac1a51218c654f849500
Author: Björn Beskow <bb...@gmail.com>
AuthorDate: Tue Apr 21 10:40:38 2026 +0200

    Update components/camel-opentelemetry2/src/main/docs/opentelemetry2.adoc
    
    Co-authored-by: Pasquale Congiusti <pa...@gmail.com>
---
 components/camel-opentelemetry2/src/main/docs/opentelemetry2.adoc | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/components/camel-opentelemetry2/src/main/docs/opentelemetry2.adoc b/components/camel-opentelemetry2/src/main/docs/opentelemetry2.adoc
index 2deaeecad883..a9fe8e799466 100644
--- a/components/camel-opentelemetry2/src/main/docs/opentelemetry2.adoc
+++ b/components/camel-opentelemetry2/src/main/docs/opentelemetry2.adoc
@@ -135,7 +135,7 @@ the Opentelemetry dependencies that are used within the given Camel version used
 ----
 
 Note: Import the OpenTelemetry BOMs before any other BOMs in your project. For example, if you
-import the spring-boot-dependencies BOM, you have to declare it after the OpenTelemetry BOMs.
+import the spring-boot-dependencies BOM, you have to declare it after the OpenTelemetry BOMs. Also make sure that the version you choose is compatible with the Opentelemetry version used by the Camel version you're using.
 
 Then add the following dependency for the OpenTelemetry Spring Boot starter: