Slack Notifications

Slack notifications allow messages to be pushed to a specific Slack channel in the event of a check warning or failure.

Only one Slack channel can have messages pushed to for each Notification configured, but multiple Notifications can be configured to use Slack if multiple channels need notifications.

Setup

These instructions assume you already have an existing Slack server to use, and sufficient access to configuration integrations.

• Login to Slack at https://slack.com/signin#/signin.
  
  
• Navigate to https://api.slack.com/, and select Your Apps at the top right of the page.
  
  
  
  
• Click the Create New App button.
  
  
• Click From an app manifest.
  
  
  
  
• Select the correct workspace and click Next.
  
  
  
  
• Click YAML to allow for YAML configuration to be given, and copy the below application manifest into the space provided, then click Next.

  display_information:
    name: EndPoint Monitor
  features:
    bot_user:
      display_name: EndPoint Monitor
      always_online: false
  oauth_config:
    scopes:
      bot:
        - chat:write
        - chat:write.customize
  settings:
    org_deploy_enabled: false
    socket_mode_enabled: false
    token_rotation_enabled: false
  

  
  
  
  
  
• Click Create.
  
  
  
  
• The application should now be created in Slack, and you should now be in its Basic Information configuration screen.
  
  
  
  Click Install to Workspace.
  
  
• Click Allow on the confirmation prompt.
  
  
  
  
• Click Add features and functionality and then click Permissions.
  
  
  
  
• Copy the Bot User OAuth Token ready for use in a later step, this should start xoxb-.
  
  
  
  
• Navigate to your EndPoint Monitor installation and login to Web Console and select Notifications from the main menu.
  
  
  
  
• Click Add located towards the top left of the web console.
  
  
• The Create Notification window should now show.
  
  
  
  Provide a name and description, and select Slack Message as the type.
  
  
• Using the Checks, Check Types, Check Groups, App Groups and Check Hosts configuration options, select what you want to be notified on in this Slack channel. See Configuration Definitions these configuration options.
  
  
• Click Show next to Integration Configuration, and add the Oauth Token copied earlier from Slack to the Slack Token field, and enter the channel you want to push messages to under Slack Channel, including any # at the start of the channel name.
  If you want Slack to add a @channel tag to any messages pushed then toggle on the Notify Channel option.
  
  
• Click OK on the Integration Configuration window and then click Save.
  
  
• You should now see confirmation that the Notification was successfully created in the bottom right notification area in the web console.
  The newly created Slack notification will immediately be active any future triggered warnings and alerts that match your selection criteria should push a message to your Slack channel.