# MQTT Topics

When selecting an MQTT source, it is possible to configure the MQTT topics to subscribe and its configuration using the `Topics` tab. This page allows the user to remotely configure the [mqtt.json file](/collector/configuration/mqtt-json.md). It is possible to also configure this file manually, for more information, check its page.

![MQTT Topics page](/files/C8k7IP2fVG7RQ3mGrn3v)

The image above shows the `Topics` page for a new source. As shown above there is no configuration present for any topics. Here is how you can add a new configuration for a specific topic:

### Adding a new topic configuration

First you must click the `New Topic` button on the left side of the screen as shown in the image bellow.

![New Topic Button](/files/dQz8KsZ2yWjRyZogoNuB)

After clicking the `New Topic` button, the right side of the screen should update, as shown in the image bellow.

![New Topic Screen](/files/eUSRH01kar5GKD3R5zyp)

Now you must add the necessary information for the topic subscription. For more information, check the next step.

### Configuring the topic to subscribe

To configure a topic for subscription, you must be on the `About` tab of the `Topic Details` page as shown in the image bellow.

![Topic Configuration](/files/Ca3mMRWdl6gqyIZJulJw)

As shown above, you must specify some values. Here is some information on each field:

| Name                     | Description                                                                                                         | Required |
| ------------------------ | ------------------------------------------------------------------------------------------------------------------- | -------- |
| Title                    | <p>The name of this specific configuration.<br>This is used to better organize all topic configurations.<br></p>    | no       |
| Topic Path               | <p>The topic to subscribe to.<br>This is usually in an <code>path</code>-like format.<br></p>                       | **yes**  |
| Quality of Service (QoS) | <p>The QoS of the subscription.<br>This will specify how the MQTT broker should validate messages received.<br></p> | **yes**  |

After specifying the values for the topic configuration, you must configure the wanted transmitted channels from the received MQTT messages. For more information, check the next step.

### Configuring Channels

To configure a channel, you must be on the `Channels` tab of the `Topic Details` page.

![Channel Configuration Page](/files/SGKKiiSkVi5ioSmH1TAD)

In this page you can configure the channels to transmit to Live and how its data can be perceived by Live.

Each MQTT message will be parsed into channels based on the attributes received by the broker. Each channel configuration acts as a filter, only allowing data transmission to Live channels that are configured in this page.

If you don't know how each channel will be transmitted and/or how an MQTT message will be parsed, you can use the `Transmit every channel from this topic` toggle.

![Transmit Every Channel Toggle](/files/m73JsTuAAV1L99loR47K)

In the `Data Timestamp` field, you can configure how to timestamp the data received by the LiveRig Collector. You can configure to use the capture moment as the data's timestamp, or, you can set a received channel as the data's timestamp.

![Data Timestamp](/files/881megdi0R6duuvSUooC)

You can configure the channels to transmit and their units using the table. The list of units of measurement is the same as used by live, so it's possible that some units could be hidden or customized units could be shown through customization of the platform.

![Channel Configuration Table](/files/vbGa8QsSjUMDBSy7v4Oj)

After saving the new topic configuration, it takes some time to the collector to apply those changes.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://drilling.intelie.com/collector/remote-control/sources/mqtt-topics.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
