HiveMQ Control Center v2: Data Hub View

HiveMQ Data Hub gives you the ability to ensure that the data you accept from your data sources has the quality you expect. Data Hub also makes it possible to model how your MQTT clients work with your broker.

The current Data Hub views provide a subset of functionality. Data Hub integration will be expanded in future releases.

From the Data Hub views, you can review your schemas, data policies, behavior policies, and scripts. You can also browse available modules, and create, configure, and manage module instances.

For detailed information on Data Hub features and configuration options, see HiveMQ Data Hub.

Schemas

Schemas are an essential part of data policies. Your Data Hub schemas define the rules and constraints that MQTT payload data must adhere to. These constraints help to ensure data quality and to maintain the integrity of your HiveMQ deployment. Data Hub currently supports JSON Schema and Protobuf.

The Schemas view provides basic information for each schema on your HiveMQ cluster.

Since Data Hub supports schema versioning, each schema can have multiple versions. To enhance readability, the Schemas view displays only the latest version of each schema.

For more information on the use of schemas in HiveMQ Data Hub, see Schemas.

Table 1. Available schema information
Column	Description
Schema ID	The unique identifier of the schema.
Type	The schema type. For example, `JSON` or `PROTOBUF`.
Version	The latest version number of the schema.
Last Updated	The timestamp when the schema was last updated.

Data Policies

Data Hub data policies ensure that the payload data in MQTT messages has the structure and format you expect. Data policies use schema-based data validation to verify that MQTT data meets your requirements.

The Data Policies view provides basic information for each data policy on your HiveMQ cluster.

For more information on the use of data policies in HiveMQ Data Hub, see Data Policies.

Table 2. Available data policy information
Column	Description
Policy ID	The unique identifier of the data policy.
Topic Filter	The MQTT topic filter to which the data policy applies.
Created At	The timestamp when the data policy was initially created.
Last Updated	The timestamp when the data policy was last updated.

Behavior Policies

Data Hub behavior policies give you the ability to model the expected behavior of your MQTT clients throughout the entire client lifecycle. Client behavior is checked against your defined behavior model to determine whether the client is acting in the expected manner. The behavior model builds a level of control on top of the MQTT protocol with a state machine that checks how the client interacts with the HiveMQ broker.

The Behavior Policies view provides basic information for each behavior policy on your HiveMQ cluster.

For more information on the use of behavior policies in HiveMQ Data Hub, see Behavior Policies.

Table 3. Available behavior policy information
Column	Description
Policy ID	The unique identifier of the behavior policy.
Client ID Regex	The regular expression that matches the client IDs to which the behavior policy applies. For more information, see Behavior Policy Matching.
Created At	The timestamp when the behavior policy was initially created.
Last Updated	The timestamp when the behavior policy was last updated.

Scripts

Data transformation scripting gives you the ability to add custom JavaScript-based transformation functions to Data Hub data policies. Scripts can help you bring diverse data from IoT devices into a common format that your applications can understand and process.

The Scripts view provides basic information for each script on your HiveMQ cluster.

For more information on the use of scripts in HiveMQ Data Hub, see Transformations.

Table 4. Available script information
Column	Description
Script ID	The unique identifier of the script.
Description	A brief summary of the purpose of the script.
Version	The latest version number of the script.
Last Updated	The timestamp when the script was last updated.

Modules

HiveMQ Modules for Data Hub offer easy-to-use functionality that can be quickly accessed from the HiveMQ Control Center. Modules can be used to define fine-grained and fully flexible Data Hub policies or to utilize pre-defined modules that implement pre-defined functionality.

The HiveMQ Modules for Data Hub feature utilizes transformation scripts that are not yet fully supported for Linux Arm64. As a result, you cannot use the Data Hub Modules feature on Linux Arm64.

The Modules page provides two tabs: Modules to browse available modules across your configured registries, and Instances to view all running module instances.

For more information on the use of modules in HiveMQ Data Hub, see HiveMQ Modules for Data Hub.

Modules Tab

The Modules tab displays all available modules from your configured registries.

From this tab, you can select a module and create a new instance from it.

If a registry fails to load, a warning is displayed with the name of the affected registry.

Table 5. Information shown on each module
Entry	Description
Module Name	The name of the module.
Description	A brief summary of the capabilities and purpose of the module.
Maintainer	The entity responsible for the management of the module.
Registry	The name of the registry that provides the module.

Instances Tab

The Instances tab lists all module instances on your HiveMQ cluster. Each module instance represents a configured deployment of a specific module version.

From this tab, you can edit, enable, disable, and delete module instances.

Table 6. Available module instance information
Column	Description
Module	The name of the module from which the instance was created.
ID	The unique identifier of the module instance.
Version	The version of the module from which the instance was created.
Enabled	Indicates whether the module instance is currently enabled or disabled.
Created At	The timestamp when the module instance was initially created.
Last Updated	The timestamp when the module instance was last updated.