Contents
Cirrus Link Resources
Chariot MQTT Server v1 (previous version)
Cirrus Link Modules for Ignition
Contact Us (Sales/Support)
Forum
Page History
...
| Anchor | ||||
|---|---|---|---|---|
|
Dashboard
The Chariot dashboard provides a high level view of Chariot server and system status information.
| Anchor | ||||
|---|---|---|---|---|
|
...
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.
| Anchor | ||||
|---|---|---|---|---|
|
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 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: 
| Anchor | ||||
|---|---|---|---|---|
|
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.
| Anchor | ||||
|---|---|---|---|---|
|
...
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
| Anchor | ||||
|---|---|---|---|---|
|
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