📧 Slack Integration
You can use Slack to get notified about anomalies in your Kubernetes cluster using alerts.
While Anteon Cloud allows you to integrate your Slack workspace into Anteon seamlessly, you need to follow some steps to do the same on Anteon Self-Hosted. Here’s how you can do so:
Note: This doc is only applicable to Anteon Self-Hosted Enterprise Edition. Anteon Self-Hosted Community Edition does not support alerts and integrations.
Creating A Slack App
To create a Slack integration for Anteon Self-Hosted, you need to create a Slack application. Go to Slack Apps. You need to sign in to your Slack workspace.
- Click on “Create New App”.
![Slack app creation 1](/doc-images/crUN1pNj5F78Nai9TbUn6TE2j270QCjcrxJ3fpu5DjOpaw0rOoVyCJBSuupPh_3S2O3eFsl4U6IeOPXlhH1RjXMu6XhnzH8IiI75b77_NKPsJqD-GNu4VqgtmkOucboltdkgEJ50TKGcC4xZCPoViag.webp)
- Choose “From scratch”.
![Slack app creation 2](/doc-images/Kq2KEqkWboFKKckDXxQX4bDZyP25bf1guAV9l_i7PwwS-eyXy8_LW91gRKMmZeOBbNKsitzCXM1dTsgbpHiX2KeJlQzOsmFUIpijdLQIVj2MGq4aAPuJo8QQtZurCjfHKeCMUjM7h0EdcivHMLZxsk0.webp)
- Give it a name (you can type in Anteon) and choose a workspace you already logged in.
- Click on “Create App”.
- Go to “OAuth & Permissions” from the tabs on the left.
![Slack app management tabs](/img/image (106).webp)
- Scroll down to “Scopes”.
![Empty bot token scopes](/doc-images/hLc0kjzAmovl_tnoPe6HsOZaMUNd2L4bnRR_cPS6NGJK8LRctRhVyFWfBb8M80RhcOx67YudNx1NS7bzeY3c0EIPjziZHU-pvJ5Jv6PPaq0xru8nSldtzBdAJA3dT4mUsh2RnCfiSzK9Cpk4gEnECHE.webp)
- Click on “Add an OAuth Scope” in the “Bot Token Scopes” part.
- Add the following permissions:
- channels:join
- channels:read
- chat:write
- groups:read
- im:read
- mpim:read
- After that, your “Bot Token Scopes” should look like this:
![Correct bot token scopes](/doc-images/MqWscNAnktzslyVM8HWlNe2nnx5cBf1fQZYI1YJE9yj44ixH_67DlqwnFwRUCi_keCaeBuRB-62JrZWmnkcObEBnjLLOMiYi9z14j28pAtAj6ycSmlBE1MpkKVAj8ABTaftYXloe9UF9Rf9odWnb59Q.webp)
- Then click on “Install to Workspace” under the section “OAuth Tokens for Your Workspace”
![The button to add the slack app to workspace](/doc-images/0xJtxOAvoui1EUPsUvxAgOy3tF8OpGFTIOJUUljJ8tdnIxwSiih9TsxZZpH56pT75ssMRO1EWcbYWvVeWg0OIkWnsfjBMBSi85FoQIyD0hvyi1jRMEhXvaI1bomHosyNj5YJEkoGRgAlmEZlRfbxIV0.webp)
- You will be redirected to a Slack page asking for permissions on your selected workspace. Click on “Allow” to continue.
![Slack workspace permission page](/doc-images/PE816FVgLeuChpQ0dk3m59HZZHiYenU_PQbrgZSxGvwJyon_njixEYzNco-5lou-WxXdy9TWtx3P_1XdGK-pX-PoxRHTuXZuOC8VYTQlNt8NACk00JvGuQ9WLnyNjFewtjU1U24JZR_a81w0xxbQK5Y.webp)
- Then, in the “OAuth Tokens for your Workspace” section, you will see a “Bot User OAuth Token”. Copy it and paste it on Slack integration creation in Anteon.
![An example bot user OAuth token](/doc-images/25TL3_ONqV6cdyYI-Zn_VfWvcGuKJ7Xz2JCr0AjI9OyjFcgI7kxWix8iVk6xG-CfE1WxQhooBrOiXrKx5nlKmEwRC-RA2IHLcKiuLfUnkd3WW0iDvCY_Yh_dvGja0ZDBtWTuf7DTRPf1grVOwTSPgQo.webp)
Congratulations! 🎉 You've successfully configured your Slack app. Now there remain only a few steps to connect it to Anteon.
Setting Up The Slack App in Anteon
- After you create your Slack application, go to the integrations section in Anteon Self-Hosted EE. You can find it here:
![Anteon Self-Hosted pages](/doc-images/7jJ9nuckEcrBAsU6pw3VKr_TdBkrGqNtT0L6qzoBwfatiaPymvTrdahQe-rRvJ4LLnRe-IVvAWkHPwi6fzMmb4n2VX47zlLXKOsEJEfj8yxuMrYcwNqqsYjwDyp_zGpWa5zZ8Ilw7_AepbLkyqjMfb4.webp)
- After that, click on “Add Integration”. A pop-up will show up:
- Here, provide a name for your integration, paste the Bot User OAuth Token you copied from the earlier step, and click on “Make Integration”. This will take you to the channel selection page.
Note: If your Bot Token is correct, you will be able to see the channels present in your Slack workspace. If your token is invalid, this channel dropdown will be stuck at loading. In that case, you can delete the integration and retry.
![Slack channel selection dropdown](/doc-images/KsRbo-HObw0jFlIlXkB-zxlXQSDzK1e89QR7ZkP1is5WaClywts2s0heQg5wZfanuj--51O8zWBDrwP_-8smwpcH9f0DiJp3WacDOiahXkTB-IK3Of_5Xy6Dfv0JNVGIjvAnDnpjxd6rpxIa5LQ2mcI.webp)
- After you choose a channel and click on “Save Channel”, your slack app will join that channel and will be able to send messages there.
- Once successful, you can test your integration by clicking “Test Integration”. If you are able to see the test message sent to your selected Slack channel, that means you've successfully set up your Slack app and you can start to use this integration in your alerts.
![Test integration button](/doc-images/sVMiW-s_yH6x2VJfMsyoZUapZoNbfk9mRGWG1OEJwluF7eQE8fa_zbfhGG6mtFBIQsVFvMamZm6vB2COYODJ_v86o_MZsACVEve4d3R3CHY8orr-HI5R4R5Rl73S44L5B2gY1ysc8DukK2GPo2tCx-k.webp)
This is what you will see if your integration works successfully:
![Example Slack test message](/doc-images/h8es_Lf23WAAOldZKZ1TVhQ3ajeWoB80dyHsOCpVxa2mCjmpLgAEQvD_ZXgpi7sjVn4EsaPNY0m4Y4SODeFNG-tUKq8QydCrNYfGYzGk1EXyOic30W1N0LHzGUW6ooR90hL8B6blorkWGEfTKZ94nZw.webp)
If you require assistance with setting up Slack integration for Anteon Self-Hosted, you can join our Discord or send an email to [email protected].