This document describes the basic usage of the Chariot MQTT Server through the Chariot UI.
The UI can be accessed at the following URL:
http://<server-url>:8080
When installed on Linux, Windows or deployed via Azure Marketplace, the default login credentials are:
username: admin password: password
When deployed via AWS Marketplace, the default login credentials are:
username: admin password: EC instance ID for example: i-0049ac1e13e558b70
The Chariot MQTT Server Web UI provides the following status pages for monitoring server activity, logs, and data.
Dashboard
The Chariot dashboard provides a high level view of Chariot server and system status information.
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.
Download Logs
The menu button at the top of the page contains an option for downloading a zip file containing the Chariot logs.
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.
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 dynamic representation of the Sparkplug Host Applications, Groups, Edge Nodes, and Devices that are being tracked by Chariot.
Selecting a specific Edge Node will display the Edge Node details and explode the Devices associated with the Edge Node
Selecting a specific Device will display the Device details
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.
Edge 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.
Tools
The Tools tab allows you to generate Access Control Lists (ACLs) needed for Hosts and Edge Nodes.
ACLs define the topics that a client can publish and subscribe on and generating an ACL through the Sparkplug Tools will automatically add the the credentials to the MQTT Credentials section of the Chariot configuration. 
Select Generate Edge Node ACL to generate the ACLs for a Sparkplug client. Enter the client username, password and Primary Host ID (if needed). Add the required Sparkplug Edge Node IDs and select create.
A new entry for the username/password will be added to the MQTT Credentials section of the Chariot configuration.
Select Generate Host ACL to generate the ACLs for a Sparkplug Primary Host client. Enter the client username, password and Primary Host ID. Add the required Sparkplug Edge Node IDs and select create.
A new entry for the username/password will be added to the MQTT Credentials section of the Chariot configuration.
For the examples above, the MQTT Credentials will have been updated as shown below: 
MQTT
The MQTT page tracks the status of MQTT Clients.
Clients
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.
Retained Messages
The Retained Messages page shows all retained messages recorded by the Chariot Server.
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.
Types
The Types tab allows for the enabling/disabling of specific alert types as well as changing the priority (1, 2, or 3).
Some 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 an LWT (last will and testament)
- 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
Diagnostics
The Diagnostics page provides a view to the threads running within the Chariot Server. This information may be requested by Cirrus Link support personnel to assist in diagnosing issues with the Chariot Server.
Overview
Content Tools