Events and Alerts
Edge Builder uses events to provide information on issues arising on an edge node and alerts to monitor aspects of edge nodes.
Edge Builder uses a system of Events to provide information about issues that arise on an edge node. Events are stored in the Edge Builder Controller, and are one of the types described in the following table:
|Internal||Any internal events raised when the Edge Builder Controller is managing the edge node||Resource||Events that are triggered when a monitoring alert is triggered on the edge node; for example when the CPU usage exceeds the threshold||App||Events referring to any issues with an app running on an edge node|
|Node||Events relating to any other issues associated with actions performed on an edge node|
All events are associated with an edge node.
When an event is registered, it is marked as
When an edge node has active events associated with it, its state changes to
Warning, unless the edge node is or has been in the
Down state, in which case the event state will be
You must review all
active events, using one of the following:
The REST API, using the following command where controller-ip must be replaced with the IP address of the Edge Builder controller:
curl -ski -X GET "http://controller-ip:8085/api/events?node=Node1" \ -H "Content-type: application/json" \ -H "Authorization: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJFeHBpcmVzQXQiOjE2MTEzMTQyNjEsIlBhc3N3b3JkIjoiRWRnZUJ1aWxkZXIxMjMiLCJVc2VybmFtZSI6ImlvdGVjaCJ9.c-VgQx1Iq184Vi_j9FdsnQcN6zWjTnPfKnm2C692Rbw"
The Edge Builder CLI, using the following command:
edgebuilder-cli event view -n node1
Edge Builder can assign and monitor configurable alerts on nodes. These alerts utilise Kapacitor and are customised using the Chronograf user interface. In Chronograf, alert rules are created, where custom configurations for the alerting can be set up. Examples of possible alerts include CPU usage above/below certain threshold, disk usage alerts, and many more.
Alert "rules" are created first, and these are described using TICKScripts. These are created automatically using Chronograf, but can also be manually edited. Once these rules are created, this can be added to a node by using the rule to describe an
alertDefinition in Edge Builder, before then deploying this as an
alert on a specific node.
Whenever Kapacitor detects that an alert has been triggered on the node, it will send this information to Edge Builder and an event will be created describing the details of the alert.
For a detailed tutorial on configurable alerts, see the configurable alerts tutorial