πŸ””Notifications

Connect your preferred notification platforms to receive alerts on Sedai's activity.

How to Integrate

Navigate to the Settings > Integrations page and select the Add Integration button in the upper righthand corner of the screen. Click Add Integration and select Notifications from the list.

Sedai integrates with the following notification providers to support your internal response workflows for recommended actions and insights:

Sedai also supports custom webhooks and email. For email integrations, we recommend coordinating with your IT team to obtain an email account for Sedai to use as a sender address. Notifications can be sent to a preconfigured target email address or a group email ID.

You can add multiple integrations for the same provider (such as per project or channel). Give your integration a unique nickname to help identify the difference between integrations from the same provider. This also helps in case you choose to send specific types of alerts or map groups of resources to a single integration.

Resource Mapping

You can choose to receive alerts for all resources connected to Sedai or map specific groups of resources to an integration.

We recommend creating integrations based on individual teams so you can map the group(s) of resources teams are responsible for managing (and avoid noisy alerts).

How to Subscribe

After you create a notification integration, navigate to Settings > Notifications to subscribe to alerts.

Select a notification category to view a list of alerts. From the dropdown, click the integration you want to connect to the alert.


Asana

Note: Issues will not be updated after they are generated.


Datadog

To send notifications to Datadog, you will need to generate an API key. From your Datadog account, go to Organization Settings β†’ Access β†’ API Keys. Select New Key and copy the key.


Jira

Adding Jira as a notification integration will automatically create issues but will not update their statuses. If you prefer Sedai to automatically create Jira issues as well as update their statuses, add a Jira ticketing integration instead.


Microsoft Teams

To receive Sedai notifications in your organization's workspace, you will need to setup a Webhook. Learn more:

Webhooks represent a single destination within Microsoft Teams, but you can create multiple webhooks based on your team's communication needs. You can create a webhook for direct messages or channels.

You can send alerts to existing channels in your workspace, but we recommend creating specific channels for Sedai activity only that teams can subscribe to (for example, you can create a channel to alert developers about new release scorecards, and another channel for SRE team members to monitor critical activity in Sedai).


PagerDuty

You can optionally integrate PagerDuty manually through Sedai, or log in to your PagerDuty account directly to automatically connect both platforms.

If you choose to integrate manually, you will need the following information to integrate PagerDuty within Sedai:

  • Service Name

  • Integration URL

  • Integration Key

To find this information, go to your PagerDuty account and navigate to the Service Directory from the Services menu. Choose to add an integration to one of your existing services or a new service:

  1. Select the service you want to add Sedai to, then select the Integrations tab and click New Integration.

  2. Name the integration using the format Monitoring tool: Service name.

  3. From the Integration Type menu, select Sedai.

  4. Select Add Integration to save; the screen will redirect to the Integrations tab for the service.

  5. PagerDuty will generate an Integration Key and Integration URL for the new service.

New service events will be created for each subscribed alert.


Slack

Sedai currently integrates with Slack via webhooks. Support for a Slack App is coming soon.

You will need to setup a Webhook URL to reference when adding Slack as an integration within Sedai.

Webhooks represent a single destination within Slack, but you can create multiple webhooks based on your team's communication needs. You can create a webhook for direct messages or channels.

You can send alerts to existing channels in your workspace, but we recommend creating specific channels for Sedai activity only that teams can subscribe to (for example, you can create a channel to alert developers about new release scorecards, and another channel for SRE team members to monitor critical activity in Sedai).

How to create a Slack Webhook URL

You will need to create a private Slack App and select which channels or individuals are alerted from it.

To add an App to your Slack workspace, log in to your account and go to the Slack API documentation page; select Create an App and choose From scratch.

You can name the App however you like, but we recommend including Sedai and referencing the types of alerts that you intend to send to it (such as "Sedai Release Intelligence").

The page will redirect to your new App's home page. From the lefthand panel, find the Features section and select Incoming Webhooks. Turn the toggle on to activate the feature, then select the Add New Webhook to Workspace button near the bottom.

You will be prompted to select a destination in your Slack workspace β€” this could be any public, private, or external channel, or a Direct Message to an individual. Once you choose your destination, select Allow. The App home page will refresh to display the new Webhook URL near the bottom of the screen. Select Copy; this URL can now be used to setup your Slack integration in Sedai.

Last updated