Package akka.javasdk

Interface UnhandledExceptionContext

public interface UnhandledExceptionContext
Information about an exception thrown by user code that the runtime caught and turned into a generic 500 response with a correlation id.

Passed to UnhandledExceptionHandler.onUnhandledException(UnhandledExceptionContext).

  • Method Summary

    Modifier and Type
    Method
    Description
    String
    componentClassName()
    Fully-qualified class name of the user component the exception originated in.
    String
    componentId()
    Identifier for the component the exception originated in.
    String
    correlationId()
    The correlation id surfaced to the client and present in the runtime log MDC at the time the exception was caught.
    Optional<String>
    subjectId()
    The entity, workflow or agent id when the exception originated in a stateful component.
    Throwable
    throwable()
    The original throwable thrown by user code, with its full stack trace and causes.

  • Method Details

    • throwable

      Throwable throwable()
      The original throwable thrown by user code, with its full stack trace and causes.

    • correlationId

      String correlationId()
      The correlation id surfaced to the client and present in the runtime log MDC at the time the exception was caught. Useful for correlating the error tracker event with runtime logs.

    • subjectId

      Optional<String> subjectId()
      The entity, workflow or agent id when the exception originated in a stateful component. Empty for endpoints and other stateless components.

    • componentId

      String componentId()
      Identifier for the component the exception originated in. For components declaring a Component.id(), this is the annotation value. For endpoints (HTTP, gRPC, MCP) which have no @ComponentId, this falls back to the simple class name.

    • componentClassName

      String componentClassName()
      Fully-qualified class name of the user component the exception originated in.