content/chronograf/v1/guides/configuring-alert-endpoints.md
Chronograf alert endpoints can be configured using the Chronograf user interface to create Kapacitor-based event handlers that send alert messages. You can use Chronograf to send alert messages to specific URLs as well as to applications.
This guide offers step-by-step instructions for configuring Chronograf alert endpoints.
Chronograf integrates with Kapacitor, InfluxData's data processing platform, to send alert messages to event handlers. Chronograf supports the following event handlers:
To configure a Kapacitor event handler in Chronograf, install Kapacitor and connect it to Chronograf. The Configure Kapacitor page includes the event handler configuration options.
Alert endpoint configurations appear on the Chronograf Configure Kapacitor page. You must have a connected Kapacitor instance to access the configurations. For more information, see Kapacitor installation instructions and how to connect a Kapacitor instance to Chronograf.
Note that the configuration options in the Configure alert endpoints section are not all-inclusive. Some event handlers allow users to customize event handler configurations per alert rule. For example, Chronograf's Slack integration allows users to specify a default channel in the Configure alert endpoints section and a different channel for individual alert rules.
To configure an Alerta alert endpoint:
In the Configure Alert Endpoints of the Configure Kapacitor Connection page, click the Alerta tab.
Enter the following:
Click Save Changes to save the configuration settings.
Click Send Test Alert to verify the configuration.
To configure an BigPanda alert endpoint:
In the Configure Alert Endpoints of the Configure Kapacitor Connection page, click the BigPanda tab.
Enter the following:
https://api.bigpanda.io/data/v2/alerts.Click Save Changes to save the configuration settings.
Click Send Test Alert to verify the configuration.
To configure a Kafka alert endpoint:
In the Configure Alert Endpoints of the Configure Kapacitor Connection page, click the Kafka tab.
Enter the following:
localhost.host:port format.10s.100.1s.Click Save Changes to save the configuration settings.
Click Send Test Alert to verify the configuration.
To enable Kafka services using TICKscript, see Kafka event handler (Kapacitor).
{{% warn %}} Note: Support for OpsGenie Events API 1.0 is deprecated (as noted by OpGenie). As of June 30, 2018, the OpsGenine Events API 1.0 is disabled. Use the OpsGenie2 alert endpoint. {{% /warn %}}
Send an incident alert to OpsGenie teams and recipients using the Chronograf alert endpoint.
To configure a OpsGenie alert endpoint:
In the Configure Alert Endpoints of the Configure Kapacitor Connection page, click the OpsGenie tab.
Enter the following information:
Click Save Changes to save the configuration settings.
Click Send Test Alert to verify the configuration.
See Alert API in the OpsGenie documentation for details on the OpsGenie Alert API
See OpsGenie V2 event handler in the Kapacitor documentation for details about the OpsGenie V2 event handler.
See the AlertNode (Kapacitor TICKscript node) - OpsGenie v2 in the Kapacitor documentation for details about enabling OpsGenie services using TICKscripts.
{{% warn %}} The original PagerDuty alert endpoint is deprecated. Use the PagerDuty2 alert endpoint. {{% /warn %}}
To configure a PagerDuty alert endpoint:
In the Configure Alert Endpoints of the Configure Kapacitor Connection page, click the PagerDuty tab.
Enter the following:
routing_key).https://events.pagerduty.com/v2/enqueue.Click Save Changes to save the configuration settings.
Click Send Test Alert to verify the configuration.
See the PagerDuty Events API V2 Overview
for details on the PagerDuty Events API and recognized event types (trigger, acknowledge, and resolve).
To enable a new "Generic API" service using TICKscript, see AlertNode (Kapacitor TICKscript node) - PagerDuty v2.
To configure a Pushover alert endpoint:
In the Configure Alert Endpoints of the Configure Kapacitor Connection page, click the Pushover tab.
Enter the following:
https://api.pushover.net/1/messages.json.Click Save Changes to save the configuration settings.
Click Send Test Alert to verify the configuration.
To configure a Sensu alert endpoint:
In the Configure Alert Endpoints of the Configure Kapacitor Connection page, click the Sensu tab.
Enter the following:
Kapacitor.Click Save Changes to save the configuration settings.
Click Send Test Alert to verify the configuration.
To configure a ServiceNow alert endpoint:
In the Configure Alert Endpoints of the Configure Kapacitor Connection page, click the ServiceNow tab.
Enter the following:
https://instance.service-now.com/api/global/em/jsonv2.Click Save Changes to save the configuration settings.
Click Send Test Alert to verify the configuration.
To configure a Slack alert endpoint:
In the Configure Alert Endpoints of the Configure Kapacitor Connection page, click the Slack tab.
Enter the following:
# to send to a channel.
Prefix with @ to send directly to a user.
If not specified, Kapacitor sends alert messages to the channel or user
specified in the alert rule
or configured in the Slack Webhook.Click Save Changes to save the configuration settings.
Click Send Test Alert to verify the configuration.
To add another Slack configuration:
To configure a SMTP alert endpoint:
In the Configure Alert Endpoints of the Configure Kapacitor Connection page, click the SMTP tab.
Enter the following:
localhost.25.Click Save Changes to save the configuration settings.
Click Send Test Alert to verify the configuration.
To configure a Talk alert endpoint:
In the Configure Alert Endpoints of the Configure Kapacitor Connection page, click the Talk tab.
Enter the following:
Click Save Changes to save the configuration settings.
Click Send Test Alert to verify the configuration.
To configure a Microsoft Teams alert endpoint:
In the Configure Alert Endpoints of the Configure Kapacitor Connection page, click the Teams tab.
Enter the following:
Click Save Changes to save the configuration settings.
Click Send Test Alert to verify the configuration.
To configure a Telegram alert endpoint:
In the Configure Alert Endpoints of the Configure Kapacitor Connection page, click the Telegram tab.
Enter the following:
To configure a VictorOps alert endpoint:
In the Configure Alert Endpoints of the Configure Kapacitor Connection page, click the VictorOps tab.
Enter the following:
https://alert.victorops.com/integrations/generic/20131114/alert.Click Save Changes to save the configuration settings.
Click Send Test Alert to verify the configuration.
To configure a Zenoss alert endpoint:
In the Configure Alert Endpoints of the Configure Kapacitor Connection page, click the Zenoss tab.
Enter the following:
https://tenant.zenoss.io:8080/zport/dmd/evconsole_router.EventsRouter.add_event.rpc.1.Kapacitor.Click Save Changes to save the configuration settings.
Click Send Test Alert to verify the configuration.