Alerting

XorMon uses zabbix_sender to send alerts to Zabbix.

  1. Install Zabbix agent in any way like:
    RedHat:
    dnf install https://repo.zabbix.com/zabbix/6.4/rhel/8/x86_64/zabbix-release-6.4-1.el8.noarch.rpm
    sudo dnf clean all
    sudo dnf install zabbix-sender
    Debian:
    wget https://repo.zabbix.com/zabbix/7.0/debian/pool/main/z/zabbix-release/zabbix-release_latest_7.0+debian12_all.deb
    dpkg -i zabbix-release_latest_7.0+debian12_all.deb
    apt update
    apt install zabbix-sender
  2. Install zabbix_sender as per you OS platform:
    www.zabbix.com/documentation/current/en/manual/installation/install_from_packages
    repo.zabbix.com/zabbix/

  3. Create a new host in Zabbix or use existing one
    XorMon Zabbix alerting setup

  4. Create new item for that host with:
    Type: Zabbix trapper
    Type of information: Text
    XorMon Zabbix alerting setup 2

  5. In the XoxMon fill in the Zabbix Server, Port, Host and Key as you have entered in Zabbix
    XorMon Zabbix alerting setup 3

  6. Press the Test button to check test message in Zabbix
    XorMon Zabbix alerting setup 4

Follow this to read about Anomaly alerting.
Follow this to read about Ping alerting.
You can create alerts based on performance data metrics for all configured devices.
Any metric that is collected by the tool can be selected for alerting.
Configure it via the UI ➡ Settings ➡ Alerting ➡ Configuration
Define email groups under "Email" tab at first.

How to create a new alert

Storage-based alert: select "Storage" ➡ New Alert Group
Alerting cfg 1

Put a name, select a class, subsystem (volume) and volumes here via regex ('.*' means all volumes on all storage devices) ➡ Add
Alerting cfg 2

Select a metric (Latency)
Alerting cfg 3

Put threshold and email targed groups defined in advance ➡ Save
Alerting cfg 4

Then via a "+" sign in the alert line on the right you can add more metrics to be alerted for the same alert group.

Video

  • Alerting
  • Filter items by parent device

Examples

Email alerts have included graphs by default, you can set your own time range of that graph in the Alerting Options tab

Storage email alert
Alerting example 1

Alerting example 1 attachement


Server email alert
Alerting example 2

Alerting example 2 attachement


It raises an alert when any critical HW or SW error is detected for any devices.
Basically, the alert is sent when any device goes to the "red" status in the global health status dashboard.
Once a device goes back to "green", clear alert is sent.
You can configure via the UI ➡ Settings ➡ Alerting ➡ Options HW Event
Define email groups under "Email" tab at first.

Alerting event
So far available:
  • Email
  • SNMP Trap
  • ServiceNow

Other integrations like bellow (they are supported by our original tools LPAR2RRD/STOR2RRD) will be done on user/customer requests
  • AlarmsOne
  • Riverbed NetIM
  • HPE OpenView
  • Jira
  • Nagios
  • others can be done as needed

Select prefered integration for each alert

Alerting integration select
ServiceNOW integration
The Integration builder allows you to send HW events and alerts from Xormon to any other tool that supports REST API or Webhooks.
With Integration builder you can compose the request:
  • endpoint URL
  • method (GET, POST, PUT, PATCH, DELETE)
  • request headers
  • request body in JSON format
Request body can contain several predefined variables with information from the alert.
For example
  • {DEVICE} - device name
  • {STATUS} - reported status
  • {METRIC} - name of the metric being alerted
  • {VALUES} - values that triggered the alert
  • {ITEMS} - list of items crossing the threshold valaue
  • And more
Configuration
Xormon UI → Settings → Alerting → tab: Integrations
Alerting API - New integration


Alerting API - Request

Performance alert request body examples:
{
  "name": "Custom Alert",
  "data": {
    "items": "{ITEMS}",
    "level": "{LEVEL}",
    "limit": "{LIMIT}",
    "metric": "{METRIC}",
    "values": "{VALUES}"
  }
}     

Add newly created integration to Alert or HW event configuration
Alerting API - Alert


Alerting API - HW event
How to use Integration builder to send alerts from XorMon to Discord using webhook.

  • Create new webhook in Discord
    Go to server settings -> Integrations -> Webhooks
    Enter the name and channel where you want to receive messages.
    Discord Webhooks

  • Copy webhook URL

  • Create new Integration in XorMon
    - Go to Settings -> Alerting -> Integrations
    - Click "New Integration"
    - Select POST method
    - Paste Discord webhook URL
    - Add header "Content-Type: application/json"
    - Add JSON message
    - The message has to contain:
      - "username" - the name used when creating the webhook
      - "content" - the content of the message that will be sent to the Discord channel

    Message example for HW Event:
    {
      "content": "HW Event: {DEVICE} ({CLASS}/{HW_TYPE}) changed to {STATUS} ({REASON})",
      "username": "XorMon"
    }
    Create new integration

  • Test the integration
    You should get test message in the Doscord channel
    Discord Webhooks

  • Use the new integration in a HW Event configuration
    Discord Webhooks