Learn about the Wavefront Slack Integration.

Slack Integration

Slack is a popular communication platform. Wavefront integrates with Slack in two different ways:

  • Wavefront/Slack webhooks let you send alert notifications to Slack.
  • The Wavefront URL unfurler for Slack is for users who paste Wavefront links into Slack messages.

Slack Webhook Integration for Alert Notifications

Wavefront and Slack both support webhooks so you can easily configure an incoming webhook in Slack and an outgoing webhook in Wavefront to pass the notifications from Wavefront alerts into your Slack channels. An alert notification sent to a Slack channel looks like:

images/slack_alert.png

Slack URL Unfurler

After a privileged user has added the Wavefront application to Slack, all Slack users will be prompted the next time they post a Wavefront URL. They can decide to unfurl the URL to show an image, unfurl all Wavefront URLs, or not unfurl Wavefront URLs. Here’s a Slack message with an unfurled chart image:

images/unfurled_chart.png

Slack Webhook Integration Setup

Wavefront and Slack both support webhooks so you can easily configure an incoming webhook in Slack and an outgoing webhook in Wavefront to pass the notifications from Wavefront alerts into your Slack channels.

Step 1. Build a Custom Integration for Your Slack Channel

  1. In Slack, click the team dropdown menu in the top left hand of the Slack application and select the Customize Slack link: images/customize_slack.png

    The Customize Your Team page opens in your browser.

  2. Click the Configure Apps link under the menu list: images/configure_apps.png

  3. On the App Directory page, click the Custom Integrations and then Incoming WebHooks links: images/incoming_webhooks.png

  4. Click the Add Configuration button.
  5. In the Post to Channel dropdown list, select the Slack channel where your incoming webhook will post messages to and click the Add Incoming WebHooks integration button: images/webhook_testing.png

  6. Customize the incoming webhook. images/customize_incoming_webhook.png

    In the Custom Name field, type the name that will appear in your Slack channel as a sender of the message. You can also add additional details such as description, icon, etc. Refer to Incoming Webhooks for detailed instructions.

  7. Click the Copy URL link.
  8. Click Save Settings.

Step 2. Create a Slack Alert Target

  1. In Wavefront, create an alert target.
  2. Give the alert target a meaningful name.
  3. In the Triggers field, select the alert state changes that should trigger the notification. See Creating an Alert Target.
  4. Make sure the Type is Webhook.
  5. Paste the application’s notification URL into the URL field.

  6. In the content type field, select application/json.
  7. Select Alert Target POST Body Template > TEMPLATE > Slack.
  8. Customize the template.
  9. Click Save. The alert target is added to the Alert Targets page.
  10. In the Name column, note the ID of the alert target under the alert target description.

Step 3. Add the Slack Alert Target to an Alert

  1. In Wavefront, open the Alerts browser.
  2. If you have an alert, locate the alert and click the alert name to open the Edit Alert screen. Otherwise, create an alert. For help, see Creating an Alert.
  3. Scroll down to the Target List field.

  4. Enter the alert target ID into the Alert Target field.
  5. Select the alert target from the dropdown list to add the list of targets.
  6. Click Save.

Setup of your Slack Webhook is now complete. Going forward, specified users receive alert notifications in Slack.

Slack URL Unfurler Setup (Chart Images in Slack)

The Slack URL Unfurler has completely different functionality from the Webhook setup. It supports including chart images in Slack. When a user copies a link to a Wavefront chart into Slack, other users can see the chart image in Slack without having to click a link. Currently only *.wavefront.com domain can be unfurled.

To implement URL Unfurl functionality for links to Wavefront pages, follow these steps:

  1. A Slack admin user with the right privileges installs the Wavefront application into Slack. This user must have the permission to add apps to the Slack workspace. Who that person is depends on the Slack setup at your site.
  2. After that, any user who pastes a link to a Wavefront instance – usually a link to a chart – into Slack is prompted as follows:
    • Unfurl links to Wavefront instances
    • Don’t unfurl links to this Wavefront instance
    • Don’t unfurl links.

The following image illustrates this:

images/slack_user_message.png