Events Hub Manage View
The manage view in Events Hub is a comprehensive interface that allows you to configure events. This guide will provide an explanation of the manage view, its sections, and functionalities.
Last updated
The manage view in Events Hub is a comprehensive interface that allows you to configure events. This guide will provide an explanation of the manage view, its sections, and functionalities.
Last updated
The manage view in Events Hub is a robust interface that allows you to configure and monitor events in detail. By understanding and utilizing each section, you can efficiently manage your events, ensuring they are accurately set up and effectively monitored. Use this guide to navigate the manage view and leverage its full capabilities.
You can access the manage view in two ways.
From the List View: Click the manage action button (gear icon) on the right side of an event in the list view.
From the Device Detail Events Tab: Click the event manage action button in the device detail events tab.
The manage view is divided into several logical sections, each containing specific settings and information related to the event. These sections can be opened or collapsed by clicking on their titles.
Alert Mode: Toggle between Manual and Auto modes.
Alert Status: Shows whether the alert is Active or Inactive.
Alert Name: Field to set the name of the alert.
Entity: Dropdown to select the entity associated with the event.
Condition Mode: Toggle between "All" or specific conditions.
Condition Label: Field to label the condition.
Limit: Field to set the limit value.
Alert Condition: Dropdown to specify the alert condition type.
Add New Condition: Button to add more conditions as needed.
Delete Button: Each alert condition has a Delete icon next to it. When the user clicks this icon, a confirmation window will appear, asking whether they want to proceed with deleting the selected condition.
This section allows you to define the actions that will be taken when the alert conditions are met
This section provides settings related to the sensors involved in the event.
Free Text Space: Allows users to add notes related to the event. Useful for adding context, reminders, or additional information.
Audit Trail: Displays a full history of all events associated with the current event, including edits, actions taken, and notifications sent. This helps in tracking the event's history and any changes made.
Created By and Date: Shows who created the event and when.
Last Edited By and Date: Shows who last edited the event and when.
Some sections of the manage view contain more detailed configurations that will be explained on separate pages. These include:
Details about the event's current operational status and how it is managed within the system.
Comprehensive setup of the conditions that trigger the event, including multiple condition configurations.
Specifications of actions that will be executed when the event conditions are met, such as notifications, data processing, or system commands.
Detailed settings related to the sensors that provide the data for the event triggers.
Set Alert Name: Enter a descriptive name for the alert.
Select Entity: Choose the appropriate entity from the dropdown menu.
Choose Condition Mode: Toggle between "All" conditions or specific conditions.
Label Conditions: Provide a label for each condition.
Set Limits: Enter the threshold values for conditions.
Specify Alert Conditions: Select the type of condition (e.g., value goes above limit).
Enter Notes: Use the free text space to add any relevant information or context about the event.
Audit Trail: Check the logs section to see a detailed history of actions, edits, and notifications related to the event.
Creator Information: View who created the event and when it was created.
Last Editor Information: View who last edited the event and when it was edited.
The Event Hub Status section allows users to control the activation and monitoring of events based on specific conditions. Here’s a detailed explanation of its features and functionalities.
The Event Hub Status section provides a flexible and intuitive way to manage when events are actively monitored. By using Auto mode, you can set specific conditions based on time periods to ensure events are only active when needed. Manual mode offers straightforward control for quick activation or deactivation. Utilise these settings to optimise event monitoring and ensure efficient system performance.
Description: In Auto mode, the event's monitoring status automatically changes based on user-defined conditions.
Functionality:
The system monitors the specified conditions (days of the week, hours of the day, and months of the year).
If the conditions are met, the event will not be monitored and will not be triggered.
Example: If an event should only be active during weekdays from 9 AM to 5 PM in January, set the conditions accordingly. Outside these conditions, the event will not be monitored.
Description: In Manual mode, users can manually set the event to be either Active or Inactive.
Functionality
Active: The event is actively monitored and can be triggered.
Inactive: The event is not monitored and cannot be triggered.
Description: Allows users to select the months during which the event should be active.
Functionality:
Click on the month buttons to toggle them on or off.
Green Button: The event is active during this month.
Gray Button: The event is inactive during this month.
Description: Allows users to select the days of the week during which the event should be active.
Functionality
Click on the day buttons to toggle them on or off.
Green Button: The event is active on this day.
Gray Button: The event is inactive on this day.
Description: Allows users to select the hours of the day during which the event should be active.
Functionality
Use the slider to set the active hours range.
Green Bar: Indicates the hours during which the event is active.
Adjust the start and end points to define the active time range.
Selecting Alert Mode
Toggle between Auto and Manual modes using the switch.
Setting Manual Mode
Switch to Manual mode.
Set the event to Active or Inactive using the toggle.
Configuring Auto Mode
Switch to Auto mode.
Select the active months by clicking the respective month buttons.
Select the active days by clicking the respective day buttons.
Adjust the slider to set the active hours range.
Activating/Deactivating Time Periods
Click on the month, day, or adjust the hours slider to toggle the event's activity status for those periods.
Green indicates active periods, and Gray indicates inactive periods.
Select Auto Mode.
Months: Click on "JAN" to keep it green (active) and click on other months to turn them Gray (inactive).
Days: Click on "MON", "TUE", "WED", "THU", and "FRI" to keep them green (active) and click on "SAT" and "SUN" to turn them Gray (inactive).
Hours: Adjust the slider to cover 9 AM to 5 PM (9 to 17 on the slider).
AlphaX allows you to set up various alert conditions to monitor system events and trigger alerts based on predefined criteria. This guide explains how to configure these alert conditions.
By following these guidelines, you can effectively monitor and manage system events in AlphaX, ensuring timely alerts and responses to critical situations.
First Mode
This mode matches the first condition that is true from the top of the list.
Once a condition is matched, it stops processing further conditions.
Useful when you want the system to trigger an alert immediately upon meeting the first criterion.
All Mode
This mode evaluates all the conditions in the list.
Useful when you need all specified conditions to be evaluated and potentially trigger multiple alerts.
AlphaX supports three types of conditions:
Value-Based Conditions
Options: Above, Equal, Below
Use this type to trigger alerts based on numerical values.
Example: Trigger an alert if a temperature sensor reads below 70 degrees.
Status-Based Conditions
Options: Payload Received, Device Offline, Error Code
Use this type to monitor specific status events of devices or systems.
Example: Trigger an alert when a device goes offline or an error code is received.
AI-Based Conditions
Option: Anomaly Detected
Use this type to leverage AI to detect unusual patterns or behaviours.
Example: Trigger an alert when the system detects an anomaly in data patterns.
Adding a Condition
Click the + Add New Condition button.
Enter a Condition Label to describe the condition.
Set the Limit value if applicable (e.g., 70 for Below 70% Capacity).
Choose an Alert Condition from the dropdown (e.g., Payload Received, Error Code).
Deleting a Condition
Click the trash can icon to the right of the condition you wish to delete.
Condition 1: Data Sent
Condition Label: Data Sent
Limit: 0
Alert Condition: Payload Received
Condition 2: Below 70% Capacity
Condition Label: Below 70% Capacity
Limit: 70
Alert Condition: Value goes below limit
Condition 3: Error Received
Condition Label: Error Received
Limit: 434
Alert Condition: Error Code
Prioritise Conditions: When using First Mode, arrange conditions by priority to ensure the most critical alerts are processed first.
Monitor Critical Systems: Use status-based conditions to keep an eye on vital system statuses like device connectivity and error codes.
Leverage AI: Incorporate AI-based conditions to detect and respond to unusual patterns that might not be immediately obvious through value-based conditions.
AlphaX provides several action options that can be triggered when an alert condition is met. This explains how to configure these actions to ensure you receive timely notifications and responses.
By configuring these actions, AlphaX ensures that alerts are communicated effectively, allowing for timely responses and minimizing downtime. Adjust the action settings based on your specific operational needs and the criticality of the systems being monitored.
Email Notification
Sends an email to the specified addresses when an alert condition is met.
Useful for immediate notification to stakeholders.
SMS Notification
Sends an SMS to the specified phone numbers.
Ideal for critical alerts that require quick attention, especially when email might not be immediately checked.
HTTP
Makes an HTTP request to a specified endpoint.
This can be used to integrate with other systems, trigger webhooks, or log events in external services.
Control
Executes a control action within the AlphaX system.
This can be used to automate responses, such as shutting down a machine, restarting a service, or changing a configuration.
MQTT
Publishes a message to an MQTT broker.
Useful for IoT applications where devices and services communicate through the MQTT protocol.
AlphaX allows you to set up notifications to ensure timely alerts through both email and SMS. Additionally, it can provide AI-powered insights to help understand the root causes and provide recommendations. Here's how to configure these settings.
Email Notification
Purpose: Sends an email to the specified recipients when an alert condition is met.
Configuration
Notify List: Enter the email addresses of the recipients. In the example, it's sanjeeva.nadaras@minnovation.com.au.
Notification Subject: Provide a clear and concise subject for the alert email. In this case, "Bin level over 70% used".
Notification Body: Include a detailed message that explains the alert. Here, it states, "Bass Coast Bin level over 70% used".
SMS Notification
Purpose: Sends an SMS to the specified phone numbers for immediate alerts.
Configuration
Similar to email notifications, you will need to specify the phone numbers and message content. Ensure the message is concise due to SMS character limits.
Active Actions:
Email Notification: Enabled
SMS Notification: Enabled
Notify List:
Email: sanjeevan.nadarasa@minnovation.com.au
Notification Subject: "Bin level over 70% used"
Notification Body: "Bass Coast Bin level over 70% used"
AI:
Recommendations: Enabled
Root Causes: Enabled
AlphaX includes AI capabilities to enhance the usefulness of notifications by providing additional insights:
Recommendations
Purpose: Analyses data and provides suggestions on the best actions to take in response to the event based on current conditions.
Example: If a bin level is over 70%, the AI might recommend scheduling an additional pickup or checking for obstructions.
Root Causes
Purpose: Analyses data to determine possible causes of the alert condition and provides these to the user in the notification body.
Example: For a bin level alert, the AI might identify increased usage due to a nearby event or an issue with the regular pickup schedule.
AlphaX allows you to configure HTTP actions to interact with external systems whenever an alert condition is met. This guide provides detailed instructions on setting up HTTP event actions.
Enable HTTP Action
Check the box next to HTTP to activate the HTTP action.
HTTP URL
Purpose: Specifies the endpoint URL that the HTTP request will be sent to.
Example: https://xxx.mysite.com/createMyWorkorder
Ensure the URL is correctly formatted and accessible from the AlphaX system.
Headers
Purpose: Allows you to include additional information in the HTTP request header.
Example Header
Key: token
Value: abcxxx
Add headers by clicking the + Add Header button. You can add multiple headers as needed for authentication or other purposes.
HTTP Method
Purpose: Specifies the format and encoding of the HTTP request body.
Options,
Plain text: Sends the data as plain text.
Multipart Form: Sends the data as a multipart form, typically used for file uploads.
x-www-form-urlencoded: Sends the data as key-value pairs encoded in the URL.
JSON: Sends the data in JSON format, commonly used for APIs.
Select the appropriate method based on the requirements of the receiving endpoint.
Scenario: Creating a Work Order
HTTP URL: https://xxx.mysite.com/createMyWorkorder
Headers:
Key: token
Value: abcxxx
HTTP Method: JSON
Activate HTTP Action
Ensure the HTTP action checkbox is checked.
Enter the HTTP URL
Type the endpoint URL in the HTTP URL field.
Add Headers
Click + Add Header to add a new header.
Enter the header key (token) and value (abcxxx).
Add more headers if necessary by repeating the process.
Select HTTP Method
Choose the method that matches the expected input format of your endpoint. For example, select JSON if the endpoint expects JSON formatted data.
Authentication: Use headers to include tokens or API keys for authenticated requests.
Data Formatting: Ensure the data sent in the HTTP request matches the expected format of the endpoint to avoid errors.
Testing: Test the HTTP action with your endpoint to confirm it works as expected before relying on it for critical alerts.
By configuring HTTP event actions, you can seamlessly integrate AlphaX with external systems, automating workflows such as creating work orders, logging events, or triggering additional processes. This enhances the responsiveness and efficiency of your operations.
Event controls in AlphaX allow you to automate responses to specific alert conditions by changing the state of control elements within your system. This guide explains how to configure these controls to ensure efficient and automated management of your devices and systems.
Event controls enable AlphaX to automatically perform actions such as turning equipment on or off, adjusting settings, or executing predefined commands in response to specific conditions being met.
Enable Control Action
Check the box next to Control to activate the control action.
Select Control Element
From the dropdown menu, choose the control element you want to manage.
Example: SM01LW Pump Control [Seven Mile Waste Facility]
Ensure you select the correct control element that corresponds to the device or system you wish to control.
Set Control State
Use the toggle switch to set the desired state of the control element when the alert condition is met.
Options
On: Turns the control element on.
Off: Turns the control element off.
Example: Setting the pump control to On activates the pump when the specified alert condition is triggered.
Scenario: Automatically Activating a Pump
Control Element: SM01LW Pump Control [Seven Mile Waste Facility]
Control State: On
Enable Control Action
Ensure the Control action checkbox is checked.
Select the Control Element
Choose SM01LW Pump Control [Seven Mile Waste Facility] from the dropdown menu.
Set the Control State
Toggle the switch to On to ensure the pump is activated when the alert condition is met.
Automated System Responses
For instance, if a waste bin level exceeds 70%, the system could automatically turn on a pump to start compacting the waste.
Safety and Emergency Management
Automatically turning off machinery if an error condition is detected to prevent damage or hazards.
Operational Efficiency
Adjusting lighting, heating, or cooling systems based on occupancy or environmental conditions detected by sensors.
By configuring event controls in AlphaX, you can automate your system's response to specific conditions, ensuring timely and efficient management of devices. This automation reduces the need for manual intervention, improves safety, and enhances operational efficiency. Adjust the control elements and states according to your specific requirements and operational needs.
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.
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.
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.
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.
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.
Host/Server
Purpose: The hostname or IP address of the MQTT broker.
Example: mqtt.alphax.cloud
Ensure the broker is accessible from the AlphaX system and correctly configured to accept connections.
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: mqtt.alphax.cloud
Enable MQTT Action
Ensure the MQTT action checkbox is checked to activate this action.
Configure the Topic
Enter the topic in the Topic field where the message will be published.
Compose the Message
Write the message content in the Message field. Ensure it contains all necessary information related to the alert.
Enter Credentials
Provide the Username/User ID and Password for authentication with the MQTT broker.
Set the Host/Server
Enter the hostname or IP address of your MQTT broker in the Host/Server field.
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.
Data Collection
Send sensor data to an MQTT broker for real-time processing and monitoring.
Example: Publish temperature readings to a central monitoring system.
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.
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.
Throttle events in AlphaX are used to control the frequency of actions triggered by alert conditions, preventing repetitive alerts and ensuring that actions are not executed too frequently. This guide explains how to configure throttle settings effectively.
Throttle Active
Purpose: Enables throttling to limit the number of times an action is triggered within a specified time period.
Example: Ensuring an action is not triggered more than once every 24 hours.
Limit 1 Action Per
Purpose: Defines the time interval during which only one action can be triggered.
Example: Setting the interval to 24 hours means that once an action is triggered, no further actions will be triggered for the next 24 hours, regardless of how many times the alert condition is met.
Scenario: Limiting Notification Frequency
Throttle Active: Enabled
Limit 1 Action Per: 24 hours
Enable Throttle
Check the box next to Throttle Active to activate throttling for the selected action.
Set the Throttle Interval
Enter 24 in the Limit 1 Action Per field.
Select Hours from the dropdown menu to set the interval to 24 hours.
Preventing Alert Fatigue
Avoid overwhelming users with too many notifications by limiting the frequency of alerts.
Example: If a sensor frequently reports a minor issue, throttling ensures users receive only one notification per day, reducing annoyance and focusing attention on significant issues.
System Stability
Protect system resources by preventing actions from being executed too frequently.
Example: Limiting the number of times a control command is sent to a device, ensuring it is not overloaded with repeated commands.
Resource Management
Efficiently manage resources by controlling the frequency of actions that might consume bandwidth or processing power.
Example: Limiting HTTP requests to external systems to avoid excessive API calls.
By configuring throttle settings in AlphaX, you can effectively manage the frequency of actions triggered by alert conditions, ensuring that notifications and commands are executed at appropriate intervals. This helps to prevent alert fatigue, protect system stability, and manage resources efficiently. Adjust the throttle settings based on your specific.
The Event Sensors section in AlphaX is designed to provide a clear and manageable overview of all sensors and devices being monitored by the event.
The Event Sensors section in AlphaX provides a comprehensive overview and management interface for sensors and devices being monitored. This guide explains the components and functionalities of the Event Sensors section to help you effectively manage your monitoring setup.
The table in the Event Sensors section displays a list of all sensors and devices being monitored. Here's a breakdown of the key components and functionalities.
Buttons in the Top Right
Manage Sensors: Opens a management interface for configuring and managing the sensors.
Add Sensors: Opens a modal window that allows you to add new sensors and devices to the monitoring list.
Filter in the Top Left
Filter Box: Allows you to filter the list of sensors by specific criteria. Enter text to quickly search for a particular sensor or device based on its attributes.
Pagination in the Bottom Right
Previous/Next Buttons: Navigate through pages if there are multiple entries. This helps in managing large lists of sensors.
The table includes several fields describing the sensors and devices.
Channel ID
Unique identifier for each sensor channel.
Channel Description
Brief description of what the sensor measures or its purpose.
Example: "Raw Distance"
Device Name
The name of the device to which the sensor is attached.
Hyperlinked to access the device management page, allowing for detailed configuration and status checks.
Device Tag
A tag or identifier for the device.
Example: ZZZ-BINS-001
Value
Current reading or value from the sensor. This field might be empty if no data is currently available.
Status
Indicates the current status of the sensor.
Example: OK for normal operation, other statuses might indicate issues or warnings.
Last Seen
Timestamp of the last communication from the sensor.
Example: Never if the sensor has not yet reported data.
Actions
Includes a delete button (trash can icon) that allows you to remove the sensor or device from the monitoring list.
Managing Sensors
Click the Manage Sensors button to access the sensor management interface.
Add Sensors: Add new sensors and devices to your monitoring system for a specific alert.
Show Hidden Channels: Toggle visibility of additional sensor channels that might be hidden.
Save Changes: After selecting or removing sensors, click Save to confirm changes. This will reset the alert status of all selected sensors.
Deleting Sensors
In the Actions column, click the trash can icon next to a sensor to remove it from the list.
Warning ! : This action will permanently delete the sensor from your monitoring setup.
The Event Sensors section in AlphaX is designed to provide a clear and manageable overview of all sensors and devices being monitored. Utilize the filtering, pagination, and management buttons to effectively navigate and manage your sensor data. The hyperlinked device names allow for quick access to detailed device management pages, enhancing your ability to configure and monitor your system efficiently.
