Notification Channels
  • 16 Nov 2022
  • 6 Minutes to read
  • Dark
    Light
  • PDF

Notification Channels

  • Dark
    Light
  • PDF

Article summary

Overview

Preferred methods of communication have changed over the years—pagers, SMS, email, and now online messaging platforms like Webhook, Slack, Microsoft Teams etc. Today’s workforce is no longer in a single location but is distributed, making timely communication more challenging. Sending alerts to an email in most cases result in an alert going unnoticed for too long.
With monitoring being one of the core features of Atomic Scope, it is essential that the users get notified to their preferred way of communication. When the notification gets sent to the right place, it will be noticed quicker resulting in faster resolution.
To get started with notification channels, you will need to perform some basic configuration under “Notification Channels” section inside “Settings”.

Notification Channel Setup

On the Notification Channels page, click the Add Notification Channel button to go the page where you can configure and set up a new Notification Channel.
You specify a name and a type and type-specific options to set up the notification channel. Atomic Scope ships with the following set of notification types:

  1. Webhook
  2. SMTP
  3. Slack
  4. PagerDuty
  5. Operations Management Suite (OMS)
  6. Microsoft Teams

Webhook

The webhook channel is a simple way to send notifications over HTTP to a custom endpoint. Atomic Scope allows you to easily connect to your services/applications using the webhook connector.
Once you've configured the URL, Atomic Scope can PUT/POST the notifications as a JSON/XML format to your webhook URL. The animation below shows how you can set up a webhook channel in Atomic Scope.

gif.gif

SMTP

In order to send email notifications, Simple Mail Transfer Protocol (SMTP) settings must be configured for the outgoing mail server and login account information must be configured. The following table provides descriptions of the configuration fields and indicates whether they are required. The section that follows this table provides example configurations.

FieldRequired?Description
Friendly NameRequiredFriendly name of your SMTP channel
SMTP UsernameRequired only if SMTP Authentication is trueYour username for the SMTP server
SMTP PasswordRequired only if SMTP Authentication is trueYour password for the SMTP server
SMTP Server AddressRequiredHost address of your SMTP server
SMTP PortRequiredThe port that Serverless360 uses to connect to the SMTP server
EMail ToRequiredEmail address of the notification recipients
Email FromRequiredEmail address of the notification sender
CCOptionalEmail address of the notification recipients
BCCOptionalEmail address of the notification recipients
EMail ImportanceOptionalSet the severity of the notification

The following table provides example configurations for some common SMTP email servers.

SMTP ServerServerAuthenticationPort
Gmailsmtp.gmail.comSSL587
Office365.comsmtp.office365.comSSL587
Zoho Mailsmtp.zoho.comSSL587
Hot Mailsmtp-mail.outlook.comSSL587

Follow the below image to set up an SMTP channel in Atomic Scope.

acme_smtp.gif

To Authenticate SMTP in Gmail

While configuring Gmail SMTP channel in Atomic Scope, it requires additional authentication. Follow the below steps to authenticate in Gmail:

  1. Log into your 'Gmail account'
  2. Click the 'My Account' button on your profile picture
  3. On the My Account page, click 'Sign-in-security' tab and choose the 2step verification Turn On option
  4. Click 'Get Started' button. Gmail redirects you to the login confirmation page to enter the password.
  5. Gmail requests you to enter your mobile number to get a verification code. Once you enter a verification code, click 'Next to Turn On'.
  6. Click the Back button to move back to the Sign-in & security page and click the 'App Password' option
  7. Enter the 'Password' on the login page, Gmail will send a text message with a 6-digit verification code to your mobile number
  8. Enter the code and click 'Next '
  9. In the 'App Passwords' page enter the App name as 'AtomicScope' and click 'Generate' button
  10. Password for the application will be generated. Use this password as the SMTP password in Atomic Scope portal.

Slack

Slack is a widely used cloud-based collaborative software. At its core, Slack is an instant messaging app that provides company-wide, and private channels, direct messaging and notifications. If you and your team use Slack to communicate internally, you can receive important Atomic Scope notifications in the Slack channel of your choice. The first step is to get your Webhook URL from the Slack app. Once you connect your Slack Team to Atomic Scope, you can easily add a Webhook that pushes Atomic Scope notifications directly to any Slack channel.

This allows you to fit Atomic Scope notification in a place you know your team is checking all day, making it even easier to monitor what’s going within your integration scenario.

You have to note that anyone with access to the Slack channel will be able to see the notifications, regardless of the Atomic Scope User Access Policy that may be in place. If you need to limit visibility of these notifications in Slack, make sure to set your Slack channel's permissions to private.

acme_slack.gif

PagerDuty

PagerDuty is an operations management platform that integrates with ITOps and DevOps monitoring stacks to improve operational reliability and agility. From enriching and aggregating events to correlating them into actionable incidents, PagerDuty provides insights so you can intelligently respond to critical violations. To use this channel you need a PagerDuty account, if you don’t have one yet you can sing up at PagerDuty.com. Once you have your PagerDuty credentials available (account, password and Integration Key) you can begin your configuration

acme_pager.gif

Operations Management Suite (OMS)

For many Cloud and Hybrid users, Operations Management Suite (OMS) became the main point of monitoring and analysing data. By integrating Atomic Scope with OMS, you will be able to view all of the Atomic Scope notifications without leaving OMS portal. To connect OMS with Atomic Scope you will need to specify details like Log Type, Workspace ID, and Shared Key.

Currently, the log type supports only alpha characters. It does not support numeric or special characters.

acme_oms.gif

Microsoft Teams

Microsoft Teams is another instant messaging app like Slack that allows users with Office 365 account to easily collaborate and schedule meetings across your organisation. If your team utilises Teams to communicate, then you can easily create new incoming webhook for one of your existing channels or for a new channel.

acme_teams.gif

Offline SMTP Channel

First, we need to ensure that Atomic Scope has all the information it needs to be able to send email alerts to your mailbox. Head over to the settings page of Atomic Scope and then navigate to Application Settings.
Below the SMTP Settings section toggle “Enable SMTP”, which should show you the below fields.

  1. From-email address - this will be used as your sender email address, preferably you should create Atomic Scope specific email address in your SMTP domain e.g : atomicscope@contoso.com.
  2. Host – here enter the SMTP IP or hostname that will be used for the transaction. This can be your own private SMTP server or a public one such as Gmail “smtp.gmail.com”.
  3. Port – Enter the port number that is being used by your SMTP host for the transaction for Gmail TLS it is 587.
  4. Enable SSL – By triggering this, we ensure that the SMTP transaction uses SSL.
  5. Use Default Credentials – If you are using your own private SMTP host and authentication happens using the windows credentials, you can enable that feature to authenticate using the currently logged in user.
  6. Username & Password – If you did not select to use default credentials, you will need to provide login and password details that will be used to authenticate against the host. The password will be encrypted and stored in our database, however, it is still recommended that you have Atomic Scope specific account.

image.png


Was this article helpful?