Skip to main content

MQTT system topics

FairCom MQ automatically publishes system messages to three topics

FairCom MQ automatically publishes system messages to three topics:

  • faircomAdmin/connections lists all MQTT connections to the broker.

  • faircomAdmin/subscribers lists all the subscribers and their subscriptions.

  • faircomAdmin/topics lists all topics available for publishing and subscribing.

faircomAdmin/connections JSON message example

{
  "clientId":"fcClient_1700005322535",
  "username":"admin",
  "ipaddress":"127.0.0.1",
  "port":60190,
  "qos":2,
  "mqttProtocol":4,
  "keepAliveSeconds":60,
  "connectionStatus":"Connected with clean flag = 0",
  "connectionTimestamp":"2023-11-14T23:42:06",
  "subscriptions":[
    {
      "topicExpression":"faircomAdmin\/subscribers"
    },
    {
      "topicExpression":"faircomAdmin\/connections"
    },
    {
      "topicExpression":"faircomAdmin\/topics"
    }
  ]
}

faircomAdmin/subscribers JSON message example

{
  "subscribers":[
    {
      "topicExpression":"faircomAdmin\/subscribers",
      "connections":[
        {
          "clientId":"fcClient_1700005322535",
          "username":"admin",
          "ipaddress":"127.0.0.1",
          "port":60190,
          "qos":2,
          "mqttProtocol":4,
          "keepAliveSeconds":60,
          "connectionStatus":"Connected with clean flag = 0",
          "connectionTimestamp":"2023-11-14T23:42:06"
        }
      ]
    }
  ]
}

faircomAdmin/topics JSON message example

{
  "topics":[
    {
      "name":"faircomAdmin\/connections",
      "topicCreationTimestamp":"2023-11-14T23:01:59.505",
      "lastMessageTimestamp":"2023-11-14T23:57:44.040",
      "messageCount":665,
      "averageMessagesPerMinute":12.0,
      "averageMessagesPerHour":665.0,
      "averageMessagesPerDay":665.0,
      "subscribers":[
        {
          "topicExpression":"faircomAdmin\/connections",
          "connections":[
            {
              "clientId":"fcClient_1700005322535",
              "username":"admin",
              "ipaddress":"127.0.0.1",
              "port":60190,
              "qos":2,
              "mqttProtocol":4,
              "keepAliveSeconds":60,
              "connectionStatus":"Connected with clean flag = 0",
              "connectionTimestamp":"2023-11-14T23:42:06"
            }
          ]
        }
      ]
    }
  ]
}