Ctrlk
HomeProductsDownload Community Edition
For the complete documentation index, see llms.txt. This page is also available as Markdown.

Alert Integration

Understand which alerting systems Lenses can send alerts to.

Alert connections

Alert connections define where an agent can send alerts. Configure connections in the provisioning file.

Lenses supports AWS CloudWatch, Datadog, PagerDuty, Prometheus Alertmanager, Slack, and webhooks.

To configure a connection:

  1. Select Environments & Topics.

  2. Expand the environment, then select Configuration.

  3. Edit, test, and apply the provisioning file to the connected agent.

Alert channels

After configuring a connection, create alert channels to route events to it. You can create multiple channels for each connection. For example, route different alerts to separate Slack channels.

Select Environments & Topics, expand the environment, then select Alerts.

Select the Channels tab to view, edit, or create channels.

Alerts are always stored in Lenses even if you don't send them out to an external alerting system.

AWS CloudWatch

Create an AWS connection in Configuration. Then create an AWS CloudWatch channel.

You can use the AWS default credentials provider chain instead of explicit credentials.

Datadog

  1. In Configuration, create a Datadog connection.

  2. In Alerts → Channels, create a channel using that connection.

PagerDuty

  1. In Configuration, create a PagerDuty connection.

  2. In Alerts → Channels, create a channel using that connection.

Prometheus Alertmanager

  1. In Configuration, create an Alertmanager connection.

  2. In Alerts → Channels, create a channel using that connection.

Slack

  1. In Configuration, create a Slack connection.

  2. In Alerts → Channels, create a channel using that connection.

Webhooks

Webhooks can send alerts to services that accept HTTP requests. Use them for email, Microsoft Teams, SMS, and custom integrations.

  1. In Configuration, create a Webhook connection.

  2. In Alerts → Channels, create a channel using that connection.

Template variables

Use template variables in the request path, HTTP headers, and body. Write variables as {{VARIABLE}}.

  • {{LEVEL}} — alert level, such as HIGH or CRITICAL.

  • {{CATEGORY}} — alert category.

  • {{INSTANCE}}, {{SUMMARY}}, {{TIMESTAMP}}, and {{ID}} — alert details.

Use {{CREDS[0]}} for a value from the connection credentials list.

SendGrid email example

Configure a webhook connection with host api.sendgrid.com and enable HTTPS. Create a channel using this connection.

Set the method to POST. Add these headers:

Use this body:

The sender address must match a verified SendGrid sender.

Zapier example

Configure a webhook connection with host hooks.zapier.com and enable HTTPS. Set the request path to the webhook path from Zapier.

Set the method to POST. You can pass a credential with this header:

Use this body:

Microsoft Teams example

Create an incoming webhook in Microsoft Teams. Its URL includes a host and a path.

  1. Create a webhook connection with host outlook.office.com and enable HTTPS.

  2. Create a channel using that connection.

  3. Set the method to POST.

  4. Set the request path to the path from the Teams webhook URL.

  5. Set the body:

SMS

Use a webhook service that can send SMS messages. Zapier can route the webhook payload to an SMS provider.

PreviousAlerting & MonitoringNextAlert Rules

Last updated

Was this helpful?