Adron Hall

Snitches. What a great name for a feature right? I’d bring up the Harry Potter thing, but I’m gonna let that one fly. (get it, it flies!)

<img alt="Distributed Data Things To Know" data-entity-type="file" data-entity-uuid="341d1f73-4743-4e2b-ae6b-ff77898bfe06" src="https://www.datastax.com/sites/default/files/inline-images/distributeddatabasethingstoknow_0_0.png" />

A snitch determines where nodes go among the racks and datacenters. This is the Cassandra specific racks and datacenters, however, so check out my previous post on <a href="https://compositecode.blog/2018/10/29/cassandra-datacenter-racks/">datacenters and racks</a> for more detail on the specifics about what they are in relation to Cassandra and DataStax Enterprise (DSE). Snitches tell the database about the network topology of the system. Requests can then be routed efficiently and enable Cassandra and DSE to distribute replicas by grouping the machines accordingly. Of the nodes, all within a cluster must use this same snitch in the logic of distribution among the system.

<h2>Snitch Options</h2>

The following are the feature options we have to determine how the snitches determine node placement.

<ul>
	<li>DseSimpleSnitch – This is the default snitch and is intended only for development deployments. It doesn’t recognize datacenter or rack information, and simply needs a keyspace defined to use SimpleStrategy and set a replication factor. Its use makes it a bit easier to set up a cluster for development.</li>
	<li>GossipingPropertyFileSnitch – This snitch is usable for production. Rack and datacenter information for the local node is defined in the cassandra-rackdc.properties file, which then propagates this to other nodes via gossip.</li>
	<li>Ec2Snitch – This is a great snitch for simple cluster deployments that reside in a single region. For this snitch, the region name is used as the datacenter name and availability zones are setup as racks. That gives us a setup that matches datacenter and racks to region and zones, making it pretty easy to remember which is where then. Since this maps this way, as the way Ec2 works, this snitch isn’t usable among multi-region clusters.</li>
	<li>Ec2MultiRegionSnitch – This snitch can be used for multi-region deployments. To use this snitch, settings need to be made in both the cassandra.yaml file and cassandra-rackdc.properties file. The way this snitch works is by using the public IP designated in the broadcast_address to allow this multi-region connection.</li>
	<li>GoogleCloudSnitch – This snitch, as is somewhat obvious by the name, is for DSE deployments on <a href="https://cloud.google.com/">Google Cloud Platform</a> (GCP). This snitch uses datacenters and racks similarly mapped as the Ec2Snitch with datacenters mapped to regions and racks mapped to zones.</li>
	<li>CloudstackSnitch – This snitch is for Apache Cloudstack. Zone naming is free-form in Cloudstack so this snitch uses notation.</li>
	<li>PropertyFileSnitch – The way this snitch works is by proximity, determined by rack and datacenter. It uses network details configured in cassandra-topology.properties file, with the datacenter names defined using standard convention. These need to correlated to the name of the actual datacenters in the keyspace definition. Then nodes in the cluster are described in the cassandra-topology.properties file and must be exactly the same on every node in the cluster.</li>
	<li>RackInferringSnitch – This snitch is kind of funny, because it’s a usable snitch, but it’s also an example snitch. It determines the proximity of nodes by datacenter and rack too. However, it assumes these correspond to the second and third octet of the node’s IP address. It is best used as an example for writing custom snitch classes, unless of course, this matches your actual deployment conventions.</li>
</ul>

That’s the basics on snitches. I recently wrote about another important distributed database architectural concept called <a href="https://compositecode.blog/2018/10/08/distributed-database-things-to-know-consistent-hashing/">consistent hashing</a>, it’s an important concept to understand about distributed databases like Cassandra and DataStax Enterprise.

References:

<ul>
	<li><a href="https://docs.datastax.com/en/landing_page/doc/landing_page/current.html">DataStax Documentation</a> on <a href="https://docs.datastax.com/en/dse/6.7/dse-arch/datastax_enterprise/dbArch/archSnitchesTOC.html">Snitches</a></li>
	<li><a href="http://cassandra.apache.org/doc/4.0/operating/snitch.html">Apache Cassandra Documentation</a></li>
</ul>

The article was cross-posted from Adron's personal blog, <a href="https://compositecode.blog/2019/01/25/distributed-database-things-to-know-snitches/">Composite Code</a>.&nbsp;

Build and scale cloud native apps

Discover the benefits of DBaaS and why your apps deserve an upgrade.

Learn about NoSQL Databases

Learn about NoSQL databases with Apache Cassandra and Astra DB.

2022 Recap: A Year for Customers, Community, and Real-Time Data

Highlights from 2022 and a glimpse into the year ahead.

ViewingTechnical How To’s

Distributed Database Things to Know: Snitches

Sign up for our Developer Newsletter