Configuring MQTT Alert Actions in AlphaX

AlphaX MQTT alert actions enable message publishing to an MQTT broker based on alert conditions. This guide covers setup for seamless IoT device communication.

MQTT Actions View

MQTT (Message Queuing Telemetry Transport) event actions in AlphaX allow you to publish messages to an MQTT broker in response to specific alert conditions. This guide explains how to set up MQTT event actions to ensure effective communication between AlphaX and your IoT devices or systems.

MQTT Event Actions Settings

  1.  Topic
    •  Purpose: The topic on which the message will be published.
    •  Example: /mytopic/xyz/123
    •  Ensure the topic follows the MQTT topic naming conventions and is appropriate for your message.
  2.  Message
    •  Purpose: The actual content of the message that will be sent to the MQTT broker.
    •  Example: This is an additional body of text
    •  The message should be clear and contain all necessary information relevant to the alert condition.
  3.  Username/User ID
    •  Purpose: The username or user ID for authenticating with the MQTT broker.
    •  Example: myUsername
    •  Ensure this matches the credentials configured on the MQTT broker.
  4.  Password
    •  Purpose: The password for the MQTT broker.
    •  Example: ****** (typically shown as asterisks for security)
    •  Ensure this is kept secure and matches the credentials on the MQTT broker.
  5.  Host/Server
    •  Purpose: The hostname or IP address of the MQTT broker.
    •  Example: my.mqtt.broker
    •  Ensure the broker is accessible from the AlphaX system and correctly configured to accept connections.

Example Configuration

Scenario: Publishing a Message to an MQTT Topic

  •  Topic: /mytopic/xyz/123
  •  Message: This is an additional body of text
  •  Username/User ID: myUsername
  •  Password: ******
  •  Host/Server: my.mqtt.broker

Steps to Implement

  1.  Enable MQTT Action
    •  Ensure the MQTT action checkbox is checked to activate this action.
  2.  Configure the Topic
    •  Enter the topic in the Topic field where the message will be published.
  3.  Compose the Message
    •  Write the message content in the Message field. Ensure it contains all necessary information related to the alert.
  4.  Enter Credentials
    •  Provide the Username/User ID and Password for authentication with the MQTT broker.
  5.  Set the Host/Server
    •  Enter the hostname or IP address of your MQTT broker in the Host/Server field.

Use Case Scenarios

  1.  Device Monitoring
    • Publish messages to specific topics to notify devices of status changes or instructions.
    • Example: Notify a device to start a specific task when a condition is met.
  2.  Data Collection
    •  Send sensor data to an MQTT broker for real-time processing and monitoring.
    •  Example: Publish temperature readings to a central monitoring system.
  3.  Alert Notifications
    • Notify administrators or systems of critical events by publishing messages to relevant topics.
    •  Example: Publish a high-priority alert to a topic monitored by an incident response system.

Summary

By configuring MQTT event actions, you enable AlphaX to communicate effectively with MQTT-enabled devices and systems, facilitating real-time data exchange and automation. Ensure all fields are correctly configured to establish a secure and reliable connection with your MQTT broker. Adjust the settings based on your specific use case and operational requirements.

NOTE: MQTT message is provided in standard AlphaX API output format with 3 additional objects embedded. One object contains the matched condition data. The second object contains AI descriptions and information (If selected). The third is the MQTT message text box. MQTT Data Format