Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

This configuration option allows for a comma separated list of namespaces that will be filtered/disabled for connections to this MQTT Server. 

This filter will apply applies to both the default namespaces (Elecsys, Xirgo, Sparkplug A and Sparkplug B) and any custom namespaces configured.

Note
The ‘Filtered Namespaces' are applied to the respective server only. If connection is switched to another server within the same server set, filtered namespaces are not applied.

...

Example

A system with Edge devices publishing using the Sparkplug B protocol to Server A and Edge devices publishing MQTT messages to another Server B.

In this instance the Access Control Lists (ACLs) on Server B may not allow for the subscriptions required by MQTT Engine for the Sparkplug B protocol. Setting the Filtered Namespaces for the MQTT Engine Server configuration for Server B to "Sparkplug B" will disable the namespace for this server connection.

MQTT Engine Namespaces Default - Sets

The MQTT Engine Namespaces > Default > Sets tab allows for specific Server Sets to be associated with the namespace.

This configuration expands on the MQTT Engine Servers - Filtered Namespaces by applying to all servers in a specific server set. If connection is switched to another server within the same server set, filtered namespaces are applied.


MQTT Engine Namespaces Default - Filters

The MQTT Engine Namespaces > Default > Filters tab allows for specific Group or Group/EdgeNode combinations to be included in the MQTT Engine subscriptions to specific MQTT Servers. 

Note

The ‘Filters' are applied to the respective server(s) only. If connection is switched to another server within the same server set, filters are not applied and the required Sparkplug B subscriptions will be used.

Ensure that any Access Control Lists (ACLs) configured on the server match the Group or Group/EdgeNode configured in the Namespace Filter

Example for the Sparkplug B namespace

Setting the Group ID to 'Location1' will limit the subscriptions on the specific server to:

  • spBv1.0/Location1/#
  • spBv1.0/STATE/primary_host_id

Setting the Group ID to 'Location1' an Edge Node ID to 'Stream1'  will limit the subscriptions on the specific server to:

  • spBv1.0/Location1/+/Stream1
  • spBv1.0/STATE/primary_host_id


MQTT Engine Namespaces Custom - Sets

Custom Namespaces are used to provide support for generic, non Sparkplug compliant MQTT messages with string based payloads. The MQTT Engine Namespaces > Custom > Sets tab allows for specific Server Sets to be associated with the namespace.

This configuration expands on the MQTT Engine Servers - Filtered Namespaces by applying to all servers in a specific server set. If connection is switched to another server within the same server set, filtered namespaces are applied.