Join us live to discuss The Three Jobs of Every Observability Platform on September 21st Is a metrics dashboard "enough" observability? Join us next week to discuss The Three Jobs of Every Observability Platform
Instrumentation/Supported Frameworks

Executor Service Instrumentation #

This module lets you collect metrics from an Executor Service, be it a Thread Pool Executor or a Fork Join Pool. To start tracking an Executor Service you will need to register it with the executors module by calling ExecutorsInstrumentation.instrument(...) as shown below:

  val executor = java.util.concurrent.Executors.newFixedThreadPool(10)
  val instrumented = ExecutorInstrumentation.instrument(executor, "sample-executor")

  // Form this point on, submit tasks to the "instrumented" executor.

You will get back an instrumented Executor Service that will be recording metrics until it is shut down. It is important to ensure that the instrumented executor is being used and not the original one, otherwise some metrics and Context propagation features will not work as expected.

Options #

When instrumenting an Executor Service you have the possibility to tweak two different options:

  • Tracking time in queue (default: yes) will track setup a timer that measures the time between submitting a task to the executor and when it starts executing.
  • Propagate Context on submit (default: no) will capture the current Context at the moment a task is submitted to the executor and restore that Context when the task gets executed. In most cases you will not need to enable this option because the bytecode instrumentation shipping on this module will take care of performing Context propagation, but if you are doing manual instrumentation, this will definitely be useful for you.

Collected Metrics #

The following metrics are collected for both ThreadPoolExecutor and ForkJoinPool:


Tags included by default:
  • name: The name assigned to the Executor.
  • type: Either "fjp" for ForkJoinPool executors or "tpe" for ThreadPoolExecutors.

Tags included by default:
  • name: The name assigned to the Executor.
  • type: Either "fjp" for ForkJoinPool executors or "tpe" for ThreadPoolExecutors.

Tags included by default:
  • name: The name assigned to the Executor.
  • type: Either "fjp" for ForkJoinPool executors or "tpe" for ThreadPoolExecutors.

Tags included by default:
  • name: The name assigned to the Executor.
  • type: Either "fjp" for ForkJoinPool executors or "tpe" for ThreadPoolExecutors.

Tags included by default:
  • name: The name assigned to the Executor.
  • type: Either "fjp" for ForkJoinPool executors or "tpe" for ThreadPoolExecutors.

Tags included by default:
  • name: The name assigned to the Executor.
  • type: Either "fjp" for ForkJoinPool executors or "tpe" for ThreadPoolExecutors.

Tags included by default:
  • name: The name assigned to the Executor.
  • type: Either "fjp" for ForkJoinPool executors or "tpe" for ThreadPoolExecutors.

Tags included by default:
  • name: The name assigned to the Executor.
  • type: Either "fjp" for ForkJoinPool executors or "tpe" for ThreadPoolExecutors.

Additionally, the parallelism setting is also reported for ForkJoinPool executors:


Tags included by default:
  • name: The name assigned to the Executor.
  • type: Either "fjp" for ForkJoinPool executors or "tpe" for ThreadPoolExecutors.

Manual Installation #

In case you are not using the Kamon Bundle, add the dependency below to your build to instrument Akka 2.4 and Akka 2.5 applications.


libraryDependencies += "io.kamon" %% "kamon-executors" % "2.5.8"



    <dependency>
      <groupId>io.kamon</groupId>
      <artifactId>kamon-executors_2.13</artifactId>
      <version>2.5.8</version>
    </dependency>


implementation 'io.kamon:kamon-executors_2.13:2.5.8'

You must start your application with the instrumentation agent for this module to work properly.

On this article
Kamon APM Logo
Get Application-level Observability with Kamon APM
  • Correlated metrics and traces
  • Metric dashboards
  • Alerting rules and notifications
  • OpenTelemetry and Micrometer compatible
Try Kamon APM
Start with a FREE developer account