Skip to main content

Slack Notification

In this example, we will walk through the process of creating a health check alert notification on slack starting from creating the Slack bot token.

Create a Slack bot​

Create a new app​

Visit https://api.slack.com/apps and create a new app. Use the "From an app manifest" option.

App Creation

Set up OAuth permission​

After creating the app, you should be navigated to the app's homepage. On the left panel menu, go to Features->OAuth & Permissions. Scroll down and you should see the "Scopes" section

Set chat:write permission

Install the Slack app​

While still on the same page, scroll up to the "OAuth Tokens for Your Workspace" section. Install the newly created app on your Slack workspace.

Once you install the app you should see the OAuth token

Set up the notification​

Create kubernetes secret​

We'll create a new kubernetes secret using the OAuth token we just created.

slack-secret.yaml
---
apiVersion: v1
kind: Secret
metadata:
  name: slack
  namespace: default
stringData:
  token: xoxb-910094966996-6596865117477-n7iujSYWmHtnTLMmITdm8z06

Create Connection​

Then, we create a new slack connection using that kubernetes secret. The channel that should receive the notification should go into spec.username field.

slack-connection.yaml
---
apiVersion: mission-control.flanksource.com/v1
kind: Connection
metadata:
  name: flanksource
  namespace: default
spec:
  type: slack
  url:
    value: slack://$(password)@$(username)
  username:
    value: mission-control-notifications # <-- slack channel name
  password:
    valueFrom:
      secretKeyRef:
        name: slack
        key: token

Create notification​

http-check-notification.yaml
---
apiVersion: mission-control.flanksource.com/v1
kind: Notification
metadata:
  name: http-check-alerts
  namespace: default
spec:
  events:
    - check.passed
    - check.failed
  to:
    # use the slack connection as the recipient for this notification
    connection: connection://slack/flanksource
  filter: check.type == 'http'