Integrations

This section describes the integrations available for alerting.

Alerts are sent to channels.

See provisioning for integration into your CI/CD pipelines.

AWS Cloud Watch

To send alerts to AWS Cloud Watch, you first need an AWS connection.

Go to Environments->[Your Environment]->Configuration

Select AWS Connection and enter the required fields in the editor.

Rather than enter your AWS credentials you can use the AWS credentials chain.

Next, go to Environments->[Your Environment]->Alerts->Channels and create a new channel for AWS connection.

Datadog

To send alerts to Datadog, you first need a Datadog connection.

Go to Environments->[Your Environment]->Configuration and select DataDog and enter your required details in the editor.
Go to Environments->[Your Environment]->Alerts->Channels and create a new channel with your connection.

To send alerts to Pager Duty, you first need a Pager Duty connection.

Go to Environments->[Your Environment]->Configuration and select PagerDuty and enter your required details in the editor.
Go to Environments->[Your Environment]->Alerts->Channels and create a new channel with your connection.

Prometheus Alert Manager

To send alerts to Alert Manager, you first need a Alert Manager connection.

Go to Environments->[Your Environment]->Configuration and select Alert Manager and enter your required details in the editor.
Go to Environments->[Your Environment]->Alerts->Channels and create a new channel with your connection.

Slack

To send alerts to Slack, you first need a Slack connection.

Go to Environments->[Your Environment]->Configuration and select Slack and enter your required details in the editor.
Go to Environments->[Your Environment]->Alerts->Channels and create a new channel with your connection.

Webhook

Webhooks allow you to send alerts to any service implementing them, they are very flexible.

To send alerts to Webhooks, you first need a Webhook connection.

Go to Environments->[Your Environment]->Configuration and select Webhook and enter your required details in the editor.
Go to Environments->[Your Environment]->Alerts->Channels and create a new channel with your connection.

Template variables

In Request path, HTTP Headers and Body payload there is a possibility of using template variables, which will be translated to alert specific fields. To use template variables, you have to use this format: {{VARIABLE}}, i.e. {{LEVEL}}.

Supported template variables:

LEVEL - alert level (INFO, LOW, MEDIUM, HIGH, CRITICAL).
CATEGORY - alert category (Infrastructure, Consumers, Kafka Connect, Topics, Producers).
INSTANCE - (broker url / topic name etc.).
SUMMARY - alert summary - same content in the Alert Events tab.
TIMESTAMP
ID - alert global id (i.e. 1000 for BrokerStatus alert).
CREDS - CREDS[0] etc. - variables specified in connections Credentials as a list of values separated by a comma.

Webhook Email

To configure real-time email alerts you can leverage Webhooks, for example with the following service:

Twilio and SendGrid
Zapier

SendGrid Example

Create a webhook connection, for SendGrid with api.sendgrid.com as the host and enable HTTPS
Configure a channel to use the connect you just created
Set the method to Post
Set the request path to the webhook URL from your Zapier account
Set the Headers to

HTTP Headers

Authorization: Bearer [your-Sendgrid-API-Key]

Content-Type: application/json

Set the payload to be

{
  "personalizations":[{
    "to":[{
      "email":"[email protected]",
      "name":"DevOps & SRE team | MyCompany"
    }],
    "subject":"PRODUCTION | Streaming Data Platform Alert"
  }],
  "content":[{
    "type":"text/html",
    "value":"<html><body><p>Priority Level:{{LEVEL}}</br></br>Category: {{CATEGORY}}</br><br>Description: {{SUMMARY}}</br><small>Alert ID: {{ID}}</small></p></body></html>"
  }],
  "from":{
    "email":"sender-email-address",
    "name":"sender name ie. PRODUCTION | Streaming Data"
  },
  "reply_to":{
    "email":"reply-to-email-address",
    "name":"reply to name"
  }
}

Change the above payload according to your requirements, and remember that the [sender-email-address] needs to be the same email address you registered during the Sender Authentication Sendgrid setup process.

Zapier Example

Create a webhook connection, for SendGrid with hooks.zapier.com as the host and enable HTTPS
Configure a channel to use the connect you just created
Set the method to Post
Set the request path tp /v3/mail/send
Set the request path to the webhook URL from your Zapier account
Set the Headers to:

X-Api-Token: {{CREDS[0]}

Set the payload to be

<html>
  <body>
    <h2>Streaming data platform - alert</h2>
    <p>Environment: <a href="http://enjoy.lenses.io"><b>PRODUCTION</b></a></p>
    <p>Priority Level: <b>{{LEVEL}}</b></p>
    <p>Category: <b>{{CATEGORY}}</b></p>
    <p>Summary: {{SUMMARY}}</p>
    <p>Alert ID: {{ID}}</p>
    <p><small>Lenses.io</small></p>
  </body>
</html>

Webhook MS Teams

To create a webhook in your MS Teams workspace you can use this guide.

At the end of the process you get a url of the format: https://YOUR_URL.webhook.office.com/webhook2/<secret-token-by-ms>/IncomingWebhook/<secret-token-by-ms>

You’ll need the second part

/webhook2/<secret-token-by-ms>/IncomingWebhook/<secret-token-by-ms>

Create a new Webhook Connection, set the host to outlook.office.com and enable HTTPS
Configure an new channel, using this connection
Set the Method to POST
The Request Path to the second part of the URL you recieved from MS Teams

/webhook2/<secret-token-by-ms>/IncomingWebhook/<secret-token-by-ms>

In the body set

{"text": "{{CATEGORY}} {{LEVEL}} {{ID}}"}

Webhook SMS

See Zapier and follow blog post SMS alerts with Zapier.

PreviousAlert Reference NextConsumer Groups

Last updated 6 days ago

Was this helpful?

Good night

hashtagAWS Cloud Watch

hashtagDatadog

hashtagPager Duty

hashtagPrometheus Alert Manager

hashtagSlack

hashtagWebhook

hashtagTemplate variables

hashtagWebhook Email

hashtagSendGrid Example

hashtagZapier Example

hashtagWebhook MS Teams

hashtagWebhook SMS

AWS Cloud Watch

Datadog

Pager Duty

Prometheus Alert Manager

Slack

Webhook

Template variables

Webhook Email

SendGrid Example

Zapier Example

Webhook MS Teams

Webhook SMS