Versions Compared

Key

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

...

The Chariot MQTT Server Web UI provides the following status pages for monitoring server activity, logs, and data.

Anchor
Dashboard
Dashboard

Dashboard

The Chariot dashboard provides a high level view of Chariot server and system status information.

Image Added

Anchor
Logging
Logging

Logging

The Logging page has two tabs when a user can either view live Chariot logs or modify log levels.  Additionally, a zip file containing the Chariot logs can be downloaded.

Live Logs

Live Chariot logs can be viewed on the Live logs tab.  The live logs can be filtered by matching message text or selecting a minimum log level.  A live toggle allows for enabling/disabling live log updates to the page.

Image Added

Download Logs

The menu button at the top of the page contains an option for downloading a zip file containing the Chariot logs.

Image Added

Log Levels

The second tabs allows for modifying log levels. The log levels can be filtered by name and each logger can have the level set to one of: TRACE, DEBUG, INFO, WARN, and ERROR.

Image Added

Anchor
Sparkplug
Sparkplug

Sparkplug

The Sparkplug page tracks data from Sparkplug MQTT clients that are connected to the Chariot MQTT server. The tracking can be disabled by clicking on the menu button at the top.

Overview

The Overview tab provides a quick look at the number of Sparkplug Host Applications, Groups, Edge Nodes, and Devices that are being tracked by Chariot.

Image Added Host Applications

The Host Applications tab will show all Sparkplug Host applications that Chariot is tracking.  Selecting a host application from the list will show additional details such as the last time it was online or offline.

Image AddedEdge Nodes

The Edge Nodes tab will show all Sparkplug Edge Nodes and any Devices that Chariot is tracking.  Selecting an Edge Node from the list will show additional details and also populate the list of the Edge Node's Devices below. Buttons on the far right of each Edge Node entry in the list provide tools for sampling compression and downloading the Sparkplug Edge Node birth (NBIRTH) and Device birth (DBIRTH) payloadS in JSON format.

Image Added

Anchor
MQTT
MQTT

MQTT

The MQTT Clients pages show details of all clients connected to the Chariot MQTT server.  A searchable dropdown list is used to select an MQTT client and view network details, session information, LWT details, and a list of subscriptions.

Image Added

Anchor
Alerts
Alerts

Alerts

The Alerts page provides a place to view and manage any alerts that are generated in the Chariot Server

Live Alerts

The Live Alerts tab shows a live view of alerts as they are generated. Individual alerts can be acknowledge and cleared. The alerts displayed can be filtered by matching text in the description, selecting an alert type, and/or hiding cleared or acknowledged alerts.

Image AddedTypes

The Types tab allows for the enabling/disabling of specific alert types as well as changing the priority (1, 2, or 3).

Image AddedSome of the Alert Types supported in the Chariot Server include:

  • MQTT_DISCONNECT
    • An MQTT client has disconnected
  • MQTT_CONNECTION_LOST
    • An MQTT client has lost it's connection
  • MQTT_LWT_NOT_REGISTERED
    • An MQTT client has connected but not registered a last will
  • SPARKPLUG_SEQ_NUM_ERROR
    • Messages published from a Sparkplug MQTT client have been received out of sequence
  • SPARKPLUG_GROUP_EDGE_COLLISION
    • Multiple Sparkplug MQTT clients are using the same Group ID and Edge Node ID
  • SPARKPLUG_NONCOMPLIANT_LWT_TOPIC
    • A Sparkplug MQTT Client has registered an LWT that is not compliant with the Sparkplug specification
  • SPARKPLUG_TEMPLATE_DEF_COLLISION
    • A Sparkplug MQTT client is publishing template definitions that conflict with previously published definitions
  • SPARKPLUG_COMPRESSION_WARNING
    • A Sparkplug MQTT client is using data compression and the compressed data is actually larger in size then the uncompressed data