(DOCSP-18851) Include Driver Data In Distributed Tracing System (#178)

Author: biniona-mongodb

source/fundamentals/monitoring.txt

@@ -398,3 +398,32 @@ Oracle:
 For more information on the ``JMXConnectionPoolListener`` class, see
 the API Documentation for
 `JMXConnectionPoolListener <{+api+}/apidocs/mongodb-driver-core/com/mongodb/management/JMXConnectionPoolListener.html>`__.
+
+Include the Driver in Your Distributed Tracing System
+-----------------------------------------------------
+
+If you use a **distributed tracing system**, you can include event data from the
+driver. A distributed tracing system is an application that
+tracks requests as they propagate throughout different services in a
+service-oriented architecture.
+
+If you use the driver in a `Spring Cloud <https://spring.io/projects/spring-cloud>`__
+application, use
+`Spring Cloud Sleuth <https://spring.io/projects/spring-cloud-sleuth>`__ to
+include MongoDB event data in the
+`Zipkin <https://zipkin.io/>`__ distributed tracing system.
+
+If you do not use Spring Cloud or need to include driver event data in a distributed
+tracing system other than Zipkin, you must write a command event listener that
+manages `spans <https://docs.spring.io/spring-cloud-sleuth/docs/current-SNAPSHOT/reference/html/getting-started.html#getting-started-terminology>`__
+for your desired distributed tracing system. To see an implementation of such a
+listener, see the
+:github:`TraceMongoCommandListener <spring-cloud/spring-cloud-sleuth/blob/main/spring-cloud-sleuth-instrumentation/src/main/java/org/springframework/cloud/sleuth/instrument/mongodb/TraceMongoCommandListener.java>`
+class in the Spring Cloud Sleuth source code.
+
+To learn more about Spring Cloud Sleuth, see
+`Getting Started <https://docs.spring.io/spring-cloud-sleuth/docs/current-SNAPSHOT/reference/html/getting-started.html>`__
+in the Spring Cloud Sleuth documentation.
+
+To view a detailed description of a distributed tracing system, see
+`Dapper <https://research.google/pubs/pub36356/>`__ from Google Research.