Deprecate Observability API.

pom.xml

@@ -5,7 +5,7 @@
 
 	<groupId>org.springframework.data</groupId>
 	<artifactId>spring-data-mongodb-parent</artifactId>
-	<version>5.0.0-SNAPSHOT</version>
+	<version>5.0.x-GH-5009-SNAPSHOT</version>
 	<packaging>pom</packaging>
 
 	<name>Spring Data MongoDB</name>

spring-data-mongodb-distribution/pom.xml

@@ -15,7 +15,7 @@
 	<parent>
 		<groupId>org.springframework.data</groupId>
 		<artifactId>spring-data-mongodb-parent</artifactId>
-		<version>5.0.0-SNAPSHOT</version>
+		<version>5.0.x-GH-5009-SNAPSHOT</version>
 		<relativePath>../pom.xml</relativePath>
 	</parent>
 

spring-data-mongodb/pom.xml

@@ -13,7 +13,7 @@
 	<parent>
 		<groupId>org.springframework.data</groupId>
 		<artifactId>spring-data-mongodb-parent</artifactId>
-		<version>5.0.0-SNAPSHOT</version>
+		<version>5.0.x-GH-5009-SNAPSHOT</version>
 		<relativePath>../pom.xml</relativePath>
 	</parent>
 

spring-data-mongodb/src/main/java/org/springframework/data/mongodb/observability/ContextProviderFactory.java

@@ -40,7 +40,9 @@
  *
  * @author Mark Paluch
  * @since 3.0
+ * @deprecated since 5.0 in favor of native MongoDB Java Driver observability support.
  */
+@Deprecated(since = "5.0",  forRemoval = true)
 public class ContextProviderFactory {
 
 	private static final boolean SYNCHRONOUS_PRESENT = ClassUtils

spring-data-mongodb/src/main/java/org/springframework/data/mongodb/observability/DefaultMongoHandlerObservationConvention.java

@@ -29,7 +29,9 @@
  * @author Mark Paluch
  * @author Michal Domagala
  * @since 4.0
+ * @deprecated since 5.0 in favor of native MongoDB Java Driver observability support.
  */
+@Deprecated(since = "5.0",  forRemoval = true)
 class DefaultMongoHandlerObservationConvention implements MongoHandlerObservationConvention {
 
 	@Override

spring-data-mongodb/src/main/java/org/springframework/data/mongodb/observability/MapRequestContext.java

@@ -28,7 +28,9 @@
  * @author Marcin Grzejszczak
  * @author Greg Turnquist
  * @since 4.0.0
+ * @deprecated since 5.0 in favor of native MongoDB Java Driver observability support.
  */
+@Deprecated(since = "5.0",  forRemoval = true)
 record MapRequestContext(Map<Object, Object> map) implements RequestContext {
 
 	public MapRequestContext() {

spring-data-mongodb/src/main/java/org/springframework/data/mongodb/observability/MongoHandlerContext.java

@@ -40,7 +40,9 @@
  * @author Greg Turnquist
  * @author Mark Paluch
  * @since 4.0
+ * @deprecated since 5.0 in favor of native MongoDB Java Driver observability support.
  */
+@Deprecated(since = "5.0",  forRemoval = true)
 public class MongoHandlerContext extends SenderContext<Object> {
 
 	/**

spring-data-mongodb/src/main/java/org/springframework/data/mongodb/observability/MongoHandlerObservationConvention.java

@@ -23,7 +23,9 @@
  *
  * @author Greg Turnquist
  * @since 4
+ * @deprecated since 5.0 in favor of native MongoDB Java Driver observability support.
  */
+@Deprecated(since = "5.0",  forRemoval = true)
 public interface MongoHandlerObservationConvention extends ObservationConvention<MongoHandlerContext> {
 
 	@Override

spring-data-mongodb/src/main/java/org/springframework/data/mongodb/observability/MongoKeyName.java

@@ -32,7 +32,9 @@
  *
  * @author Mark Paluch
  * @since 4.4.9
+ * @deprecated since 5.0 in favor of native MongoDB Java Driver observability support.
  */
+@Deprecated(since = "5.0",  forRemoval = true)
 record MongoKeyName<C>(String name, boolean required, Function<C, @Nullable Object> valueFunction) implements KeyName {
 
 	/**

spring-data-mongodb/src/main/java/org/springframework/data/mongodb/observability/MongoObservation.java

@@ -34,7 +34,9 @@
  * @author Marcin Grzejszczak
  * @author Greg Turnquist
  * @since 4.0
+ * @deprecated since 5.0 in favor of native MongoDB Java Driver observability support.
  */
+@Deprecated(since = "5.0",  forRemoval = true)
 enum MongoObservation implements ObservationDocumentation {
 
 	/**

spring-data-mongodb/src/main/java/org/springframework/data/mongodb/observability/MongoObservationCommandListener.java

@@ -41,7 +41,9 @@
  * @author Greg Turnquist
  * @author François Kha
  * @since 4.0
+ * @deprecated since 5.0 in favor of native MongoDB Java Driver observability support.
  */
+@Deprecated(since = "5.0",  forRemoval = true)
 public class MongoObservationCommandListener implements CommandListener {
 
 	private static final Log log = LogFactory.getLog(MongoObservationCommandListener.class);

spring-data-mongodb/src/main/java/org/springframework/data/mongodb/observability/Observer.java

@@ -31,7 +31,9 @@
  *
  * @author Mark Paluch
  * @since 4.4.9
+ * @deprecated since 5.0 in favor of native MongoDB Java Driver observability support.
  */
+@Deprecated(since = "5.0",  forRemoval = true)
 class Observer {
 
 	private final List<MongoKeyName.MongoKeyValue> keyValues = new ArrayList<>();

spring-data-mongodb/src/main/java/org/springframework/data/mongodb/observability/package-info.java

@@ -1,5 +1,6 @@
 /**
  * Infrastructure to provide driver observability using Micrometer.
+ * @deprecated since 5.0 in favor of native MongoDB Java Driver observability support.
  */
 @org.jspecify.annotations.NullMarked
 package org.springframework.data.mongodb.observability;

src/main/antora/modules/ROOT/pages/observability/observability.adoc

@@ -3,6 +3,23 @@
 [[mongodb.observability]]
 = Observability
 
+[WARNING]
+====
+Spring Data MongoDB's flavor of observability has been deprecated and is scheduled for removal in favor of the observability support being directly built into the MongoDB Java Driver which can be configured as outlined below:
+
+[source,java]
+----
+@Bean
+MongoClientSettingsBuilderCustomizer mongoDbObservabilitySettings(ObservationRegistry registry) {
+    return (clientSettingsBuilder) -> {
+        clientSettingsBuilder.observabilitySettings(ObservabilitySettings.micrometerBuilder()
+                .observationRegistry(observationRegistry)
+                .build());
+    };
+}
+----
+====
+
 Spring Data MongoDB currently has the most up-to-date code to support Observability in your MongoDB application.
 These changes, however, haven't been picked up by Spring Boot (yet).
 Until those changes are applied, if you wish to use Spring Data MongoDB's flavor of Observability, you must carry out the following steps.