From 7c408ea887e8034aec046703c06255f08375436c Mon Sep 17 00:00:00 2001
From: "Greg L. Turnquist" <gturnquist@vmware.com>
Date: Wed, 6 Apr 2022 14:45:29 -0500
Subject: [PATCH] Add Observability to reference documentation.

See #1250.
---
 spring-data-cassandra-distribution/pom.xml    | 100 ++++++++++++++++++
 src/main/asciidoc/index.adoc                  |   1 +
 .../asciidoc/reference/observability.adoc     |   8 ++
 3 files changed, 109 insertions(+)
 create mode 100644 src/main/asciidoc/reference/observability.adoc

diff --git a/spring-data-cassandra-distribution/pom.xml b/spring-data-cassandra-distribution/pom.xml
index 577ae9e58..4efa2c3fe 100644
--- a/spring-data-cassandra-distribution/pom.xml
+++ b/spring-data-cassandra-distribution/pom.xml
@@ -22,6 +22,14 @@
 	<properties>
 		<project.root>${basedir}/..</project.root>
 		<dist.key>SDCASS</dist.key>
+
+		<!-- Observability -->
+		<micrometer-docs-generator.version>1.0.0-SNAPSHOT</micrometer-docs-generator.version>
+		<micrometer-docs-generator.inputPath>${maven.multiModuleProjectDirectory}/spring-data-cassandra/
+		</micrometer-docs-generator.inputPath>
+		<micrometer-docs-generator.inclusionPattern>.*</micrometer-docs-generator.inclusionPattern>
+		<micrometer-docs-generator.outputPath>${maven.multiModuleProjectDirectory}/target/
+		</micrometer-docs-generator.outputPath>
 	</properties>
 
 	<build>
@@ -30,6 +38,54 @@
 				<groupId>org.apache.maven.plugins</groupId>
 				<artifactId>maven-assembly-plugin</artifactId>
 			</plugin>
+			<plugin>
+				<groupId>org.codehaus.mojo</groupId>
+				<artifactId>exec-maven-plugin</artifactId>
+				<executions>
+					<execution>
+						<id>generate-metrics-metadata</id>
+						<phase>prepare-package</phase>
+						<goals>
+							<goal>java</goal>
+						</goals>
+						<configuration>
+							<mainClass>io.micrometer.docs.metrics.DocsFromSources</mainClass>
+						</configuration>
+					</execution>
+					<execution>
+						<id>generate-tracing-metadata</id>
+						<phase>prepare-package</phase>
+						<goals>
+							<goal>java</goal>
+						</goals>
+						<configuration>
+							<mainClass>io.micrometer.docs.spans.DocsFromSources</mainClass>
+						</configuration>
+					</execution>
+				</executions>
+				<dependencies>
+					<dependency>
+						<groupId>io.micrometer</groupId>
+						<artifactId>micrometer-docs-generator-spans</artifactId>
+						<version>${micrometer-docs-generator.version}</version>
+						<type>jar</type>
+					</dependency>
+					<dependency>
+						<groupId>io.micrometer</groupId>
+						<artifactId>micrometer-docs-generator-metrics</artifactId>
+						<version>${micrometer-docs-generator.version}</version>
+						<type>jar</type>
+					</dependency>
+				</dependencies>
+				<configuration>
+					<includePluginDependencies>true</includePluginDependencies>
+					<arguments>
+						<argument>${micrometer-docs-generator.inputPath}</argument>
+						<argument>${micrometer-docs-generator.inclusionPattern}</argument>
+						<argument>${micrometer-docs-generator.outputPath}</argument>
+					</arguments>
+				</configuration>
+			</plugin>
 			<plugin>
 				<groupId>org.asciidoctor</groupId>
 				<artifactId>asciidoctor-maven-plugin</artifactId>
@@ -37,4 +93,48 @@
 		</plugins>
 	</build>
 
+	<repositories>
+		<repository>
+			<id>spring-snapshots</id>
+			<name>Spring Snapshots</name>
+			<url>https://repo.spring.io/snapshot</url> <!-- For Snapshots -->
+			<snapshots>
+				<enabled>true</enabled>
+			</snapshots>
+			<releases>
+				<enabled>false</enabled>
+			</releases>
+		</repository>
+		<repository>
+			<id>spring-milestones</id>
+			<name>Spring Milestones</name>
+			<url>https://repo.spring.io/milestone</url>  <!-- For Milestones -->
+			<snapshots>
+				<enabled>false</enabled>
+			</snapshots>
+		</repository>
+	</repositories>
+
+	<pluginRepositories>
+		<pluginRepository>
+			<id>spring-snapshots</id>
+			<name>Spring Snapshots</name>
+			<url>https://repo.spring.io/snapshot</url> <!-- For Snapshots -->
+			<snapshots>
+				<enabled>true</enabled>
+			</snapshots>
+			<releases>
+				<enabled>false</enabled>
+			</releases>
+		</pluginRepository>
+		<pluginRepository>
+			<id>spring-milestones</id>
+			<name>Spring Milestones</name>
+			<url>https://repo.spring.io/milestone</url>  <!-- For Milestones -->
+			<snapshots>
+				<enabled>false</enabled>
+			</snapshots>
+		</pluginRepository>
+	</pluginRepositories>
+
 </project>
diff --git a/src/main/asciidoc/index.adoc b/src/main/asciidoc/index.adoc
index a3e3d0a5e..64da34dc4 100644
--- a/src/main/asciidoc/index.adoc
+++ b/src/main/asciidoc/index.adoc
@@ -41,3 +41,4 @@ include::{spring-data-commons-docs}/repository-populator-namespace-reference.ado
 include::{spring-data-commons-docs}/repository-query-keywords-reference.adoc[leveloffset=+1]
 include::{spring-data-commons-docs}/repository-query-return-types-reference.adoc[leveloffset=+1]
 include::reference/migration-guides.adoc[leveloffset=+1]
+include::reference/observability.adoc[leveloffset=+1]
diff --git a/src/main/asciidoc/reference/observability.adoc b/src/main/asciidoc/reference/observability.adoc
new file mode 100644
index 000000000..f31372d35
--- /dev/null
+++ b/src/main/asciidoc/reference/observability.adoc
@@ -0,0 +1,8 @@
+:root-target: ../../../../target/
+
+[[observability]]
+== Observability metadata
+
+include::{root-target}_metrics.adoc[]
+
+include::{root-target}_spans.adoc[]