New to Akka? Start with the Akka SDK.

Release notes

Akka Insights 2.22

Migration Guide: Migration guide for Akka Insights 2.22

This release of Akka Insights (Cinnamon) adds exclusive support for Akka 25.10.

Note

From Cinnamon 2.18 onward, each Cinnamon release will only support a single Akka release.

See Akka module versions for 25.10.

The following versions of Scala and Java are supported:

  • Scala 2.13 and 3.3
  • Java 11, 17, 21, and 25.

New features in Akka Insights 2.22

Bug fixes in Akka Insights 2.22

  • Fix an issue where metrics for actor mailbox and stash sizes were not handled correctly when threshold events were enabled.
  • The cinnamon-opentelemetry backend no longer depends on OpenTelemetry’s incubating events API (EventLogger), which was removed in OpenTelemetry 1.47.0. This allows applications to upgrade to a current OpenTelemetry release without the backend failing to start with a NoClassDefFoundError. Events are now emitted through the stable OpenTelemetry logs API.
  • Hardened OpenTracing span completion: an exception thrown by the configured tracer while finishing a span (e.g. reporter/serializer failures) is now caught and logged instead of propagating into the instrumented call site, where it could previously fail shared Akka HTTP stages and take down unrelated in-flight requests.
Behavior change: OpenTelemetry event payload

As part of moving off the removed incubating events API, the data map passed when an event is fired is now recorded as attributes on the emitted log record, rather than in the log record body (which the incubating API used). The event.name attribute and severity are unchanged. Adjust any log/event pipelines that read this payload from the record body.

Behavior change: OpenTelemetry OTLP exporter retries

As of OpenTelemetry 1.62, OTLP exporters enable a default retry policy (5 attempts, 1s–5s backoff, ×1.5). Previously no retry was applied unless explicitly configured. Cinnamon’s cinnamon.opentelemetry.{metrics,logs} OTLP exporters inherit this default; set retry-policy explicitly to override it.

Previous release notes

Akka Insights 2.21 release notes