Donnie Roberson

<p>In this simple Tutorial we will walk through enabling the new DSE Metrics Collector demo using a DataStax Enterprise (DSE) 6.7 Docker Container, exporting the metrics to a Prometheus Docker Container and visualizing these metrics using a Grafana Docker container.</p>

<h2>This demo creates a DSE 6.7.0, &nbsp;Prometheus 2.4.3 and Grafana 5.3.2 container.</h2>

<h3>Prerequisites</h3>

<ul>
	<li>A computer running MacOSX, Linux or a Linux Virtual Machine</li>
	<li>Basic understanding of Docker images and containers.</li>
	<li>Docker installed on your local system, see <a href="https://docs.docker.com/engine/installation/">Docker Installation Instructions</a>.</li>
	<li>Docker Compose installed, if running linux see <a href="https://docs.docker.com/compose/install">Install Docker Compose</a></li>
	<li>DataStax DSE Docker Images are hosted on <a href="https://hub.docker.com/r/datastax/dse-server/">Docker Hub</a>. For documentation including configuration options, environment variables, and compose examples head over to our official <a href="https://docs.datastax.com/en/docker/doc/index.html?utm_campaign=Docker_Cus_2019&amp;utm_medium=web&amp;utm_source=docker&amp;utm_term=&amp;utm_content=Web_DocsDocker">Docker Docs</a></li>
</ul>

<h3>Getting Started</h3>

<p>To run this demo we need to first get the demo data, we do this by cloning the<a href="https://github.com/datastax/dse-metric-reporter-dashboards"> DataStax DSE Metrics Reporter GitHub</a> repo with the following command</p>

<p><code>curl -Lo dse-metric-reporter-dashboards-master.zip https://github.com/datastax/dse-metric-reporter-dashboards/archive/master.zip &amp;&amp; unzip dse-metric-reporter-dashboards-master.zip </code></p>

<p>Now we need to cd to the demo directory</p>

<p><code>cd dse-metric-reporter-dashboards-master/demo </code></p>

<h3>Starting the Containers</h3>

<p>Next start the containers with <code>docker-compose</code> using the downloaded docker-compose.yaml</p>

<p><code>docker-compose up -d </code></p>

<p>The docker-compose.yml</p>

<ul>
	<li>Pulls the images from Docker Hub</li>
	<li>Creates a bridged network for the containers to communicate on</li>
	<li>Maps the volumes to containers with the files we downloaded</li>
	<li>Publishes the ports for insights, prometheus and grafana</li>
	<li>Creates an alias for the dse container to use as the address in our custom <code>tg_dse.json</code> `</li>
</ul>

<h3>Viewing the Metrics in Grafana</h3>

<p>It can take a couple of minutes for DSE to completely start and metrics to begin populating. Visit the following link to view the metrics using the provided Grafana dashboards</p>

<p><a href="http://localhost:3000/dashboards">http://localhost:3000/dashboards</a> or <a href="http://docker-host-ip:3000/dashboards">http://docker-host-ip:3000/dashboards</a> if running on a remote host.</p>

<p><img alt="Grafana Metrics 1" data-entity-type="file" data-entity-uuid="8ad7655b-a7e9-4f00-a084-58582e50c397" src="https://www.datastax.com/sites/default/files/inline-images/metrics.png" /></p>

<p>&nbsp;</p>

<p><img alt="Grafana Metrics 2" data-entity-type="file" data-entity-uuid="134e556c-7d3c-44ae-b8aa-d27c6c63a3cb" src="https://www.datastax.com/sites/default/files/inline-images/metrics2.png" /></p>

<h3>Removing the Containers</h3>

<p>If you are finished with this demo and ready to remove the containers. &nbsp;Doing this is a simple as running the following command</p>

<p><code>docker-compose down </code></p>

<p>Now if you run <code>docker ps -a</code> you will see the dse, prometheus and grafana containers are gone.</p>

<p>All the config files are still located on your host so if you decided to run the demo again, as long as you do not delete the demo data, all you have to do is run the below command again from the <code>demo</code> directory and you will be back where you were prior to destroying.</p>

<p><code>docker-compose up -d </code></p>

<h3>Whats Next</h3>

<p>If you want more granular configuration details, using an existing promethius and grafana servers or instructions to configure metrics collector with existing clusters check out the official <a href="https://docs.datastax.com/en/dse/6.7/dse-dev/datastax_enterprise/tools/metricsCollector/mcIntroduction.html">DataStax Metrics Collector Documentation</a></p>


Demo of DSE Metrics Collector With The Official DSE Docker images

Donnie Roberson

Discover more

Share

Share

This demo creates a DSE 6.7.0, Prometheus 2.4.3 and Grafana 5.3.2 container.

Prerequisites

Getting Started

Starting the Containers

Viewing the Metrics in Grafana

Removing the Containers

Whats Next

More Technology

How Winweb Built its AI Assistant with DataStax Astra DB and LangChain

Vercel + Astra DB: Get Data into Your GenAI Apps Fast

Simplifying Agent Development with Astra DB Connector for Vertex AI Search

Making Astra DB easier for MongoDB developers

One-stop Data API for Production GenAI