---
title: "Async Methods"
description: "Learn about how to propagate Scope to Spring async methods."
url: https://docs.sentry.io/platforms/java/guides/spring-boot/async/
---

# Async Methods | Sentry for Spring Boot

Sentry's SDK for Java stores the scope and the context in a thread-local variable. To make sure that an async method has access to the correct Sentry context, a `SentryTaskDecorator` must be set on the `ThreadPoolTaskExecutor`.

## [Configuring Spring MVC Async Task Executor](https://docs.sentry.io/platforms/java/guides/spring-boot/async.md#configuring-spring-mvc-async-task-executor)

To propagate Sentry scope to Spring MVC methods returning a `Callable` or a `StreamingResponseBody`, a `ThreadPoolTaskExecutor` decorated with `SentryTaskDecorator` must be set on the `AsyncSupportConfigurer` through an implementation of `WebMvcConfigurer`:

**Java (Spring 5)**

```java
import org.springframework.context.annotation.Configuration;
import org.springframework.core.task.AsyncTaskExecutor;
import org.springframework.scheduling.concurrent.ThreadPoolTaskExecutor;
import org.springframework.web.servlet.config.annotation.AsyncSupportConfigurer;
import org.springframework.web.servlet.config.annotation.WebMvcConfigurer;

import io.sentry.spring.SentryTaskDecorator;

@Configuration
class AsyncWebMvcConfiguration implements WebMvcConfigurer {

    @Override
    public void configureAsyncSupport(AsyncSupportConfigurer configurer) {
        configurer.setTaskExecutor(asyncExecutor());
    }

    private AsyncTaskExecutor asyncExecutor() {
        ThreadPoolTaskExecutor executor = new ThreadPoolTaskExecutor();
        executor.setTaskDecorator(new SentryTaskDecorator());
        executor.initialize();
        return executor;
    }
}
```

**Java (Spring 6)**

```java
import org.springframework.context.annotation.Configuration;
import org.springframework.core.task.AsyncTaskExecutor;
import org.springframework.scheduling.concurrent.ThreadPoolTaskExecutor;
import org.springframework.web.servlet.config.annotation.AsyncSupportConfigurer;
import org.springframework.web.servlet.config.annotation.WebMvcConfigurer;

import io.sentry.spring.jakarta.SentryTaskDecorator;

@Configuration
class AsyncWebMvcConfiguration implements WebMvcConfigurer {

    @Override
    public void configureAsyncSupport(AsyncSupportConfigurer configurer) {
        configurer.setTaskExecutor(asyncExecutor());
    }

    private AsyncTaskExecutor asyncExecutor() {
        ThreadPoolTaskExecutor executor = new ThreadPoolTaskExecutor();
        executor.setTaskDecorator(new SentryTaskDecorator());
        executor.initialize();
        return executor;
    }
}
```

**Java (Spring 7)**

```java
import org.springframework.context.annotation.Configuration;
import org.springframework.core.task.AsyncTaskExecutor;
import org.springframework.scheduling.concurrent.ThreadPoolTaskExecutor;
import org.springframework.web.servlet.config.annotation.AsyncSupportConfigurer;
import org.springframework.web.servlet.config.annotation.WebMvcConfigurer;

import io.sentry.spring7.SentryTaskDecorator;

@Configuration
class AsyncWebMvcConfiguration implements WebMvcConfigurer {

    @Override
    public void configureAsyncSupport(AsyncSupportConfigurer configurer) {
        configurer.setTaskExecutor(asyncExecutor());
    }

    private AsyncTaskExecutor asyncExecutor() {
        ThreadPoolTaskExecutor executor = new ThreadPoolTaskExecutor();
        executor.setTaskDecorator(new SentryTaskDecorator());
        executor.initialize();
        return executor;
    }
}
```

**Kotlin (Spring 5)**

```kotlin
import org.springframework.context.annotation.Configuration
import org.springframework.core.task.AsyncTaskExecutor
import org.springframework.scheduling.concurrent.ThreadPoolTaskExecutor
import org.springframework.web.servlet.config.annotation.AsyncSupportConfigurer
import org.springframework.web.servlet.config.annotation.WebMvcConfigurer

import io.sentry.spring.SentryTaskDecorator

@Configuration
class AsyncWebMvcConfiguration : WebMvcConfigurer {
    override fun configureAsyncSupport(configurer: AsyncSupportConfigurer) {
        configurer.setTaskExecutor(asyncExecutor())
    }

    private fun asyncExecutor(): AsyncTaskExecutor {
        val executor = ThreadPoolTaskExecutor()
        executor.setTaskDecorator(SentryTaskDecorator())
        executor.initialize()
        return executor
    }
}
```

**Kotlin (Spring 6)**

```kotlin
import org.springframework.context.annotation.Configuration
import org.springframework.core.task.AsyncTaskExecutor
import org.springframework.scheduling.concurrent.ThreadPoolTaskExecutor
import org.springframework.web.servlet.config.annotation.AsyncSupportConfigurer
import org.springframework.web.servlet.config.annotation.WebMvcConfigurer

import io.sentry.spring.jakarta.SentryTaskDecorator

@Configuration
class AsyncWebMvcConfiguration : WebMvcConfigurer {
    override fun configureAsyncSupport(configurer: AsyncSupportConfigurer) {
        configurer.setTaskExecutor(asyncExecutor())
    }

    private fun asyncExecutor(): AsyncTaskExecutor {
        val executor = ThreadPoolTaskExecutor()
        executor.setTaskDecorator(SentryTaskDecorator())
        executor.initialize()
        return executor
    }
}
```

**Kotlin (Spring 7)**

```kotlin
import org.springframework.context.annotation.Configuration
import org.springframework.core.task.AsyncTaskExecutor
import org.springframework.scheduling.concurrent.ThreadPoolTaskExecutor
import org.springframework.web.servlet.config.annotation.AsyncSupportConfigurer
import org.springframework.web.servlet.config.annotation.WebMvcConfigurer

import io.sentry.spring7.SentryTaskDecorator

@Configuration
class AsyncWebMvcConfiguration : WebMvcConfigurer {
    override fun configureAsyncSupport(configurer: AsyncSupportConfigurer) {
        configurer.setTaskExecutor(asyncExecutor())
    }

    private fun asyncExecutor(): AsyncTaskExecutor {
        val executor = ThreadPoolTaskExecutor()
        executor.setTaskDecorator(SentryTaskDecorator())
        executor.initialize()
        return executor
    }
}
```

Alternatively, if there is a single bean of type `TaskDecorator` in the context, instead of custom `WebMvcConfigurer`, it is enough to create a `SentryTaskDecorator` bean.

**Java (Spring 5)**

```java
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;

import io.sentry.spring.SentryTaskDecorator;

@Configuration
class SentryConfig {

    @Bean
    public SentryTaskDecorator sentryTaskDecorator() {
        return new SentryTaskDecorator();
    }
}
```

**Java (Spring 6)**

```java
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;

import io.sentry.spring.jakarta.SentryTaskDecorator;

@Configuration
class SentryConfig {

    @Bean
    public SentryTaskDecorator sentryTaskDecorator() {
        return new SentryTaskDecorator();
    }
}
```

**Java (Spring 7)**

```java
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;

import io.sentry.spring7.SentryTaskDecorator;

@Configuration
class SentryConfig {

    @Bean
    public SentryTaskDecorator sentryTaskDecorator() {
        return new SentryTaskDecorator();
    }
}
```

**Kotlin (Spring 5)**

```kotlin
import org.springframework.context.annotation.Bean
import org.springframework.context.annotation.Configuration

import io.sentry.spring.SentryTaskDecorator

@Configuration
class SentryConfig {

    @Bean
    fun sentryTaskDecorator() = SentryTaskDecorator()
}
```

**Kotlin (Spring 6)**

```kotlin
import org.springframework.context.annotation.Bean
import org.springframework.context.annotation.Configuration

import io.sentry.spring.jakarta.SentryTaskDecorator

@Configuration
class SentryConfig {

    @Bean
    fun sentryTaskDecorator() = SentryTaskDecorator()
}
```

**Kotlin (Spring 7)**

```kotlin
import org.springframework.context.annotation.Bean
import org.springframework.context.annotation.Configuration

import io.sentry.spring7.SentryTaskDecorator

@Configuration
class SentryConfig {

    @Bean
    fun sentryTaskDecorator() = SentryTaskDecorator()
}
```

## [Configuring @Async Methods Task Executor](https://docs.sentry.io/platforms/java/guides/spring-boot/async.md#configuring-async-methods-task-executor)

To propagate Sentry scope to Spring `@Async` annotated methods, a custom `AsyncConfigurerSupport` must be configured to return a `ThreadPoolTaskExecutor` decorated with `SentryTaskDecorator`:

**Java (Spring 5)**

```java
import org.springframework.context.annotation.Configuration;
import org.springframework.scheduling.annotation.AsyncConfigurerSupport;
import org.springframework.scheduling.concurrent.ThreadPoolTaskExecutor;

import io.sentry.spring.SentryTaskDecorator;

import java.util.concurrent.Executor;

@Configuration
class AsyncMethodConfiguration extends AsyncConfigurerSupport {
    @Override
    public Executor getAsyncExecutor() {
        ThreadPoolTaskExecutor executor = new ThreadPoolTaskExecutor();
        executor.setTaskDecorator(new SentryTaskDecorator());
        executor.initialize();
        return executor;
    }
}
```

**Java (Spring 6)**

```java
import org.springframework.context.annotation.Configuration;
import org.springframework.scheduling.annotation.AsyncConfigurerSupport;
import org.springframework.scheduling.concurrent.ThreadPoolTaskExecutor;

import io.sentry.spring.jakarta.SentryTaskDecorator;

import java.util.concurrent.Executor;

@Configuration
class AsyncMethodConfiguration extends AsyncConfigurerSupport {
    @Override
    public Executor getAsyncExecutor() {
        ThreadPoolTaskExecutor executor = new ThreadPoolTaskExecutor();
        executor.setTaskDecorator(new SentryTaskDecorator());
        executor.initialize();
        return executor;
    }
}
```

**Java (Spring 7)**

```java
import org.springframework.context.annotation.Configuration;
import org.springframework.scheduling.annotation.AsyncConfigurerSupport;
import org.springframework.scheduling.concurrent.ThreadPoolTaskExecutor;

import io.sentry.spring7.SentryTaskDecorator;

import java.util.concurrent.Executor;

@Configuration
class AsyncMethodConfiguration extends AsyncConfigurerSupport {
    @Override
    public Executor getAsyncExecutor() {
        ThreadPoolTaskExecutor executor = new ThreadPoolTaskExecutor();
        executor.setTaskDecorator(new SentryTaskDecorator());
        executor.initialize();
        return executor;
    }
}
```

**Kotlin (Spring 5)**

```kotlin
import org.springframework.context.annotation.Configuration
import org.springframework.scheduling.annotation.AsyncConfigurerSupport
import org.springframework.scheduling.concurrent.ThreadPoolTaskExecutor

import io.sentry.spring.SentryTaskDecorator

import java.util.concurrent.Executor

@Configuration
class AsyncMethodConfiguration : AsyncConfigurerSupport() {
    override fun getAsyncExecutor(): Executor {
        val executor = ThreadPoolTaskExecutor()
        executor.setTaskDecorator(SentryTaskDecorator())
        executor.initialize()
        return executor
    }
}
```

**Kotlin (Spring 6)**

```kotlin
import org.springframework.context.annotation.Configuration
import org.springframework.scheduling.annotation.AsyncConfigurerSupport
import org.springframework.scheduling.concurrent.ThreadPoolTaskExecutor

import io.sentry.spring.jakarta.SentryTaskDecorator

import java.util.concurrent.Executor

@Configuration
class AsyncMethodConfiguration : AsyncConfigurerSupport() {
    override fun getAsyncExecutor(): Executor {
        val executor = ThreadPoolTaskExecutor()
        executor.setTaskDecorator(SentryTaskDecorator())
        executor.initialize()
        return executor
    }
}
```

**Kotlin (Spring 7)**

```kotlin
import org.springframework.context.annotation.Configuration
import org.springframework.scheduling.annotation.AsyncConfigurerSupport
import org.springframework.scheduling.concurrent.ThreadPoolTaskExecutor

import io.sentry.spring7.SentryTaskDecorator

import java.util.concurrent.Executor

@Configuration
class AsyncMethodConfiguration : AsyncConfigurerSupport() {
    override fun getAsyncExecutor(): Executor {
        val executor = ThreadPoolTaskExecutor()
        executor.setTaskDecorator(SentryTaskDecorator())
        executor.initialize()
        return executor
    }
}
```