Skip to main content

Topic Mappings

Topic Mappings route MQTT topics to specific pipelines. When a message is published to a mapped topic, it is forwarded to the pipeline. There is no separate Topic Mappings page. They live in a section on the Pipelines page, edited inline with no dialog.

Editing topic mappings​

Use New mapping to add a row, and the Save button to stage your changes, which take effect after you deploy. Each row has:

  • TOPIC: the topic to match, for example devices/+/telemetry.
  • PIPELINE: the pipeline to forward matching messages to, picked by name.
  • a remove control.

A single topic can map to more than one pipeline, so the same message can reach several pipelines.

MQTT topic patterns​

Topic mappings support MQTT wildcards:

  • Single-level wildcard (+): sensors/+/temperature matches sensors/device1/temperature.
  • Multi-level wildcard (#): sensors/# matches all topics under sensors/.

Use cases​

Use topic mappings to:

  • Route different device types to different pipelines.
  • Send the same data to more than one TagoIO instance.
  • Forward only the topics you care about and ignore the rest.