How-tos

Notification integration with Slack for Bluemix Local and Bluemix Dedicated

Share this post:

slack_mark_webAs a Bluemix Dedicated or Bluemix Local administrator, you can manage and extend the functionality of your notifications for maintenance and incident events that are received in the Administration Console. You have the ability to set up a custom notification per event type (maintenance or incident) that uses email or webhooks which integrate with a tool of your choice to deliver the notification.

(For more information about creating these notification subscriptions, see the documentation about Setting up event subscriptions.)

The purpose of this how-to post is to enable you to use the webhooks integration with Slack. This means you can enable your Administration Console notifications to post directly to a Slack channel of your choice. As an administrator, use the Subscriptions option in the Administration Console to set up and customize these notifications.

Step-by-step instructions

  • Click Administration to access the Administration Console.
  • Select the System Information tile.
  • Select the Number pending option in the Updates section.
  • Select Subscriptions.
  • Select Add Subscription.
  • Fill in your webhook event subscription form.
    event_subscription_page1_edited1
  • Select Enabled to turn on the notification.
  • In the Type field, select Webhook.
  • In the Event field, select Maintenance.
  • In the Method field, select POST.
  • In the URL field, enter the URL for the Slack channel where you want to post the notification.

To get the Slack URL, you must have the incoming webhooks Slack integration set up in your channel:

  • Go to the Apps & Integration option in Slack.
  • Search for Incoming webhooks.
  • Click Add Configuration.
  • Choose the channel where you want to post.
  • Click Add Incoming Webhooks Integration.

Then, you will have the URL to use in the Bluemix form.

  • In the User name field, enter your Slack user name. If your Slack team does not require credentials, you can leave this blank.
  • In the Password field, enter your Slack password. If your Slack team does not require credentials, you can leave this blank.
  • In the Description field, enter a short description for this notification for your own records in the Administration Console. For example, you could use “Slack maintenance alert.”
  • Fill in the Payload section. Click Add Property to add more properties and values to populate the notification.

The following example payload properties and values that could be used to populate your notification:

Payload property “text”

Example value:

The following notification is for a scheduled maintenance event for your Bluemix environment.\nTitle: {{content.title}}\nDescription: {{content.message}}\nIncident status: {{status}}\nScheduled time: {{content.scheduleWindow.start}}\nTo view the original notification for the scheduled maintenance, visit the following link: https://console.yoursubdomain.bluemix.net/system/updates/{{_id}}|Maintenance event: {{content.title}}.

Comments:

  • Use the text property to display the details for the notification. Enter text on multiple lines by using \n between text lines as shown in the example.
  • Then, to pull in information specific to the Bluemix event, you can refer to the documentation table on payload values that are specific to maintenance events. See Payload section values for options and syntax.
  • Another valuable entry in the text field is the URL back to the maintenance event for others to view the original record. In this example, you can see that you use the URL to your Bluemix Administration Console environment with the variable {{_id}} appended, which will pull in the Bluemix event ID: https://console.yoursubdomain.bluemix.net/system/updates/{{_id}}.

Payload property “icon_emoji”

Example value:

:hammer_and_wrench:

Comments:

You can use the Slack emoji syntax to pull in an emoji of your choice for your post.

Wrapping up

Select Save and Test when your event subscription form is complete. For the example in this post, you would see the following result:

mock_slack_post2_edited

This option provides a test run of the integration with Slack using mock data provided by Bluemix. As long as everything looks as expected, the set up process is complete because the subscription has been saved. If the notification subscription is enabled, you will receive the first notification in Slack when a maintenance event posts that is based on the criteria that you set.

IBM Cloud Information Developer

More How-tos stories
May 6, 2019

Are You Ready for SAP S/4HANA Running on Cloud?

Our clients tell us SAP applications are central to their success and strategy for cloud, with a deadline to refresh the business processes and move to SAP S/4HANA by 2025. Now is the time to assess, plan and execute the journey to cloud and SAP S/4HANA

Continue reading

April 1, 2019

Developing a Cloud Transformation Strategy 2.0: Managing Change

When defining a cloud transformation strategy, change is imminent. By defining your initial strategy based on industry best practices and open standards, you have the ability to pivot, adapt, and adjust your strategic direction to embrace change.

Continue reading

March 25, 2019

An Easy Way of Deploying Helm Charts on OpenShift

OpenShift is a Kubernetes distribution from Red Hat, similar to IBM Cloud Private, that is loaded with features to make developers' lives easier. However, there is one key feature that Kubernetes supports and OpenShift doesn't—the ability to deploy Helm charts. This post documents steps for deploying a Helm Chart into OpenShift.

Continue reading