docs-v2/content/influxdb/cloud/monitor-alert/notification-endpoints/create.md

3.1 KiB

title description menu weight related
Create notification endpoints Create notification endpoints to send alerts on your time series data.
influxdb_cloud
name parent
Create endpoints Manage notification endpoints
201
/influxdb/cloud/monitor-alert/checks/
/influxdb/cloud/monitor-alert/notification-rules/

To send notifications about changes in your data, start by creating a notification endpoint to a third party service. After creating notification endpoints, create notification rules to send alerts to third party services on check statuses.

Create a notification endpoint in the UI

  1. In the navigation menu on the left, select Alerts.

    {{< nav-icon "alerts" >}}

  2. Select Notification Endpoints near to top of the page.

  3. Click {{< icon "plus" >}} Create.

  4. From the Destination drop-down list, select a destination endpoint to send notifications. The following endpoints are available for the InfluxDB Cloud Free Plan and Usage-based Plan:

    Endpoint Free Plan Usage-based Plan
    Slack {{< icon "check" >}} {{< icon "check" >}}
    PagerDuty {{< icon "check" >}}
    HTTP {{< icon "check" >}}
  5. In the Name and Description fields, enter a name and description for the endpoint.

  6. Enter enter information to connect to the endpoint:

    • For HTTP, enter the URL to send the notification. Select the auth method to use: None for no authentication. To authenticate with a username and password, select Basic and then enter credentials in the Username and Password fields. To authenticate with a token, select Bearer, and then enter the API token in the Token field.

    • For Slack, create an Incoming WebHook in Slack, and then enter your webHook URL in the Slack Incoming WebHook URL field.

    • For PagerDuty:

      • Create a new service, add an Events API V2 integration for your service, and then enter the PagerDuty integration key for your new service in the Routing Key field.

      • The Client URL provides a useful link in your PagerDuty notification. Enter any URL that you'd like to use to investigate issues. This URL is sent as the client_url property in the PagerDuty trigger event. By default, the Client URL is set to your Monitoring & Alerting History page, and the following included in the PagerDuty trigger event:

        "client_url": "https://cloud2.influxdata.com/orgs/<your-org-ID>/alert-history"
        
  7. Click Create Notification Endpoint.