Events and alerts¶

Events and alerts configuration in Zentyal¶

The events module is a convenient service that allows you to receive notifications of certain events and alerts that happen in your Zentyal server.

Zentyal allows you to receive these alerts and events through the following dispatchers:

• Mail [1]
• Jabber
• Logs
• RSS

Before enabling any event you have to make sure that the events module is enabled. Go to Module status and check the events module.

Unlike in the Logs module, where all services are enabled by default except the firewall, you have to enable those events that might be of your interest.

To enable an event, you have to click on the menu entry Events ‣ Configure Events and tick the Enabled box on its row.

Configure events page

There are some events that need further configuration to work properly. This is the case for the log and free storage space observers.

The configuration of the free storage observer is pretty straightforward. The only required parameter is the free space percentage that will trigger the event when its actual value goes under it.

For the log observer, the first step is to select which domains you want to generate events from. For every domain, you can add filtering rules that depend on the domain. Some examples are: denied HTTP requests by the proxy, DHCP leases for a giving IP, canceled printer jobs, and so on. You can also create an event filter from an existing log query by clicking on the Save as an event button through Logs ‣ Query Logs ‣ Full Report.

Regarding the selection of channels for event notification, you can select the event dispachers in the Configure dispatchers tab.

Configure dispatchers page

In a similar way as enabling events, you have to mark the Enabled box. Except for the log watcher, which writes its output to /var/log/ebox/ebox.log, all the other dispatchers require further configuration:

Mail:

You have to set the recipient’s email address (usually the Zentyal administrator). You can also set the subject of the messages.

Jabber:

You have to set the Jabber server address and port that will be used to send the messages. You also have to set the username and password of the user that will send the messages and the Jabber address of the administrator who will recieve the notifications. From this page you can also create a new Jabber account with these parameters in case it does not exist.

RSS:

You can select the policy for authorized readers, as well as the feed link. You can make the feed public, private or authorized by source IP address or object.