OpsCenter: An Architecture Overview

By Nick Bailey -  August 7, 2013 | 6 Comments

OpsCenter is a great tool for managing and monitoring your Cassandra and DataStax Enterprise clusters. In this post we'll dive a bit deeper into the architecture to get a better view into how OpsCenter works. Understanding how the different components of OpsCenter work and interact should be useful for both users and administrators.

There are three main components of OpsCenter:

  • The User Interface
  • The OpsCenter Daemon
  • The OpsCenter Agent

Hopefully the diagram below helps to illustrate the different ways that each of these components interact with each other and Cassandra. It should be useful as a reference when reading about each individual component.


OpsCenter Components

User Interface

This is the main entry point for interacting with OpsCenter. It consists of javascript (specifically dojo), css, and html. The UI is completely self contained in that it is served to the user's browser when OpsCenter is loaded, and from that point the javascript interacts with the API exposed by the OpsCenter Daemon.

OpsCenter Daemon

This is the main OpsCenter Process. It is responsible for:

  • Serving the OpsCenter UI
  • Pushing new information to the OpsCenter UI
  • Exposing a management API
  • Managing OpsCenter Agents
  • Interacting with the Cassandra cluster via thrift

The first few responsibilities of the OpsCenter daemon, relate to interaction with the UI (and possibly other clients). OpsCenter runs an HTTP server in order to serve the UI component of OpsCenter to users' browsers. Once the UI has been served, the rest of the interaction with the daemon will occur either via the REST API or via STOMP. The OpsCenter daemon exposes a REST API in order to keep a clean separation between the components of OpsCenter as well as to allow advanced users to interact with a more programmatic interface if they wish to. The only additional interaction between the UI and the daemon is via STOMP. This is used to allow the daemon to "push" updates to the UI without the UI needing to specifically make an HTTP request. This is useful for things that need to be updated very frequently. For example, server load in the UI is updated every 5 seconds.

The other responsibilities of OpsCenter relate to actually managing/monitoring the Cassandra cluster. The daemon is the central point for cluster information to be aggregated, so that it can be exposed to the UI coherently. Some of this can be done independently by the daemon (without the agents) via thrift. The information gathered over thrift includes things like basic cluster information (node/token list, partitioner, snitch), schema information, and column family data. For additional information, the daemon relies on the OpsCenter Agents to be installed on the Cassandra nodes themselves. The interaction between the daemon and the agents is quite similar to how the UI interacts with the daemon. Agents expose a REST API for the daemon to query, as well as pushing frequently updated data (like server load) to the daemon.

OpsCenter Agent

The OpsCenter agent is the process that OpsCenter runs on each server in the Cassandra Cluster and is responsible for:

  • Exposing an interface for the OpsCenter daemon to manage that node
  • Sending information about that node to the OpsCenter Daemon
  • Collecting metrics about that node
  • Writing metric data to Cassandra via thrift

The main reponsibility of the agent is to collect information about the node it is monitoring. The information is then used in a number of ways. Much of the information is used by the OpsCenter daemon, either from the agent pushing data to the daemon (like server load) via STOMP, or from the daemon querying the REST API that the agent exposes. Additionally the agent collects metric and performance information from the node so that users can visualize performance graphs in the UI. The performance information that the agent collects is then stored to the Cassandra cluster using thrift. The agent will connect to the Cassandra node it is monitoring via thrift to insert data.

The other main responsibility of the agent is to expose a management interface for the Cassandra node it is monitoring. Cassandra exposes quite a few operations for managing cassandra nodes (compact, flush, repair, etc) via a protocol known as JMX. There are a few reasons that it is difficult for the OpsCenter daemon to interact with that interface. Mainly that the daemon is written in Python and there are firewall/networking concerns. For this reason, the agent acts a proxy for interacting with those management functions so that the OpsCenter daemon can access them.

There are a couple additional points worth noting. First, as described above, the agent only interacts with Cassandra by interacting with the local node it is running on. This generally avoids any firewall or networking concerns between the agent and Cassandra. Secondly, its worth noting that Clojure is a langauge that runs on the JVM. This makes interacting with Cassandra (also running on the JVM) much easier than if the agent were written in a non-JVM language (for example, Python).

A Note on SSL

One part left out of the description and diagram above is encryption of the different communication types via SSL. By default, OpsCenter encrypts some of this communication for security purposes. It is also possible to optionally configure ssl encryption for other types of communication.

Configured with SSL encryption by default:

  • STOMP between OpsCenter Daemon and agent
  • HTTP between OpsCenter Daemon and agent

Optional support for SSL encryption:

  • HTTP between the browser and OpsCenter daemon
  • Thrift between OpsCenter and Cassandra (available in DataStax Enterprise)
  • Thirft between agent and Cassandra (available in DataStax Enterprise)


Hopefully this gives a better understanding of the internal structure of OpsCenter.

DataStax has many ways for you to advance in your career and knowledge.

You can take free classes, get certified, or read one of our many white papers.

register for classes

get certified

DBA's Guide to NoSQL


  1. Valdemar Johansen says:

    Under the OpsCenter Analytics license, would it be possible to connect a custom GUI in place of the OpsCenter UI that uses the OpsCenter REST API to talk to the daemon? If so, do you supply documentation for front-end development against the daemon’s REST API and its STOMP update pushes?

    Alternatively, would it be possible to purchase the OpsCenter agents separately?

    1. Nick Bailey says:

      There aren’t any restrictions on how the OpsCenter API is consumed, so yes you could have a custom UI connect to OpsCenter. The documentation of the REST API is located here: http://www.datastax.com/documentation/opscenter/5.0/api/docs/index.html

      Unfortunately the STOMP connection is not documented publicly. It’s possible we may be able to add documentation in the future, but the usage of that connection isn’t guaranteed to be consistent across versions or backwards compatible.

      1. Festus Haggen says:

        Do the agents require the daemon to run or can they be purchased separately?

        1. Nick Bailey says:

          The agents require the daemon currently.

  2. Sandeep Yarabarla says:

    Is there a list of REST endpoints exposed by the datastax agent documented anywhere?

    1. Nick Bailey says:

      Unfortunately no. At the moment the agent api isn’t documented and isn’t guaranteed to remain stable between releases.


Your email address will not be published. Required fields are marked *

Subscribe for newsletter:

Tel. +1 (408) 933-3120 sales@datastax.com Offices France GermanyJapan

DataStax Enterprise is powered by the best distribution of Apache Cassandra™.

© 2017 DataStax, All Rights Reserved. DataStax, Titan, and TitanDB are registered trademark of DataStax, Inc. and its subsidiaries in the United States and/or other countries.
Apache Cassandra, Apache, Tomcat, Lucene, Solr, Hadoop, Spark, TinkerPop, and Cassandra are trademarks of the Apache Software Foundation or its subsidiaries in Canada, the United States and/or other countries.