Merge pull request #175987 from iriaosara/cassandraapi_error_code_doc

Glowroot Documentation

Author: ShannonLeavitt

articles/cosmos-db/TOC.yml

@@ -1077,6 +1077,8 @@
           href: cassandra/powershell-samples.md
         - name: Manage using Azure CLI
           href: cassandra/cli-samples.md
+        - name: Glowroot using Cassandra API
+          href: cassandra/glowroot-cassandra.md
         - name: Error codes definitions
           href: cassandra/error-codes-solution.md
     - name: Reference

articles/cosmos-db/cassandra/glowroot-cassandra.md

@@ -0,0 +1,43 @@
+---
+title: Run Glowroot on Azure Cosmos DB Cassandra API(preview)
+description: This article details how to run Glowroot in Azure Cosmos DB Cassandra API.
+author: IriaOsara
+ms.author: IriaOsara
+ms.service: cosmos-db
+ms.subservice: cosmosdb-cassandra
+ms.topic: how-to
+ms.date: 10/02/2021
+ms.custom: template-how-to 
+---
+
+# Run Glowroot on Azure Cosmos DB Cassandra API
+[!INCLUDE[appliesto-cassandra-api](../includes/appliesto-cassandra-api.md)]
+
+This article explains how to setup Glowroot on Azure Cosmos DB Cassandra API. Glowroot is an APM tool that helps you get to monitor you application performance.
+
+## Prerequisites and Setup
+
+* [Create an Azure Cosmos DB Cassandra API account](manage-data-java.md#create-a-database-account).
+* [Install JAVA (version 8) for Windows](https://developers.redhat.com/products/openjdk/download)
+> [!NOTE]
+> Note that there are certain known incompatible build targets with newer versions. If you already have a newer version of JAVA, you can still download JDK8.
+> If you have newer JAVA installed in addition to JDK8: Set the %JAVA_HOME% variable in the local command prompt to target JDK8. This will only change java version for the current session and leave global machine settings intact. 
+* [Install maven](https://maven.apache.org/download.cgi)
+    * Verify successful installation by running: `mvn --version`
+
+## Run Glowroot central collector with Cosmos DB endpoint
+Once the endpoint configuration has been completed. 
+1. [Download Glowroot central collector distribution](https://github.com/glowroot/glowroot/wiki/Central-Collector-Installation#central-collector-installation)
+2. In the glowroot-central.properties file, populate the following properties from your Cosmos DB Cassandra endpoint
+    * cassandra.contactPoints
+    * cassandra.username
+    * cassandra.password
+3. Set properties `cassandra.ssl=true`, `cassandra.gcGraceSeconds=0`, and `cassandra.port=10350`.
+4. Ensure that the glowroot-central.properties is in the same folder as the glowroot-central.jar.
+5. Run `java -jar glowroot-central.jar` to begin running Glowroot.
+
+## FAQs
+Open a support ticket if you have issues running or testing Glowroot. Providing the subscription ID and account name where your Glowroot test will be running.
+
+## Next steps
+- Learn about [supported features](cassandra-support.md) in the Azure Cosmos DB Cassandra API.