HiveMQ Control Center (v2)

The HiveMQ Enterprise MQTT broker is built to support millions of concurrently-connected MQTT clients and a throughput of billions of messages per hour. This massive load of clients and messages can be challenging to manage and monitor. To simplify the operation of MQTT deployments of every size, HiveMQ provides a specialized Control Center that gives you quick and reliable access to the key metrics of your HiveMQ installation.

The HiveMQ Control Center offers a wide range of analytics that enable administrators to closely monitor MQTT client activity and quickly detect irregular behavior. For instance, easily identify MQTT clients that frequently drop messages. Our Control Center also provides a convenient way for administrators to complete administrative tasks such as disconnecting a specific client. Naturally, in keeping with HiveMQ principles, our Control Center is engineered to scale seamlessly alongside your HiveMQ deployment with consistent performance.

HiveMQ Control Center Versions

HiveMQ currently offers two control center versions:

HiveMQ Control Center v2 (new): The latest version of the HiveMQ Control Center.
HiveMQ Control Center v1: The original version of the HiveMQ Control Center.

For production environments, we highly recommend the use of a full monitoring setup in addition to your HiveMQ Control Center. There are many commercially available monitoring solutions to choose from. For more information on the ready-to-use extensions for popular monitoring solutions HiveMQ offers, visit the HiveMQ website.

Getting Started with HiveMQ Control Center v2

HiveMQ Control Center v2 is the new operational dashboard for your HiveMQ Broker.

The new Control Center version automatically ships with HiveMQ alongside the existing Control Center v1. No additional installation is required.

Starting with HiveMQ 4.39, HiveMQ Control Center v2 is generally available and can be used in production. You can access Control Center v2 from the Control Center main navigation or with the URL http://<host>:8080/v2/. During the upcoming transition phase, Control Center v2 will continue to run alongside the existing Control Center v1. Over the next few months, we will move functionality to the new interface and eventually retire Control Center v1.

Enable or Disable the HiveMQ Control Center

The <enabled> option in the <control-center> section of your HiveMQ configuration allows you to enable or disable your HiveMQ Control Center.

HiveMQ Control Center v1 and v2 use the same configuration options.

When you enable or disable the <control-center> feature in the <config.xml> file of your HiveMQ deployment, you enable/disable HiveMQ Control Center v1 and v2 simultaneously.

To activate Control Center v1 and v2, set the <enabled> option to true.

To deactivate Control Center v1 and v2, set the <enabled> option to false.

Example default HiveMQ Control Center configuration to enable Control Center v1 and v2

<?xml version="1.0"?>
<hivemq>
    ...
    <control-center>
        <enabled>true</enabled>
        ...
    </control-center>
    ...
</hivemq>

View Your HiveMQ Control Center

The HiveMQ Control Center is a web-based management and monitoring tool that is included in the standard HiveMQ distribution. Access the Control Center directly from your web browser. You do not need to install any additional software to use the HiveMQ Control Center.

When you run a HiveMQ instance on your local machine with the default configuration of the HiveMQ Control Center enabled, you can access HiveMQ Control Center v1 and HiveMQ Control Center v2 as follows:

Access the new HiveMQ Control Center v2 on http://localhost:8080/v2/.
Access the default HiveMQ Control Center v1 on http://localhost:8080/.

The default login for both control center versions is username admin and password hivemq.

Changing default passwords is a security best practice. You can easily configure custom credentials for your HiveMQ Control Center. For more information, see HiveMQ Control Center Access Control. If the default login credentials are in use, Control Center v2 shows a warning message.

Based on your specific HiveMQ setup, the URL for your HiveMQ Control Center can vary. You can also configure the control center to be available via HTTPS.

For security reasons, the default configuration of the HiveMQ Control Center listens only on the local network interface. You must modify the configuration to access the HiveMQ Control Center from another computer. For more information, see Access Control.