Creating a new Transport

File location

All transports are located in LibreNMS\Alert\Transport and the files are named after the Transport name. I.e Discord.php for Discord.

Transport structure

The following functions are required for a new transport to pass the unit tests:

deliverAlert() - This is function called within alerts to invoke the transport. Here you should do any post processing of the transport config to get it ready for use.

contact$Transport() - This is named after the transport so for Discord it would be contactDiscord(). This is what actually interacts with the 3rd party API, invokes the mail command or whatever you want your alert to do.

configTemplate() - This is used to define the form that will accept the transport config in the webui and then what data should be validated and how. Validation is done using Laravel validation

Documentation

Please don't forget to create a documentation file doc/Alerting/Transports/$Transport.md file to include details of your new transport.

A table should be provided to indicate the form values that we ask for and examples. I.e:

Please also ensure that you link back to any 3rd party documentation that will help users understand how the transport can be used.