This article explains about how to create Slack Account and Integrate in Watson AIOps.
The article is based on the the following
- RedHat OpenShift 4.6 on IBM Cloud (ROKS)
- Watson AI-Ops 3.1.0
Steps
Here are the steps to be done when Configuring Slack for Watson AIOps AI Manager.
- Create Slack Workspace
- Create Slack Channels
- Create Slack App
- Integrate Slack in AI-Ops
- Integrate AI-Ops in Slack
- Update Nginx Certificate
- Create Slash Command
1. Create Slack Workspace
Goto https://slack.com/
Click on Create a New Workspace
Enter your email, otherwise go with Continue with Google
Choose your email
Click on Create a Workspace
Enter the workspace name
Enter some default channel name
Skip this step
Click on Use slack in your browser
It will open the workspace as like below.
2. Create Slack Channels
Click on Add Channel
Click on Create Channel (this is for proactive)
Enter Channel Name and etc
Click on Create
Click on Skip for Now
Similarly Create another channel (this is for reactive)
3. Create Slack App
Goto https://api.slack.com/apps
Click on Create New App
Enter Slack App Name.
Choose the above created Workspace name.
Click on Create App.
Click on OAuth & Permissions from the left menu,
In Scopes section click on Add an OAuth Scope button
Add all the listed below
- app_mentions:read
- channels:manage
- channels:read
- chat:write
- files:write
- groups:read
- groups:write
- users:read
- users:read.email
Click on Install in Workspace.
Copy the Bot User oAuth Token.
Right click on the Channel and choose the copy Link and paste in notepad.
Do the same for both the channels.
4. Integrate Slack in AI-Ops
In the AI-Ops console, click on View All in integration section.
Click on Add Integration in Slack.
Enter some Name.
Enter the below fields that we copied above
- Signing Secret
- Bot Token
- Proactive Channel
- Reactive Channel
Do the Test Connection
Click on Integrate button.
See the Slack integration created below
Click on the 1 Integration link
Copy the slack url
5. Integrate AI-Ops in Slack
Click on Event Subscription from the left menu
Choose the On button in the Enable Events
Paste the slack url and the status becomes verified.
Choose the below item to in the Subscribe to bot Events section.
Click on Save Changes
Click on the Interactivity & Shortcuts from the left menu
Click on the On checkbox.
Enter the Slack Url
Click on Save Changes
6. Update Nginx Certificate
https://pages.github.ibm.com/up-and-running/watson-aiops/AI_Manager/Installation/#ngnix-certificate-for-v31
Need to restart the nginx pods like the below. But this is not required as we patch slash command in the upcoming steps.
7. Create Slash Command
Click on Slash Commands in the left menu
Click on Create New Command button
Enter /welcome in the Command text box
Enter Request URL the slack url copied above from AI-Ops
Enter Description
Click on Save
Click on reinstall your app
Click on Allow button
Click on Add Apps for proactive channel
Click on Add button near to the app that was created above.
Click on Add Apps for reactive channel and add the app.
Run the below command to patch the slack integrator with /welcome
oc set env deployment/$(oc get deploy -l app.kubernetes.io/component=chatops-slack-integrator -o jsonpath='{.items[*].metadata.name }') SLACK_WELCOME_COMMAND_NAME=/welcome
The above patch would restart the below nginx pod. Otherwise, you can do it manually.
Enter /welcome command in proactive channel and you should see the welcome message like this.
Enter /welcome command in reacive channel and you should see the welcome message like this.
Reference
Updating the Nginx Certificate
https://pages.github.ibm.com/up-and-running/watson-aiops/AI_Manager/Installation/#ngnix-certificate-for-v31
https://cloudpak8s.io/aiops/aimgr/install/#updating-the-nginx-certificate
Configuring Slack applications for Watson AIOps AI Manager
https://www.ibm.com/docs/en/cloud-paks/cp-waiops/3.1.0?topic=integrations-slack
Configuring Slack applications for integration
https://www.ibm.com/docs/en/cloud-paks/cp-waiops/3.1.0?topic=integrations-configuring-slack-integration
Others
https://cloudpak8s.io/aiops/aimgr/slack/
To create free Workspace https://slack.com/get-started#/create
Released by :
Jeya Gandhi Rajan M
Vijaya Bhaskar R Siddareddi
Vijay Sukthankar (Squad Leader)
Hybrid-Cloud Squad
GSI Labs
#aiops310series#BestPractices