librenms-librenms/doc/Alerting/Testing.md

source: Alerting/Testing.md

### Rules

The simplest way of testing if an alert rule will match a device is by going to the device, clicking edit (the cog),
select Capture. From this new screen choose Alerts and click run.

The output will cycle through all alerts applicable to this device and show you the Rule name, rule, 
MySQL query and if the rule matches.

See [Device Troubleshooting](../Support/Device-Troubleshooting.md)

---

### Transports

You can test your transports by forcing an actual active alert to run regardless of the interval or delay values.

`./scripts/test-alert.php`. This script accepts -r for the rule id, -h for the device id or hostname and -d for debug.

---

### Templates

It's possible to test your new template before assigning it to a rule. To do so you can run `./scripts/test-template.php`. The script will provide the help 
info when ran without any parameters.

As an example, if you wanted to test template ID 10 against localhost running rule ID 2 then you would run:

`./scripts/test-template.php -t 10 -d -h localhost -r 2`

If the rule is currently alerting for localhost then you will get the full template as expected to see on email, if it's not then you will just see the 
template without any fault information.