Alerts management
Table of contents
- 1 Description
- 2 Settings
- 2.1 Mail mode (TEXT/HTML)
- 2.2 Mail recipients list
- 2.3 Mail sender
- 2.4 Create/update alert mail footer
- 2.5 Enable/disable wall alert messages
- 2.6 Update/reinstall common alert script
- 2.7 Select guests log alert level
- 2.8 View alerts history
- 2.9 Immediate alert on dongle removal
- 2.10 Alerts simulator
- 2.11 Reduce WARN msgs on dongle removal
Description
Use this option to change alert management settings as shown below:
Settings
Mail mode (TEXT/HTML)
Alerts are by default sent in HTML format. With some mail clients, HTML mails are not correctly displayed or even rejected. This option is used to switch between HTML format and pure TEXT format.
Mail recipients list
All alerts coming from monitoring scripts and checks scripts are sent using a common alert script that sends emails (via "sendmail") to the recipients list that can be defined using this option.
The common alert script can be customized too if you prefer not to receive emails and use commands from your monitoring software for example.
Do not add blank lines and set one recipient per line
Mail sender
This optional option allows you to define the sender name instead of the default one (root@hostname)
Create/update alert mail footer
Used to add comments at the end of the mail.
HTML tags like new line, font and bold can be added within the file. In case the format is switched to TEXT, these tags will be automatically removed from the text mail.
Enable/disable wall alert messages
This option enables or disables (default) the "wall" messages sent via the alert script.
Update/reinstall common alert script
All alerts coming from monitoring scripts and checks scripts are sent using a common alert script.
If this script does not exist, it is initialized by copying an example provided in the kit.
If it exists and is different from the original one, you are invited to reinitialize it from the default one:
Answer "
yes" if you did not change the original script file and you have updated the Linux Toolkit (read the corresponding release notes)Do not answer "
yes" if you customized your own alert script.
In case you've overwritten the existing alert script, the previous version can be restored from the "/charon/archive" folder
This script can be customized to send alerts the way you want, adding for example commands to link with your monitoring tool. It is based on an alert code passed as parameter 1.
All other parameters are information related to the alert. The script uses templates in order to send emails and wall messages (see "/opt/charon/utils/templates/*.mail" and "/opt/charon/utils/templates/*.wall" files if needed).
The table below lists all available values for parameter 1 in case you plan to customize the scripts and send alerts by your own (monitoring software lines of commands, snmptrap, etc...)
Parameter 1 can have the following values:
Parameter 1 | Severity | Description |
|---|---|---|
ABORTED | CRITICAL | Guest has stopped without user or service request |
AKSUSBFAIL | CRITICAL | If the dongle is detected as removed whereas it is disconnected, the askusb daemons are restarted. If the restart fails after 15 tries, this message is sent |
COMMLOST | CRITICAL | Communication lost with the license |
COMMREST | INFORMATIONAL | Communication restored with the license |
EMULSTART | INFORMATIONAL | Emulator has been started |
EXPCHK | CRITICAL, MAJOR, MINOR, INFORMATION | The license is about to expire |
FOUND | INFORMATIONAL | License dongle found at startup |
IFCFGADDR | CRITICAL | The network interface defined in the configuration has already an assigned IP address, cannot be used for guest |
IFCFGCRIT | CRITICAL | One parameter in the ifcfg-ethN file is not configured correctly (mandatory value) |
IFCFGUNKN | CRITICAL | The interface name defined in the configuration file is not valid (not found with 'ifconfig <eth>' command) |
IFCFGWARN | WARNING | One parameter in the ifcfg-ethN file is not configured correctly (recommended value) |
REMOVED | CRITICAL | Dongle has been removed: the guest sees the dongle as disconnected and will stop after the defined interval if the dongle is not replaced |
REMOVRESET | ERROR | Dongle seen as removed whereas not disconnected (aksusb driver failure). In this case the USB is reset and drivers are restarted ( Not valid if the dongle is a network dongle and then located on another server) |
STOPPED | CRITICAL | Guest has been stopped, reasons explained in parameters 4, 5 and 6 |
STOPPEDREQ | INFORMATIONAL | Guest has been stopped, requested by user or shutdown |
TESTMAIL | INFORMATIONAL | Used to test email mode when setting HTML or pure TEXT |
USBCONNECT | CRITICAL | Dongle has been connected (immediate detection) |
USBDISCONNECT | MAJOR | Dongle has been removed (immediate detection) |
Select guests log alert level
Select the alert level to send alerts when events are found in the guest log file:
Level | Information | Warning | Error |
|---|---|---|---|
0 | |||
1 | |||
2 | |||
3 |