Changelog

Bump deps

Refactored microservice examples

[ADD] Example rpg-service with instrumented database access

Bump deps

[FIX] Queried header names in context propagator text maps (for manually instrumented applications) should be lower-cased. Previously, b3multi and xray propagators would fail because header names in Ring request maps are lower-cased but the queried header name may not.

[ADD] Module clj-otel-sdk-common which wraps the OpenTelemetry SDK common library.

[BREAK] Moved function merge-resources-with-default to new module clj-otel-sdk-common.

[ADD] Terse syntax alternatives for span-opts map parameter in new-span! and related functions that create spans.

[ADD] Convenience function add-event! to add an event to the bound or current span.

[ADD] Populate err.type trace semantic attribute on manually created client and server spans.

[ADD] Middleware wrap-compojure-route that adds the matched Compojure route to the server span and request map.

[MAINT] Ensure example microservices uberjars are built and run on the same JDK.

Bump deps

[ADD] Module clj-otel-sdk-extension-autoconfigure which wraps the autoconfigure OpenTelemetry SDK extension. Updated guide on using the autoconfigure module and adding initialisation code to application.

[ADD] Updated functions to use a default OpenTelemetry instance declared by clj-otel, falling back to the global OpenTelemetry instance declared by Java OpenTelemetry if no default instance was previously configured. Added recommendation to prefer use of default OpenTelemetry instance over the global OpenTelemetry instance, when using autoconfigure module or programmatic configuration of SDK. Use of system property otel.java.global-autoconfigure.enabled or environment variable OTEL_JAVA_GLOBAL_AUTOCONFIGURE_ENABLED is discouraged.

[BREAK] steffan-westcott.clj-otel.sdk.otel-sdk/init-otel-sdk! has a new option register-shutdown-hook enabled by default.

[ADD] New middleware (formerly part of the microservices examples)

[ADD] New interceptor exception-event-interceptor adds an exception event to the server span. This is intended for use by applications which transform the exception to an HTTP response in a subsequent interceptor.

[ADD] Function steffan-westcott.clj-otel.instrumentation.runtime-telemetry-java8/close! to stop JVM telemetry. steffan-westcott.clj-otel.instrumentation.runtime-telemetry-java8/register! now returns a collection of AutoCloseable.

[MAINT] Removed :dev alias for development.

[MAINT] Reworked examples to be easier to run. Added load generator applications to microservices examples.

Bump deps:

[ADD] Support for programmatic configuration of MeterProvider for metrics export.

[ADD] Module clj-otel-exporter-prometheus for programmatic configuration of metrics export to Prometheus

[FIX] steffan-westcott.clj-otel.util/duration should convert [amount ^TimeUnit unit] to Duration

Bump deps:

[ADD] Opt-in feature bound context, a Clojure dynamic var that overrides the default context or parent parameter value for clj-otel functions. This feature is intended to simplify asynchronous code by eliminating explicit context passing. Existing code that uses the current context or explicit context parameter values is unaffected.

[FIX] Convert key names of entries added to OpenTelemetry attributes to snake_case. This applies to resources, spans and metrics.

[FIX] Do not transform key names of entries added to OpenTelemetry context or baggage.

[ADD] Function set-attribute-name-fn! to override setting of OpenTelemetry attribute key names.

[MAINT] Remove Jaeger exporters from examples, since they will be deprecated soon. The Jaeger Collector now accepts OTLP directly. See the Jaeger clients deprecation notice.

Bump deps:

[FIX] Use . instead of / in namespace qualified attribute names

[MAINT] Removed deprecated build dep build-clj

Bump deps:

[ADD] Support for Metrics API

[ADD] Implementations of the following HTTP server metrics for use by applications not run with the OpenTelemetry instrumentation agent:

[BREAK] The parameters for function add-route-data! have changed, there is a new parameter to specify the HTTP request method.

[BREAK] The pattern for using clj-otel middleware and interceptors in applications has been revised. The revised pattern adds new middleware wrap-route, wrap-active-requests and wrap-metrics-by-route and interceptors route-interceptor, active-requests-interceptor and metrics-by-route-interceptors to capture matched routes in HTTP server spans and HTTP server metrics. The pattern also ensures all requests are recorded, including those which do not match any route.

[ADD] Module clj-otel-instrumentation-runtime-metrics to provide access to JVM runtime metrics instrumentation for applications not using the OpenTelemetry instrumentation agent.

[ADD] Aliases in examples

Bump deps:

Bump deps:

[ADD] Support for including source code semantic attributes when creating spans. By default, attributes identifying the namespace, line number and source file path are included in spans created by with-span!, with-span-binding, and async-span.

[ADD] Update Pedestal HTTP server span support to always add route data to server spans

Bump deps:

Bump deps:

[ADD] Include ExceptionInfo data as attributes in exception span events, by default

[FIX] Update examples to use namespaced attributes for spans and events

Bump deps:

Bump deps:

Initial release