Integrations are connections to the outside world that take care of sending out alert messages triggered by Uptrends alerts. Every time an alert is generated in Uptrends - according to the alert definitions you specify - the integrations you've activated in those alert definitions will be used to send out the appropriate messages. The simplest integration is the Email integration: it will create an email message and send it to the recipients you specify. Another simple example is the SMS integration: it will send SMS/text messages to your operators' mobile phones.

Connecting to external systems

Aside from sending alert messages to individual people, it's likely that you want to send alert information from Uptrends to other systems for automated processing. This is useful for connecting directly to your incident tracking and handling system (for example PagerDuty, VictorOps or ServiceNow) or simply sharing alert information in your team's communication tool (for example in Slack) or with the general public (e.g. StatusHub).

Some of the available integrations use a fixed text message format (Email, SMS, Phone, Slack) while others adhere to the message format expected by the third party system, so that system can display and process the data coming from Uptrends exactly how it wants to (PagerDuty, StatusHub, VictorOps, ServiceNow). We have integration guides available for all of the supported third party systems. To find the right integration guide, please look at our Integrations main page.

Building a custom webhook integration

Even though Uptrends has a growing list of predefined integrations, chances are that you're looking to connect to a system that's not listed yet. This is still possible: you can use the custom integration function to set up an integration with any system that supports webhooks, i.e. if it has an API that can process incoming messages.

If you're connecting to a third party system, they will expect the incoming webhook (i.e. the data sent from Uptrends to that system) to use a particular message format so they can process it. The documentation of that system will explain what the content of the message must be, including the meaning of each field, and the URL it should be sent to. The integration editor in Uptrends lets you configure all of that data.

Alternatively, perhaps you want to connect to a system that doesn't have a required or preferred message format. In that case, it's useful to use the custom integration titled Uptrends integration. It has a preconfigured message that contains all alerting variables available in Uptrends. All you need to do is provide the URL of the API you want to connect to.

For more information, please read this article on how to build a custom integration, which is also useful for changing one of the customizable integrations.