Reload alerts via MQTT
These settings are optional.
If alerts via MQTT are not of interest, just turn off this feature and leave the default values in the config as they are.
Do note though that Butler expects the configuration properties below to exist in the config file, but will ignore their values if the related features are disabled.
Butler can send two kinds of alert messages as MQTT messages:
- When a scheduled, running reload task fails.
- When a scheduled, running reload task is somehow stopped.
How it works
The MQTT message will be sent on the MQTT topic defined in the config file property
Butler.mqttConfig.taskFailureTopic, depending on the event type.
The task name will be sent in the message body.
The basic message looks like this when viewed in the MQTTLens app:
Optionally a larger, more complete message is also sent if
Butler.mqttConfig.taskFailureSendFull are set to true.
This message contains a stringified JSON of all available information about the failed/aborted task.
The message is sent on the
That message can look like this:
Don’t forget to create the log appender .xml files on the Sense server(s).
This page describes how.
Those xml files are the foundation on top of which all Butler alerts are built - without them the alerts described on this page won’t work.
The concept is more or less the same as for alert emails.
Settings in main config file
--- Butler: ... ... mqttConfig: enable: false # Should Qlik Sense events be forwarded as MQTT messages? brokerHost: <FQDN or IP of MQTT server> brokerPort: 1883 taskFailureSendFull: true taskAbortedSendFull: true taskFailureTopic: qliksense/task_failure taskFailureFullTopic: qliksense/task_failure_full taskFailureServerStatusTopic: qliksense/butler/task_failure_server taskAbortedTopic: qliksense/task_aborted taskAbortedFullTopic: qliksense/task_aborted_full ... ... udpServerConfig: enable: false # Should the UDP server responsible for receving task failure and session events be started? true/false serverHost: <FQDN or IP (or localhost) of server where Butler is running> portTaskFailure: 9998 ... ...
Was this page helpful?
Glad to hear it! Please tell us how we can improve.
Sorry to hear that. Please tell us how we can improve.