Merge pull request #46447 from brunobat/doc-improvements-otel-logging

Improvements to OTel logging docs

Author: brunobat

docs/src/main/asciidoc/opentelemetry.adoc

@@ -144,6 +144,21 @@ If false will disable the default OTLP exporter at *build* time.
 |`quarkus.otel.metrics.exporter`
 |cdi
 |List of exporters to be used for metrics, separated by commas. Has one of the values from _ExporterType_: `otlp`, `cdi`, `none`. This is a *build* time property and setting it to `none` will disable metrics data output.
+
+| Logs
+|`quarkus.otel.logs.enabled`
+|false
+|Logs are disabled by default at *build* time because they are experimental.
+
+| Logs output
+|`quarkus.otel.logs.exporter`
+|cdi
+|List of exporters to be used for logs, separated by commas. Has one of the values from _ExporterType_: `otlp`, `cdi`, `none`. This is a *build* time property and setting it to `none` will disable logs data output.
+
+| Logs output
+|`quarkus.otel.logs.handler.enabled`
+|true
+|If false, disable the OpenTelemetry logs handler at *runtime*. This removes the bridge between the Quarkus logging system (JBoss LogManager) and OpenTelemetry logs.
 |===
 
 If you need to enable or disable the exporter at runtime, you can use the xref:opentelemetry-tracing.adoc#sampler[sampler] because it has the ability to filter out all the spans if needed.

extensions/opentelemetry/runtime/src/main/java/io/quarkus/opentelemetry/runtime/config/runtime/BatchLogRecordProcessorConfig.java

@@ -10,16 +10,16 @@
 public interface BatchLogRecordProcessorConfig {
 
     /**
-     * The interval, in milliseconds, between two consecutive exports.
+     * The Batch Log Record Processor interval {@link Duration} between two consecutive exports.
      * <p>
-     * Default is `1000`.
+     * Default is `1S`.
      */
     @WithName("schedule.delay")
     @WithDefault("1s")
     Duration scheduleDelay();
 
     /**
-     * The maximum queue size.
+     * The Batch Log Record Processor maximum queue size.
      * <p>
      * Default is `2048`.
      */
@@ -28,7 +28,7 @@ public interface BatchLogRecordProcessorConfig {
     Integer maxQueueSize();
 
     /**
-     * The maximum batch size.
+     * The Batch Log Record Processor maximum batch size.
      * <p>
      * Default is `512`.
      */
@@ -37,7 +37,7 @@ public interface BatchLogRecordProcessorConfig {
     Integer maxExportBatchSize();
 
     /**
-     * The maximum allowed time, in milliseconds, to export data.
+     * The Batch Log Record Processor maximum allowed time {@link Duration} to export data.
      * <p>
      * Default is `30s`.
      */

extensions/opentelemetry/runtime/src/main/java/io/quarkus/opentelemetry/runtime/config/runtime/BatchSpanProcessorConfig.java

@@ -10,16 +10,16 @@
 public interface BatchSpanProcessorConfig {
 
     /**
-     * The interval, in milliseconds, between two consecutive exports.
+     * The Batch Span Processor interval {@link Duration} between two consecutive exports.
      * <p>
-     * Default is `5000`.
+     * Default is `5s`.
      */
     @WithName("schedule.delay")
     @WithDefault("5s")
     Duration scheduleDelay();
 
     /**
-     * The maximum queue size.
+     * The Batch Span Processor maximum queue size.
      * <p>
      * Default is `2048`.
      */
@@ -28,7 +28,7 @@ public interface BatchSpanProcessorConfig {
     Integer maxQueueSize();
 
     /**
-     * The maximum batch size.
+     * The Batch Span Processor maximum batch size.
      * <p>
      * Default is `512`.
      */
@@ -37,7 +37,7 @@ public interface BatchSpanProcessorConfig {
     Integer maxExportBatchSize();
 
     /**
-     * The maximum allowed time, in milliseconds, to export data.
+     * The Batch Span Processor maximum allowed time {@link Duration} to export data.
      * <p>
      * Default is `30s`.
      */