Skip to content

Transports

Transports are located within LibreNMS/Alert/Transport/ and can be configured within the WebUI under Alerts -> Alert Transports.

Contacts will be gathered automatically and passed to the configured transports. By default the Contacts will be only gathered when the alert triggers and will ignore future changes in contacts for the incident. If you want contacts to be re-gathered before each dispatch, please set 'Updates to contact email addresses not honored' to Off in the WebUI.

The contacts will always include the SysContact defined in the Device's SNMP configuration and also every LibreNMS user that has at least read-permissions on the entity that is to be alerted.

At the moment LibreNMS only supports Port or Device permissions.

You can exclude the SysContact by toggling 'Issue alerts to sysContact'.

To include users that have Global-Read, Administrator or Normal-User permissions it is required to toggle the options:

  • Issue alerts to admins.
  • Issue alerts to read only users
  • Issue alerts to normal users.

Using a Proxy

Proxy Configuration

Using a AMQP based Transport

You need to install an additional php module : bcmath

Alerta

The alerta monitoring system is a tool used to consolidate and de-duplicate alerts from multiple sources for quick ‘at-a-glance’ visualisation. With just one system you can monitor alerts from many other monitoring tools on a single screen.

Example:

Config Example
API Endpoint http://alerta.example.com/api/alert
Environment Production
Apy key api key with write permission
Alert state critical
Recover state cleared

Alertmanager

Alertmanager is an alert handling software, initially developed for alert processing sent by Prometheus.

It has built-in functionality for deduplicating, grouping and routing alerts based on configurable criteria.

LibreNMS uses alert grouping by alert rule, which can produce an array of alerts of similar content for an array of hosts, whereas Alertmanager can group them by alert meta, ideally producing one single notice in case an issue occurs.

It is possible to configure as many label values as required in Alertmanager Options section. Every label and its value should be entered as a new line.

Labels can be a fixed string or a dynamic variable from the alert. To set a dynamic variable your label must start with extra_ then complete with the name of your label (only characters, figures and underscore are allowed here). The value must be the name of the variable you want to get (you can see all the variables in Alerts->Notifications by clicking on the Details icon of your alert when it is pending). If the variable's name does not match with an existing value the label's value will be the string you provided just as it was a fixed string.

Multiple Alertmanager URLs (comma separated) are supported. Each URL will be tried and the search will stop at the first success.

Basic HTTP authentication with a username and a password is supported. If you let those value blank, no authentication will be used.

Alertmanager Docs

Example:

Config Example
Alertmanager URL(s) http://alertmanager1.example.com,http://alertmanager2.example.com
Alertmanager Username myUsername
Alertmanager Password myPassword
Alertmanager Options: source=librenms
customlabel=value
extra_dynamic_value=variable_name

API

The API transport allows to reach any service provider using POST, PUT or GET URLs (Like SMS provider, etc). It can be used in multiple ways:

  • The same text built from the Alert template is available in the variable

$msg, which can then be sent as an option to the API. Be carefull that HTTP GET requests are usually limited in length.

  • The API-Option fields can be directly built from the variables defined in Template-Syntax but without the 'alert->' prefix. For instance, $alert->uptime is available as $uptime in the API transport

  • The API-Headers allows you to add the headers that the api endpoint requires.

  • The API-body allow sending data in the format required by the API endpoint.

A few variables commonly used :

Variable Description
{{ $hostname }} Hostname
{{ $sysName }} SysName
{{ $sysDescr }} SysDescr
{{ $os }} OS of device (librenms defined)
{{ $type }} Type of device (librenms defined)
{{ $ip }} IP Address
{{ $hardware }} Hardware
{{ $version }} Version
{{ $uptime }} Uptime in seconds
{{ $uptime_short }} Uptime in human-readable format
{{ $timestamp }} Timestamp of alert
{{ $description }} Description of device
{{ $title }} Title (as built from the Alert Template)
{{ $msg }} Body text (as built from the Alert Template)

Example:

The example below will use the API named sms-api of my.example.com and send the title of the alert to the provided number using the provided service key. Refer to your service documentation to configure it properly.

Config Example
API Method GET
API URL http://my.example.com/sms-api
API Options rcpt=0123456789
key=0987654321abcdef
msg=(LNMS) {{ $title }}
API Username myUsername
API Password myPassword

The example below will use the API named wall-display of my.example.com and send the title and text of the alert to a screen in the Network Operation Center.

Config Example
API Method POST
API URL http://my.example.com/wall-display
API Options title={{ $title }}
msg={{ $msg }}

The example below will use the API named component of my.example.com with id 1, body as json status value and headers send token authentication and content type required.

Config Example
API Method PUT
API URL http://my.example.com/comonent/1
API Headers X-Token=HASH
Content-Type=application/json
API Body { "status": 2 }

aspSMS

aspSMS is a SMS provider that can be configured by using the generic API Transport. You need a token you can find on your personnal space.

aspSMS docs

Example:

Config Example
Transport type Api
API Method POST
API URL https://soap.aspsms.com/aspsmsx.asmx/SimpleTextSMS
Options UserKey=USERKEY
Password=APIPASSWORD
Recipient=RECIPIENT
Originator=ORIGINATOR
MessageText={{ $msg }}

Browser Push

Browser push notifications can send a notification to the user's device even when the browser is not open. This requires HTTPS, the PHP GMP extension, Push API support, and permissions on each device to send alerts.

Simply configure an alert transport and allow notification permission on the device(s) you wish to receive alerts on. You may disable alerts on a browser on the user preferences page.

Canopsis

Canopsis is a hypervision tool. LibreNMS can send alerts to Canopsis which are then converted to canopsis events.

Canopsis Docs

Example:

Config Example
Hostname www.xxx.yyy.zzz
Port Number 5672
User admin
Password my_password
Vhost canopsis

Cisco Spark (aka Webex Teams)

Cisco Spark (now known as Webex Teams). LibreNMS can send alerts to a Cisco Spark room. To make this possible you need to have a RoomID and a token. You can also choose to send alerts using Markdown syntax. Enabling this option provides for more richly formatted alerts, but be sure to adjust your alert template to account for the Markdown syntax.

For more information about Cisco Spark RoomID and token, take a look here :

Example:

Config Example
API Token ASd23r23edewda
RoomID 34243243251
Use Markdown? x

Clickatell

Clickatell provides a REST-API requiring an Authorization-Token and at least one Cellphone number.

Clickatell Docs

Here an example using 3 numbers, any amount of numbers is supported:

Example:

Config Example
Token dsaWd3rewdwea
Mobile Numbers +1234567890,+1234567891,+1234567892

Discord

The Discord transport will POST the alert message to your Discord Incoming WebHook. Simple html tags are stripped from the message.

The only required value is for url, without this no call to Discord will be made. The Options field supports the JSON/Form Params listed in the Discord Docs below.

Discord Docs

Example:

Config Example
Discord URL https://discordapp.com/api/webhooks/4515489001665127664/82-sf4385ysuhfn34u2fhfsdePGLrg8K7cP9wl553Fg6OlZuuxJGaa1d54fe
Options username=myname

Elasticsearch

You can have LibreNMS send alerts to an elasticsearch database. Each fault will be sent as a separate document.

Example:

Config Example
Host 127.0.0.1
Port 9200
Index Pattern \l\i\b\r\e\n\m\s-Y.m.d

GitLab

LibreNMS will create issues for warning and critical level alerts however only title and description are set. Uses Personal access tokens to authenticate with GitLab and will store the token in cleartext.

Example:

Config Example
Host http://gitlab.host.tld
Project ID 1
Personal Access Token AbCdEf12345

Grafana Oncall

Send alerts to Grafana Oncall using a Formatted Webhook

Example:

Config Example
Webhook URL https://a-prod-us-central-0.grafana.net/integrations/v1/formatted_webhook/m12xmIjOcgwH74UF8CN4dk0Dh/

HipChat

See the HipChat API Documentation for rooms/message for details on acceptable values.

You may notice that the link points at the "deprecated" v1 API. This is because the v2 API is still in beta.

Example:

Config Example
API URL https://api.hipchat.com/v1/rooms/message?auth_token=109jawregoaihj
Room ID 7654321
From Name LibreNMS
Options color=red

At present the following options are supported: color.

Note: The default message format for HipChat messages is HTML. It is recommended that you specify the text message format to prevent unexpected results, such as HipChat attempting to interpret angled brackets (< and >).

IRC

The IRC transports only works together with the LibreNMS IRC-Bot. Configuration of the LibreNMS IRC-Bot is described here.

Example:

Config Example
IRC enabled

JIRA

You can have LibreNMS create issues on a Jira instance for critical and warning alerts using either the Jira REST API or webhooks. Custom fields allow you to add any required fields beyond summary and description fields in case mandatory fields are required by your Jira project/issue type configuration. Custom fields are defined in JSON format but ustom fields allow you to add any required fields beyond summary and description fields in case mandatory fields are required by your Jira project/issue type configuration. Custom fields are defined in JSON format. Currently http authentication is used to access Jira and Jira username and password will be stored as cleartext in the LibreNMS database.

REST API

The config fields that need to set for Jira REST API are: Jira Open URL, Jira username, Jira password, Project key, and issue type.

Note: REST API is that it is only able to open new tickets.

Webhooks

The config fields that need to set for webhooks are: Jira Open URL, Jira Close URL, Jira username, Jira password and webhook ID.

Note: Webhooks allow more control over how alerts are handled in Jira. With webhooks, recovery messages can be sent to a different URL than alerts. Additionally, a custom conditional logic can be built using the webhook payload and ID to automatically close an open ticket if predefined conditions are met.

Jira Issue Types Jira Webhooks

Example:

Config Example
Project Key JIRAPROJECTKEY
Issue Type Myissuetype
Open URL https://myjira.mysite.com / https://webhook-open-url
Close URL https://webhook-close-url
Jira Username myjirauser
Jira Password myjirapass
Enable webhook ON/OFF
Webhook ID alert_id
Custom Fileds {"components":[{"id":"00001"}], "source": "LibrenNMS"}

Jira Service Management

Using Jira Service Management LibreNMS integration, LibreNMS forwards alerts to Jira Service Management with detailed information. Jira Service Management acts as a dispatcher for LibreNMS alerts, determines the right people to notify based on on-call schedules and notifies via email, text messages (SMS), phone calls and iOS & Android push notifications. Then escalates alerts until the alert is acknowledged or closed.

:warning: If the feature isn’t available on your site, keep checking Jira Service Management for updates.

Example:

Config Example
WebHook URL https://url/path/to/webhook

LINE Messaging API

LINE Messaging API Docs

Here is the step for setup a LINE bot and using it in LibreNMS.

  1. Use your real LINE account register in developer protal.

  2. Add a new channel, choose Messaging API and continue fill up the forms, note that Channel name cannot edit later.

  3. Go to "Messaging API" tab of your channel, here listing some important value.

    • Bot basic ID and QR code is your LINE bot's ID and QR code.
    • Channel access token (long-lived), will use it in LibreNMS, keep it safe.
  4. Use your real Line account add your LINE bot as a friend.

  5. Recipient ID can be groupID, userID or roomID, it will be used in LibreNMS to send message to a group or a user. Use the following NodeJS program and ngrok for temporally https webhook to listen it.

    LINE-bot-RecipientFetcher

  6. Run the program and using ngrok expose port to public

    $ node index.js
    $ ngrok http 3000
    
  7. Go to "Messaging API" tab of your channel, fill up Webhook URL to https://<your ngrok domain>/webhook

  8. If you want to let LINE bot send message to a yourself, use your real account to send a message to your LINE bot. Program will print out the userID in console.

    sample value:

    {"type":"user","userId":"U527xxxxxxxxxxxxxxxxxxxxxxxxxc0ee"}
    
  9. If you want to let LINE bot send message to a group, do the following steps.

    • Add your LINE bot into group
    • Use your real account to send a message to group

    Program will print out the groupID in console, it will be Recipient ID, keep it safe.

    sample value:

    {"type":"group","groupId":"Ce51xxxxxxxxxxxxxxxxxxxxxxxxxx6ef","userId":"U527xxxxxxxxxxxxxxxxxxxxxxxxxc0ee"} ```
    

Example:

Config Example
Access token fhJ9vH2fsxxxxxxxxxxxxxxxxxxxxlFU=
Recipient (groupID, userID or roomID) Ce51xxxxxxxxxxxxxxxxxxxxxxxxxx6ef

LINE Notify

LINE Notify

LINE Notify API Document

Example:

Config Example
Token AbCdEf12345

Mail

The E-Mail transports uses the same email-configuration as the rest of LibreNMS. As a small reminder, here is its configuration directives including defaults:

Emails will attach all graphs included with the @signedGraphTag directive. If the email format is set to html, they will be embedded. To disable attaching images, set email_attach_graphs to false.

alerting/email

lnms config:set email_html true
lnms config:set email_attach_graphs false

Example:

Config Example
Email [email protected]

Matrix

For using the Matrix transports, you have to create a room on the Matrix-server. The provided Auth_token belongs to an user, which is member of this room. The Message, sent to the matrix-room can be built from the variables defined in Template-Syntax but without the 'alert->' prefix. See API-Transport. The variable $msg is contains the result of the Alert template.The Matrix-Server URL is cutted before the beginning of the _matrix/client/r0/... API-part.

Example:

Config Example
Matrix-Server URL https://matrix.example.com/
Room !ajPbbPalmVbNuQoBDK:example.com
Auth_token: MDAyYmxvY2F0aW9uI...z1DCn6lz_uOhtW3XRICg
Message: Alert: {{ $msg }} https://librenms.example.com

Messagebird

LibreNMS can send text messages through Messagebird Rest API transport.

Config Example
Api Key Api rest key given in the messagebird dashboard
Originator E.164 formatted originator
Recipient E.164 formatted recipient for multi recipents comma separated
Character limit Range 1..480 (max 3 split messages)

Messagebird Voice

LibreNMS can send messages through Messagebird voice Rest API transport (text to speech).

Config Example
Api Key Api rest key given in the messagebird dashboard
Originator E.164 formatted originator
Recipient E.164 formatted recipient for multi recipents comma separated
Language Select box for options
Spoken voice Female or Male
Repeat X times the message is repeated

Microsoft Teams

LibreNMS can send alerts to Microsoft Teams Incoming Webhooks which are then posted to a specific channel. Microsoft recommends using markdown formatting for connector cards. Administrators can opt to compose the MessageCard themselves using JSON to get the full functionality.

Example:

Config Example
WebHook URL https://outlook.office365.com/webhook/123456789
Use JSON? x

Nagios Compatible

The nagios transport will feed a FIFO at the defined location with the same format that nagios would. This allows you to use other alerting systems with LibreNMS, for example Flapjack.

Example:

Config Example
Nagios FIFO /path/to/my.fifo

OpsGenie

Using OpsGenie LibreNMS integration, LibreNMS forwards alerts to OpsGenie with detailed information. OpsGenie acts as a dispatcher for LibreNMS alerts, determines the right people to notify based on on-call schedules and notifies via email, text messages (SMS), phone calls and iOS & Android push notifications. Then escalates alerts until the alert is acknowledged or closed.

Create a LibreNMS Integration from the integrations page once you signup. Then copy the API key from OpsGenie to LibreNMS.

If you want to automatically ack and close alerts, leverage Marid integration. More detail with screenshots is available in OpsGenie LibreNMS Integration page.

Example:

Config Example
WebHook URL https://url/path/to/webhook

osTicket

LibreNMS can send alerts to osTicket API which are then converted to osTicket tickets.

Example:

Config Example
API URL http://osticket.example.com/api/http.php/tickets.json
API Token 123456789

PagerDuty

LibreNMS can make use of PagerDuty, this is done by utilizing an API key and Integraton Key.

API Keys can be found under 'API Access' in the PagerDuty portal.

Integration Keys can be found under 'Integration' for the particular Service you have created in the PagerDuty portal.

Example:

Config Example
API Key randomsample
Integration Key somerandomstring

Philips Hue

Want to spice up your noc life? LibreNMS will flash all lights connected to your philips hue bridge whenever an alert is triggered.

To setup, go to the you http://your-bridge-ip/debug/clip.html

  • Update the "URL:" field to /api
  • Paste this in the "Message Body" {"devicetype":"librenms"}
  • Press the round button on your philips Hue Bridge
  • Click on POST
  • In the Command Response You should see output with your username. Copy this without the quotes

More Info: Philips Hue Documentation

Example:

Config Example
Host http://your-bridge-ip
Hue User username
Duration 1 Second

PlaySMS

PlaySMS is an open source SMS-Gateway that can be used via their HTTP API using a Username and WebService Token. Please consult PlaySMS's documentation regarding number formatting.

PlaySMS Docs

Here an example using 3 numbers, any amount of numbers is supported:

Example:

Config Example
PlaySMS https://localhost/index.php
User user1
Token MYFANCYACCESSTOKEN
From My Name
Mobiles +1234567892,+1234567890,+1234567891

Pushbullet

Get your Access Token from your Pushbullet's settings page and set it in your transport:

Example:

Config Example
Access Token MYFANCYACCESSTOKEN

Pushover

If you want to change the default notification sound for all notifications then you can add the following in Pushover Options:

sound=falling

You also have the possibility to change sound per severity: sound_critical=falling sound_warning=siren sound_ok=magic

Enabling Pushover support is fairly easy, there are only two required parameters.

Firstly you need to create a new Application (called LibreNMS, for example) in your account on the Pushover website (https://pushover.net/apps).

Now copy your API Key and obtain your User Key from the newly created Application and setup the transport.

Pushover Docs

Example:

Config Example
Api Key APPLICATIONAPIKEYGOESHERE
User Key USERKEYGOESHERE
Pushover Options sound_critical=falling
sound_warning=siren
sound_ok=magic

Rocket.chat

The Rocket.chat transport will POST the alert message to your Rocket.chat Incoming WebHook using the attachments option. Simple html tags are stripped from the message. All options are optional, the only required value is for url, without this then no call to Rocket.chat will be made.

Rocket.chat Docs

Example:

Config Example
Webhook URL https://rocket.url/api/v1/chat.postMessage
Rocket.chat Options channel=#Alerting
username=myname
icon_url=http://someurl/image.gif
icon_emoji=:smirk:

Sensu

The Sensu transport will POST an Event to the Agent API upon an alert being generated.

It will be categorised (ok, warning or critical), and if you configure the alert to send recovery notifications, Sensu will also clear the alert automatically. No configuration is required - as long as you are running the Sensu Agent on your poller with the HTTP socket enabled on tcp/3031, LibreNMS will start generating Sensu events as soon as you create the transport.

Acknowledging alerts within LibreNMS is not directly supported, but an annotation (acknowledged) is set, so a mutator or silence, or even the handler could be written to look for it directly in the handler. There is also an annotation (generated-by) set, to allow you to treat LibreNMS events differently from agent events.

The 'shortname' option is a simple way to reduce the length of device names in configs. It replaces the last 3 domain components with single letters (e.g. websrv08.dc4.eu.corp.example.net gets shortened to websrv08.dc4.eu.cen).

Limitations

  • Only a single namespace is supported
  • Sensu will reject rules with special characters - the Transport will attempt to fix up rule names, but it's best to stick to letters, numbers and spaces
  • The transport only deals in absolutes - it ignores the got worse/got better states
  • The agent will buffer alerts, but LibreNMS will not - if your agent is offline, alerts will be dropped
  • There is no backchannel between Sensu and LibreNMS - if you make changes in Sensu to LibreNMS alerts, they'll be lost on the next event (silences will work)

Example:

Config Example
Sensu Endpoint http://localhost:3031
Sensu Namespace eu-west
Check Prefix lnms
Source Key hostname

Slack

The Slack transport will POST the alert message to your Slack Incoming WebHook using the attachments option, you are able to specify multiple webhooks along with the relevant options to go with it. Simple html tags are stripped from the message. All options are optional, the only required value is for url, without this then no call to Slack will be made.

We currently support the following attachment options:

author_name

Slack docs

Example:

Config Example
Webhook URL https://slack.com/url/somehook
Slack Options author_name=Me

SMSEagle

SMSEagle is a hardware SMS Gateway that can be used via their HTTP API using a Username and password.

Destination numbers are one per line, with no spaces. They can be in either local or international dialling format.

SMSEagle Docs

Example:

Config Example
SMSEagle Host ip.add.re.ss
User smseagle_user
Password smseagle_user_password
Mobiles +3534567890
0834567891

SMSmode

SMSmode is a SMS provider that can be configured by using the generic API Transport. You need a token you can find on your personnal space.

SMSmode docs

Example:

Config Example
Transport type Api
API Method POST
API URL http://api.smsmode.com/http/1.6/sendSMS.do
Options accessToken=PUT_HERE_YOUR_TOKEN
numero=PUT_HERE_DESTS_NUMBER_COMMA_SEPARATED
message={{ $msg }}

Splunk

LibreNMS can send alerts to a Splunk instance and provide all device and alert details.

Example output:

Feb 21 15:21:52 nms  hostname="localhost", sysName="localhost", 
sysDescr="", sysContact="", os="fortigate", type="firewall", ip="localhost", 
hardware="FGT_50E", version="v5.6.9", serial="", features="", location="", 
uptime="387", uptime_short=" 6m 27s", uptime_long=" 6 minutes 27 seconds", 
description="", notes="", alert_notes="", device_id="0", rule_id="0", 
id="0", proc="", status="1", status_reason="", ping_timestamp="", ping_loss="0", 
ping_min="25.6", ping_max="26.8", ping_avg="26.3", 
title="localhost recovered from  Device up/down  ", elapsed="14m 54s", uid="0", 
alert_id="0", severity="critical", name="Device up/down", 
timestamp="2020-02-21 15:21:33", state="0", device_device_id="0", 
device_inserted="", device_hostname="localhost", device_sysName="localhost", 
device_ip="localhost", device_overwrite_ip="", device_timeout="", device_retries="", 
device_snmp_disable="0", device_bgpLocalAs="0", 
device_sysObjectID="", device_sysDescr="", 
device_sysContact="", device_version="v5.6.9", device_hardware="FGT_50E", 
device_features="build1673", device_location_id="", device_os="fortigate", 
device_status="1", device_status_reason="", device_ignore="0", device_disabled="0", 
device_uptime="387", device_agent_uptime="0", device_last_polled="2020-02-21 15:21:33", 
device_last_poll_attempted="", device_last_polled_timetaken="7.9", 
device_last_discovered_timetaken="11.77", device_last_discovered="2020-02-21 13:16:42", 
device_last_ping="2020-02-21 15:21:33", device_last_ping_timetaken="26.3", 
device_purpose="", device_type="firewall", device_serial="FGT50EXXX", 
device_icon="images/os/fortinet.svg", device_poller_group="0", 
device_override_sysLocation="0", device_notes="", device_port_association_mode="1", 
device_max_depth="0", device_disable_notify="0", device_location="", 
device_vrf_lites="Array", device_lat="", device_lng="", - 
sysObjectID => ""; `

Each alert will be sent as a separate message.

Example:

Config Example
Host 127.0.0.1
UDP Port 514

Syslog

You can have LibreNMS emit alerts as syslogs complying with RFC 3164.

More information on RFC 3164 can be found here: https://tools.ietf.org/html/rfc3164

Example output: <26> Mar 22 00:59:03 librenms.host.net librenms[233]: [Critical] network.device.net: Port Down - port_id => 98939; ifDescr => xe-1/1/0;

Each fault will be sent as a separate syslog.

Example:

Config Example
Host 127.0.0.1
Port 514
Facility 3

Telegram

Thank you to snis for these instructions.

  1. First you must create a telegram account and add BotFather to you list. To do this click on the following url: https://telegram.me/botfather

  2. Generate a new bot with the command "/newbot" BotFather is then asking for a username and a normal name. After that your bot is created and you get a HTTP token. (for more options for your bot type "/help")

  3. Add your bot to telegram with the following url: http://telegram.me/<botname> to use app or https://web.telegram.org/<botname> to use in web, and send some text to the bot.

  4. The BotFather should have responded with a token, copy your token code and go to the following page in chrome: https://api.telegram.org/bot<tokencode>/getUpdates (this could take a while so continue to refresh until you see something similar to below)

  5. You see a json code with the message you sent to the bot. Copy the Chat id. In this example that is “-9787468” within this example: "message":{"message_id":7,"from":"id":656556,"first_name":"Joo","last_name":"Doo","username":"JohnDoo"},"chat":{"id":-9787468,"title":"Telegram Group"},"date":1435216924,"text":"Hi"}}]}.

  6. Now create a new "Telegram transport" in LibreNMS (Global Settings -> Alerting Settings -> Telegram transport). Click on 'Add Telegram config' and put your chat id and token into the relevant box.

  7. If want to use a group to receive alerts, you need to pick the Chat ID of the group chat, and not of the Bot itself.

Telegram Docs

Example:

Config Example
Chat ID 34243432
Token 3ed32wwf235234
Format HTML or MARKDOWN

Twilio SMS

Twilio will send your alert via SMS. From your Twilio account you will need your account SID, account token and your Twilio SMS phone number that you would like to send the alerts from. Twilio's APIs are located at: https://www.twilio.com/docs/api?filter-product=sms

Example:

Config Example
SID ACxxxxxxxxxxxxxxxxxxxxxxxxxxxx
Token 7xxxx573acxxxbc2xxx308d6xxx652d32
Twilio SMS Number 8888778660

UKFast PSS

UKFast PSS tickets can be raised from alerts using the UKFastPSS transport. This required an API key with PSS write permissions

Example:

Config Example
API Key ABCDefgfg12
Author 5423
Priority Critical
Secure true

VictorOps

VictorOps provide a webHook url to make integration extremely simple. To get the URL required login to your VictorOps account and go to:

Settings -> Integrations -> REST Endpoint -> Enable Integration.

The URL provided will have $routing_key at the end, you need to change this to something that is unique to the system sending the alerts such as librenms. I.e:

https://alert.victorops.com/integrations/generic/20132414/alert/2f974ce1-08fc-4dg8-a4f4-9aee6cf35c98/librenms

Example:

Config Example
Post URL https://alert.victorops.com/integrations/generic/20132414/alert/2f974ce1-08fc-4dg8-a4f4-9aee6cf35c98/librenms

Kayako Classic

LibreNMS can send alerts to Kayako Classic API which are then converted to tickets. To use this module, you need REST API feature enabled in Kayako Classic and configured email account at LibreNMS. To enable this, do this:

AdminCP -> REST API -> Settings -> Enable API (Yes)

Also you need to know the department id to provide tickets to appropriate department and a user email to provide, which is used as ticket author. To get department id: navigate to appropriate department name at the departments list page in Admin CP and watch the number at the end of url. Example: http://servicedesk.example.com/admin/Base/Department/Edit/17. Department ID is 17

As a requirement, you have to know API Url, API Key and API Secret to connect to servicedesk

Kayako REST API Docs

Example:

Config Example
Kayako URL http://servicedesk.example.com/api/
Kayako API Key 8cc02f38-7465-4a0c-8730-bb3af122167b
Kayako API Secret Y2NhZDIxNDMtNjVkMi0wYzE0LWExYTUtZGUwMjJiZDI0ZWEzMmRhOGNiYWMtNTU2YS0yODk0LTA1MTEtN2VhN2YzYzgzZjk5
Kayako Department 1

Signal CLI

Use the Signal Mesenger for Alerts. Run the Signal CLI with the D-Bus option.

GitHub Project

Example:

Config Example
Path /opt/signal-cli/bin/signal-cli
Recipient type Group
Recipient dfgjsdkgljior4345==

SMSFeedback

SMSFeedback is a SAAS service, which can be used to deliver Alerts via API, using API url, Username & Password.

They can be in international dialling format only.

SMSFeedback Api Docs

Example:

Config Example
User smsfeedback_user
Password smsfeedback_password
Mobiles 71234567890
Sender name CIA

Zenduty

Leveraging LibreNMS<>Zenduty Integration, users can send new LibreNMS alerts to the right team and notify them based on on-call schedules via email, SMS, Phone Calls, Slack, Microsoft Teams and mobile push notifications. Zenduty provides engineers with detailed context around the LibreNMS alert along with playbooks and a complete incident command framework to triage, remediate and resolve incidents with speed.

Create a LibreNMS Integration from inside Zenduty, then copy the Webhook URL from Zenduty to LibreNMS.

For a detailed guide with screenshots, refer to the LibreNMS documentation at Zenduty.

Example:

Config Example
WebHook URL https://www.zenduty.com/api/integration/librenms/integration-key/