You are viewing documentation for an older version of Confluent Platform. For the latest, click here.
Confluent Control Center is included in the Confluent Platform Enterprise package. Detailed instructions for installing the Confluent Platform are provided in our installation guide. After installing the Confluent Platform, you can install the Confluent Control Center server.
- System requirements
- Install Control Center
- Install and configure components
- Start Control Center
- License Keys
- Removing Control Center
Confluent Control Center installation requires the following items.
- Kafka Brokers running Kafka Version 0.10.2.0 or later
- Stream Monitoring requires several new features of Kafka 0.10.2.0 to function. We suggest using the Confluent Kafka distribution included with Confluent Platform 3.2
- Kafka Java Producers and Consumers running 0.10.1.0 or later
- Stream Monitoring requires several new features of Kafka 0.10.1.0 to function, including cluster ids. These are currently only available in the Kafka 0.10.1.0 Java clients.
- Ability to add jars to the classpath of client applications
- You do not need to recompile client applications, and may not need to reboot them if you are using a class injection system like Java Beans or Spring.
- Ability to configure clients
- You must have the ability to change the configurations of Kafka clients so that you can specify parameters for the Confluent Metrics Interceptor. (If you write your applications to dynamically load Kafka configuration settings, you don’t need to recompile to use this feature. If you can dynamically change the parameters of running applications, then you do not even need to restart them.)
- Ability to configure Kafka brokers
- You must have the ability to change the configurations of Kafka brokers so that you can specify parameters for the Confluent Metrics Reporter.
- Google Chrome
- We develop and test our web UI with Google Chrome. We believe that our UI will work with other browsers, and do some informal testing with Safari, Firefox, and Internet Explorer, but do not formally support other browsers.
Control Center uses Apache Kafka to collect data. You can configure Control Center to run with a replication factor of 1 (thus requiring at least one Kafka broker in your cluster), but we recommend 3 for production use (requiring at least three brokers).
A server that meets these minimal requirements:
- 8 GB RAM
- 500 GB storage
- A supported operating system:
- Ubuntu 14.04 or later
- Debian 8 or later
- RHEL/Centos 6.8 or later
- Access to Kafka (specifically, the ability to consume messages and to communicate with ZooKeeper)
- Access to Kafka Connect instances (if you want to configure Kafka Connect)
- Ability to connect to the server from the user’s web browser
Users who need access to Confluent Control Center must be able to access the host that runs the application. (You can configure the network port that Confluent Control Center uses to serve data.) Because Confluent Control Center is a web application, you may use a proxy to control and secure access to it.
Installation instructions for installing the overall platform on Red Hat style systems can be found at RHEL and CentOS.
If you would like to install just Control Center on a server, first follow the instructions for configuring Confluent repositories with you package manager. Then, you can install Control Center with a line like:
$ sudo yum install confluent-control-center
Installation instructions for the overall platform on Debian style systems can be found at Debian and Ubuntu.
If you would like to install just Control Center on a server, first follow the instructions for configuring Confluent repositories with you package manager. Then, you can install control center with a line like:
$ sudo apt-get install confluent-control-center
To use Control Center, the following Confluent Platform component are required.
- Add the Confluent Metrics Reporter to the Kafka broker classpath
(this can be found under
./share/java/kafka/confluent-metrics-3.2.1.jarof the Confluent archive)
- Follow the instructions to enable the Confluent Metrics Reporter.
Example configuration parameters are provided in
./etc/kafka/server.propertiesof the Confluent archive.
See Installing and Configuring Kafka Connect for more information about how to install and configure Kafka Connect. (You need to install Kafka Connect for Control Center to configure it.)
If you install the Confluent Platform, then you already have all the software you need to monitor Kafka Connect jobs with Stream Monitoring.
If you have installed Kafka Connect separately, you can still use Stream Monitoring to monitor Kafka Connect. To do this, you need to take these steps:
- Upgrade to Kafka 0.10.2.0+
- Add the Confluent Metrics Interceptor to the Kafka Connect
- Add the Confluent Metrics Interceptor to the client configurations in the Kafka Connect config files. You can append two lines like this in your configuration file to do this:
You can use a script for starting Control Center, called
This script takes one argument: a configuration file (
control-center.properties) that specifies the properties for Control Center. For information on what properties you must specify, see Configuration. After you have configured the properties file, you can start Control Center.
$ <path-to-confluent>/bin/control-center-start etc/confluent-control-center/control-center.properties
If you would like to start Control Center as a daemon process, you can use the -daemon option:
$ <path-to-confluent>/bin/control-center-start -daemon etc/confluent-control-center/control-center.properties
You can navigate to the Control Center web interface at http://localhost:9092/.
Confluent Control Center is proprietary software. If you have downloaded and installed this from the Confluent Web Site and are not a Confluent Enterprise subscription customer, you have already agreed to our license agreement. If you are a Confluent Enterprise subscription customer, then you are bound by the terms of the agreement between your company and Confluent.
If you are not a customer, your download includes a 30 day free trial for Control Center. Control Center will stop functioning 30 days after you install the software. Any Kafka Connect Connectors that you created will still function; you can use the Kafka Connect API to change them, but you cannot use Control Center to make changes to connectors. Stream Monitoring will continue to log data, but the web application will not continue to function. If you would like to learn more about how to become a Confluent Platform Enterprise subscription customer, please visit our web site.
If you are a customer, we will issue you a license key and all of the functions of Control Center will be unlocked for the term of your subscription. If the Stream Monitoring functionality has become disabled, please contact us through our support portal for assistance.
If you would like to remove Control Center from your system, please follow these instructions.
Inside the archive, Control Center resources can be found in the following locations:
- Java Archives are found in
- Configuration files are found in
- Executables are
You can remove this all with a command like:
$ rm -rf share/java/confluent-control-center \ share/java/monitoring-interceptors \ etc/confluent-control-center \ bin/control-center-*
If you installed with
apt-get as a superuser, you can remove Control Center with a command like:
$ sudo apt-get remove confluent-control-center
Otherwise, follow the directions for the package management tool that you used.