diff --git a/src/includes/getting-started-install/android.mdx b/src/includes/getting-started-install/android.mdx index 3f806336c8deb..62c027b5d28ce 100644 --- a/src/includes/getting-started-install/android.mdx +++ b/src/includes/getting-started-install/android.mdx @@ -16,6 +16,6 @@ android { // Add Sentry's SDK as a dependency. dependencies { - implementation 'io.sentry:sentry-android:{{ packages.version('sentry.java', '4.0.0') }}' + implementation 'io.sentry:sentry-android:{{ packages.version('sentry.java', '4.2.0') }}' } ``` diff --git a/src/includes/getting-started-install/java.log4j2.mdx b/src/includes/getting-started-install/java.log4j2.mdx index 5059a0500b9d8..411de570d0949 100644 --- a/src/includes/getting-started-install/java.log4j2.mdx +++ b/src/includes/getting-started-install/java.log4j2.mdx @@ -2,16 +2,16 @@ io.sentry sentry-log4j2 - {{ packages.version('sentry.java', '4.0.0') }} + {{ packages.version('sentry.java', '4.2.0') }} ``` ```groovy {tabTitle:Gradle} -implementation 'io.sentry:sentry-log4j2:{{ packages.version('sentry.java', '4.0.0') }}' +implementation 'io.sentry:sentry-log4j2:{{ packages.version('sentry.java', '4.2.0') }}' ``` ```scala {tabTitle: SBT} -libraryDependencies += "io.sentry" % "sentry-log4j2" % "{{ packages.version('sentry.java', '4.0.0') }}" +libraryDependencies += "io.sentry" % "sentry-log4j2" % "{{ packages.version('sentry.java', '4.2.0') }}" ``` For other dependency managers see the [central Maven repository](https://search.maven.org/artifact/io.sentry/sentry-log4j2). diff --git a/src/includes/getting-started-install/java.logback.mdx b/src/includes/getting-started-install/java.logback.mdx index a794d0807e22b..d934521192447 100644 --- a/src/includes/getting-started-install/java.logback.mdx +++ b/src/includes/getting-started-install/java.logback.mdx @@ -2,16 +2,16 @@ io.sentry sentry-logback - {{ packages.version('sentry.java.logback', '4.0.0') }} + {{ packages.version('sentry.java.logback', '4.2.0') }} ``` ```groovy {tabTitle:Gradle} -implementation 'io.sentry:sentry-logback:{{ packages.version('sentry.java.logback', '4.0.0') }}' +implementation 'io.sentry:sentry-logback:{{ packages.version('sentry.java.logback', '4.2.0') }}' ``` ```scala {tabTitle: SBT} -libraryDependencies += "io.sentry" % "sentry-logback" % "{{ packages.version('sentry.java.logback', '4.0.0') }}" +libraryDependencies += "io.sentry" % "sentry-logback" % "{{ packages.version('sentry.java.logback', '4.2.0') }}" ``` For other dependency managers, see the [central Maven repository](https://search.maven.org/artifact/io.sentry/sentry-logback). diff --git a/src/includes/getting-started-install/java.mdx b/src/includes/getting-started-install/java.mdx index 73b8275b15eb8..c9038272f9ca3 100644 --- a/src/includes/getting-started-install/java.mdx +++ b/src/includes/getting-started-install/java.mdx @@ -6,7 +6,7 @@ repositories { // Add Sentry's SDK as a dependency. dependencies { - implementation 'io.sentry:sentry:{{ packages.version('sentry.java', '4.0.0') }}' + implementation 'io.sentry:sentry:{{ packages.version('sentry.java', '4.2.0') }}' } ``` @@ -14,10 +14,10 @@ dependencies { io.sentry sentry - {{ packages.version('sentry.java', '4.0.0') }} + {{ packages.version('sentry.java', '4.2.0') }} ``` ```scala {tabTitle:SBT} -libraryDependencies += "io.sentry" % "sentry" % "{{ packages.version('sentry.java', '4.0.0') }}" +libraryDependencies += "io.sentry" % "sentry" % "{{ packages.version('sentry.java', '4.2.0') }}" ``` diff --git a/src/includes/getting-started-install/java.spring-boot.mdx b/src/includes/getting-started-install/java.spring-boot.mdx index 805a5535ecb7d..84a84aebbc245 100644 --- a/src/includes/getting-started-install/java.spring-boot.mdx +++ b/src/includes/getting-started-install/java.spring-boot.mdx @@ -2,10 +2,10 @@ io.sentry sentry-spring-boot-starter - {{ packages.version('sentry.java.spring-boot', '4.0.0') }} + {{ packages.version('sentry.java.spring-boot', '4.2.0') }} ``` ```groovy {tabTitle:Gradle} -implementation 'io.sentry:sentry-spring-boot-starter:{{ packages.version('sentry.java.spring-boot', '4.0.0') }}' +implementation 'io.sentry:sentry-spring-boot-starter:{{ packages.version('sentry.java.spring-boot', '4.2.0') }}' ``` diff --git a/src/includes/getting-started-install/java.spring.mdx b/src/includes/getting-started-install/java.spring.mdx index 879332f5d35e3..909d2c7f721e1 100644 --- a/src/includes/getting-started-install/java.spring.mdx +++ b/src/includes/getting-started-install/java.spring.mdx @@ -2,16 +2,16 @@ io.sentry sentry-spring - {{ packages.version('sentry.java.spring', '4.0.0') }} + {{ packages.version('sentry.java.spring', '4.2.0') }} ``` ```groovy {tabTitle:Gradle} -implementation 'io.sentry:sentry-spring:{{ packages.version('sentry.java.spring', '4.0.0') }}' +implementation 'io.sentry:sentry-spring:{{ packages.version('sentry.java.spring', '4.2.0') }}' ``` ```scala {tabTitle: SBT} -libraryDependencies += "io.sentry" % "sentry-spring" % "{{ packages.version('sentry.java.spring', '4.0.0') }}" +libraryDependencies += "io.sentry" % "sentry-spring" % "{{ packages.version('sentry.java.spring', '4.2.0') }}" ``` For other dependency managers see the [central Maven repository](https://search.maven.org/artifact/io.sentry/sentry-spring). diff --git a/src/includes/performance/configure-sample-rate/java.spring-boot.mdx b/src/includes/performance/configure-sample-rate/java.spring-boot.mdx index 9897a3d6d6d00..2d617ee75f1de 100644 --- a/src/includes/performance/configure-sample-rate/java.spring-boot.mdx +++ b/src/includes/performance/configure-sample-rate/java.spring-boot.mdx @@ -58,14 +58,14 @@ For high traffic applications, we recommend using high-throughput HTTP transport io.sentry sentry-apache-http-client-5 - {{ packages.version('sentry.java.apache-http-client-5', '4.0.0') }} + {{ packages.version('sentry.java.apache-http-client-5', '4.2.0') }} ``` ```groovy {tabTitle:Gradle} -implementation 'io.sentry:sentry-apache-http-client-5:{{ packages.version('sentry.java.apache-http-client-5', '4.0.0') }}' +implementation 'io.sentry:sentry-apache-http-client-5:{{ packages.version('sentry.java.apache-http-client-5', '4.2.0') }}' ``` ```scala {tabTitle:SBT} -libraryDependencies += "io.sentry" % "sentry-apache-http-client-5" % "{{ packages.version('sentry.java.apache-http-client-5', '4.0.0') }}" +libraryDependencies += "io.sentry" % "sentry-apache-http-client-5" % "{{ packages.version('sentry.java.apache-http-client-5', '4.2.0') }}" ``` diff --git a/src/includes/performance/configure-sample-rate/java.spring.mdx b/src/includes/performance/configure-sample-rate/java.spring.mdx index 5fa12fad2c49b..536986bcb9074 100644 --- a/src/includes/performance/configure-sample-rate/java.spring.mdx +++ b/src/includes/performance/configure-sample-rate/java.spring.mdx @@ -51,16 +51,16 @@ For high traffic applications, we recommend using high-throughput HTTP transport io.sentry sentry-apache-http-client-5 - {{ packages.version('sentry.java.apache-http-client-5', '4.0.0') }} + {{ packages.version('sentry.java.apache-http-client-5', '4.2.0') }} ``` ```groovy {tabTitle:Gradle} -implementation 'io.sentry:sentry-apache-http-client-5:{{ packages.version('sentry.java.apache-http-client-5', '4.0.0') }}' +implementation 'io.sentry:sentry-apache-http-client-5:{{ packages.version('sentry.java.apache-http-client-5', '4.2.0') }}' ``` ```scala {tabTitle:SBT} -libraryDependencies += "io.sentry" % "sentry-apache-http-client-5" % "{{ packages.version('sentry.java.apache-http-client-5', '4.0.0') }}" +libraryDependencies += "io.sentry" % "sentry-apache-http-client-5" % "{{ packages.version('sentry.java.apache-http-client-5', '4.2.0') }}" ``` Define the bean, which will be automatically used by Sentry SDK: diff --git a/src/includes/performance/enable-manual-instrumentation/java.spring-boot.mdx b/src/includes/performance/enable-manual-instrumentation/java.spring-boot.mdx index 484fc93ea5f89..0bc72b95da18f 100644 --- a/src/includes/performance/enable-manual-instrumentation/java.spring-boot.mdx +++ b/src/includes/performance/enable-manual-instrumentation/java.spring-boot.mdx @@ -24,7 +24,7 @@ import io.sentry.spring.tracing.SentryTransaction; class ScheduledJob { @Scheduled(...) - @SentryTransaction + @SentryTransaction(operation = "task") void execute() { ... } @@ -40,14 +40,16 @@ import io.sentry.spring.tracing.SentryTransaction class ScheduledJob { @Scheduled(...) - @SentryTransaction + @SentryTransaction(operation = "task") fun execute() { ... } } ``` -`@SentryTransaction` can be configured with custom `name` and `op` properties. If not defined, `name` will be resolved from the class, and the method name. +`@SentryTransaction` can be configured with custom `name`. If not defined, `name` will be resolved from the class, and the method name. + +`@SentryTransaction` can be also placed on a class or an interface - it turns every method execution from the annotated type into a transaction. Advanced Spring AOP users can redefine transaction pointcut by providing a custom `org.springframework.aop.Pointcut` bean with name `sentryTransactionPointcut`. @@ -76,13 +78,15 @@ import io.sentry.spring.tracing.SentrySpan @Component class PersonService { - @SentrySpan + @SentrySpan(operation = "task") fun findById(id: Long): Person { ... } } ``` -`@SentrySpan` can be configured with custom `description` and `op` properties. If not defined, `description` will be resolved from the class, and the method name. +`@SentrySpan` can be configured with custom `description` property. If not defined, `operation` will be resolved from the class, and the method name. + +`@SentrySpan` can be also placed on a class or an interface - it turns every method execution from the annotated type into a span. Advanced Spring AOP users can redefine span pointcut by providing a custom `org.springframework.aop.Pointcut` bean with name `sentrySpanPointcut`. diff --git a/src/includes/performance/enable-manual-instrumentation/java.spring.mdx b/src/includes/performance/enable-manual-instrumentation/java.spring.mdx index e82f2e7168511..63462f1536171 100644 --- a/src/includes/performance/enable-manual-instrumentation/java.spring.mdx +++ b/src/includes/performance/enable-manual-instrumentation/java.spring.mdx @@ -51,7 +51,7 @@ import io.sentry.spring.tracing.SentryTransaction; class ScheduledJob { @Scheduled(...) - @SentryTransaction + @SentryTransaction(operation = "task") void execute() { ... } @@ -67,18 +67,20 @@ import io.sentry.spring.tracing.SentryTransaction class ScheduledJob { @Scheduled(...) - @SentryTransaction + @SentryTransaction(operation = "task") fun execute() { ... } } ``` -`@SentryTransaction` can be configured with custom `name` and `op` properties. If not defined, `name` will be resolved from the class, and the method name. +`@SentryTransaction` can be configured with custom `name`. If not defined, `name` will be resolved from the class, and the method name. + +`@SentryTransaction` can be also placed on a class or an interface - it turns every method execution from the annotated type into a transaction. Advanced Spring AOP users can redefine transaction pointcut by providing a custom `org.springframework.aop.Pointcut` bean with name `sentryTransactionPointcut`. -### Capturing Span +### Capturing a Span To create a span around a method execution, annotate method with `@SentrySpan` annotation: @@ -103,13 +105,15 @@ import io.sentry.spring.tracing.SentrySpan @Component class PersonService { - @SentrySpan + @SentrySpan(operation = "task") fun findById(id: Long): Person { ... } } ``` -`@SentrySpan` can be configured with custom `description` and `op` properties. If not defined, `description` will be resolved from the class, and the method name. +`@SentrySpan` can be configured with custom `description` property. If not defined, `operation` will be resolved from the class, and the method name. + +`@SentrySpan` can be also placed on a class or an interface - it turns every method execution from the annotated type into a span. Advanced Spring AOP users can redefine around which methods spans and transactions are created by creating custom advice, pointcut and advisor beans instead of importing `SentryTracingConfiguration` class. diff --git a/src/includes/performance/set-transaction-current-scope/java.mdx b/src/includes/performance/set-transaction-current-scope/java.mdx index 48f70f6eb1b8d..d7dbe748a70bd 100644 --- a/src/includes/performance/set-transaction-current-scope/java.mdx +++ b/src/includes/performance/set-transaction-current-scope/java.mdx @@ -8,7 +8,7 @@ import io.sentry.ITransaction; import io.sentry.Sentry; void executeTask() { - ITransaction transaction = Sentry.startTransaction("task"); + ITransaction transaction = Sentry.startTransaction("transaction-name", "task"); Sentry.configureScope(scope -> scope.setTransaction(transaction)); executeSubTask(); @@ -19,9 +19,9 @@ void executeTask() { private void executeSubTask() { ISpan span = Sentry.getSpan(); if (span == null) { - span = Sentry.startTransaction("sub-task"); + span = Sentry.startTransaction("transaction-name", "sub-task"); } else { - span = span.startChild(); + span = span.startChild("operation"); } // ... span.finish(); @@ -34,7 +34,7 @@ import io.sentry.ITransaction import io.sentry.Sentry fun executeTask() { - val transaction = Sentry.startTransaction("task") + val transaction = Sentry.startTransaction("transaction-name", "task") Sentry.configureScope(scope -> scope.setTransaction(transaction)) executeSubTask() @@ -45,9 +45,9 @@ fun executeTask() { private fun executeSubTask() { var span = Sentry.getSpan() span = if (span == null) { - Sentry.startTransaction("sub-task") + Sentry.startTransaction("transaction-name", "sub-task") } else { - span.startChild() + span.startChild("operation") } // ... span.finish() diff --git a/src/platforms/android/integrations/timber.mdx b/src/platforms/android/integrations/timber.mdx index cd56241f70f49..5376df21dce0e 100644 --- a/src/platforms/android/integrations/timber.mdx +++ b/src/platforms/android/integrations/timber.mdx @@ -17,8 +17,8 @@ The source can be found [on GitHub](https://github.com/getsentry/sentry-java/tre Using Gradle: ```groovy - implementation 'io.sentry:sentry-android:{{ packages.version('sentry.java.android', '4.0.0') }}' - implementation 'io.sentry:sentry-android-timber:{{ packages.version('sentry.java.android.timber', '4.0.0') }}' + implementation 'io.sentry:sentry-android:{{ packages.version('sentry.java.android', '4.2.0') }}' + implementation 'io.sentry:sentry-android-timber:{{ packages.version('sentry.java.android.timber', '4.2.0') }}' ``` 3. Initialize and add the `SentryTimberIntegration` diff --git a/src/platforms/android/usage/advanced-usage.mdx b/src/platforms/android/usage/advanced-usage.mdx index de8adc55758ae..ce51d0cccbbe7 100644 --- a/src/platforms/android/usage/advanced-usage.mdx +++ b/src/platforms/android/usage/advanced-usage.mdx @@ -23,7 +23,7 @@ compileOptions { // Add the Sentry Android SDK as a dependency dependencies { - implementation 'io.sentry:sentry-android-core:{{ packages.version('sentry.java.android', '4.0.0') }}' + implementation 'io.sentry:sentry-android-core:{{ packages.version('sentry.java.android', '4.2.0') }}' } ``` diff --git a/src/platforms/java/common/configuration/transport.mdx b/src/platforms/java/common/configuration/transport.mdx index 9f2fb65001c32..d8bab7c2fae7a 100644 --- a/src/platforms/java/common/configuration/transport.mdx +++ b/src/platforms/java/common/configuration/transport.mdx @@ -12,16 +12,16 @@ In a separate module, as an optional dependency, the SDK also provides high-thro io.sentry sentry-apache-http-client-5 - {{ packages.version('sentry.java.apache-http-client-5', '4.0.0') }} + {{ packages.version('sentry.java.apache-http-client-5', '4.2.0') }} ``` ```groovy {tabTitle:Gradle} -implementation 'io.sentry:sentry-apache-http-client-5:{{ packages.version('sentry.java.apache-http-client-5', '4.0.0') }}' +implementation 'io.sentry:sentry-apache-http-client-5:{{ packages.version('sentry.java.apache-http-client-5', '4.2.0') }}' ``` ```scala {tabTitle:SBT} -libraryDependencies += "io.sentry" % "sentry-apache-http-client-5" % "{{ packages.version('sentry.java.apache-http-client-5', '4.0.0') }}" +libraryDependencies += "io.sentry" % "sentry-apache-http-client-5" % "{{ packages.version('sentry.java.apache-http-client-5', '4.2.0') }}" ``` Then configure SDK to use the new transport: diff --git a/src/platforms/java/guides/spring-boot/logging-frameworks.mdx b/src/platforms/java/guides/spring-boot/logging-frameworks.mdx index c5a50a2ab63b1..5bf2c665ab54b 100644 --- a/src/platforms/java/guides/spring-boot/logging-frameworks.mdx +++ b/src/platforms/java/guides/spring-boot/logging-frameworks.mdx @@ -14,12 +14,12 @@ To use Sentry Logback integration in Spring Boot application you must include a io.sentry sentry-logback - {{ packages.version('sentry.java.logback', '4.0.0') }} + {{ packages.version('sentry.java.logback', '4.2.0') }} ``` ```groovy {tabTitle:Gradle} -implementation 'io.sentry:sentry-logback:{{ packages.version('sentry.java.logback', '4.0.0') }}' +implementation 'io.sentry:sentry-logback:{{ packages.version('sentry.java.logback', '4.2.0') }}' ``` Minimum logging levels for `SentryAppender` can be configured in `application.properties` or `application.yml` file. diff --git a/src/platforms/java/usage.mdx b/src/platforms/java/usage.mdx index 9c21e146e9fa2..fdbcdb0c66da4 100644 --- a/src/platforms/java/usage.mdx +++ b/src/platforms/java/usage.mdx @@ -12,16 +12,16 @@ description: "Learn more about passing configuration options to a static Sentry# io.sentry sentry - {{ packages.version('sentry.java', '4.0.0') }} + {{ packages.version('sentry.java', '4.2.0') }} ``` ```groovy {tabTitle:Gradle} -implementation 'io.sentry:sentry:{{ packages.version('sentry.java', '4.0.0') }}' +implementation 'io.sentry:sentry:{{ packages.version('sentry.java', '4.2.0') }}' ``` ```scala {tabTitle:SBT} -libraryDependencies += "io.sentry" % "sentry" % "{{ packages.version('sentry.java', '4.0.0') }}" +libraryDependencies += "io.sentry" % "sentry" % "{{ packages.version('sentry.java', '4.2.0') }}" ``` For other dependency managers see the [central Maven repository](https://search.maven.org/artifact/io.sentry/sentry-spring). @@ -46,7 +46,7 @@ public class MyClass { // All events get assigned to the release. See more at // https://docs.sentry.io/workflow/releases/ - options.setRelease("io.sentry.samples.console@4.0.0+1"); + options.setRelease("io.sentry.samples.console@4.2.0+1"); // Modifications to event before it goes out. Could replace the event altogether options.setBeforeSend((event, hint) -> { @@ -101,7 +101,7 @@ fun main() { // All events get assigned to the release. See more at // https://docs.sentry.io/workflow/releases/ - options.release = "io.sentry.samples.console@4.0.0+1" + options.release = "io.sentry.samples.console@4.2.0+1" // Modifications to event before it goes out. Could replace the event altogether options.beforeSend = BeforeSendCallback { event: SentryEvent, hint: Any? ->