Working with notification channels

Alerts are sent by IBM Cloud Logs using IBM Cloud Event Notifications. You must configure Event Notifications destinations to send the alert to a notification channel. A destination in Event Notifications defines the connectivity details for a notification channel.

You can only define one notification channel per destination.

For a complete list of supported destinations, see the Event Notifications documentation.

Slack

For more informatio on configuring a Slack destination, see Configuring a slack destination.

You can also configure a custom Slack template. For more information, see Slack Notification Template.

When a message longer than 3000 characters is sent to Slack, the message text is truncated and the trunction is indicated by ...

Webhooks

You can configure a webhook destination so that an incoming notification can be consumed programmatically by an app or service. For more information about setting up webhooks, see the Event Notifications documentation.

If a call to the webhook URL fails, even after retry attempts, the notification is lost. For more information, see Webhook retry policy.

You can configure a custom template. For more information, see Webhook Notification Template.

PagerDuty

You can configure a PagerDuty destination. For more information, see Configuring a PagerDuty destination.

Only event alerts are sent to Pagerduty.

There is a 512 KB size limit for the event payload sent by IBM Cloud Logs via Event Notifications to PagerDuty.

The following table shows the mapping of fields between the Event Notifications service and PagerDuty:

Pagerduty field to Event Notifications mapping
PagerDuty field	Event Notifications mapping
`routing_key`	`routing_key` (Destination configuration)
`event_action`	Only the `trigger` action is supported
`payload.summary`	Set to the event `ibmendefaultlong` field
`payload.source`	Set to the event `ibmensourceid` field
`payload.severity`	Set to the event `ibmenseverity` field
`payload.timestamp`	Set to the event `time` field
`payload.custom_details`	Set to the event `data` object

The following table shows the mapping of severties across the different components:

Severity mapping
IBM Cloud Logs severity	Event Notifications severity	PagerDuty severity
`CRITICAL`	`Critical`	`critical`
`ERROR`	`Error`	`error`
`WARNING`	`Warning`	`warning`
`INFO`	`Info` (Default Severity)	`info`
Anything Else	Info

Email notifications

You can configure email as a destination type.

Event Notifications provides the following email destination types:

Inbuilt Email

Inbuilt Email destination provides a SMTP relay for sending transactional and informational event notification emails to recipients who need to be aware of events that happen within your IBM Cloud account.

This destination can be used to send email notifications for events originating only from IBM Cloud sources.

The content sent cannot be modified.

This destination is provided by default, and is available whenever you create an instance of the Event Notifications service.

These emails originate from no-reply@cloud.ibm.com or event-notifications@cloud.ibm.com.

You can add your own reply-to address.

You can add this type of destination directly to a subscription along with the email addresses of interest.

When using the Event Notifications Lite plan, you can have up to 3 email addresses in the recipient list. If you are using the Event Notifications Standard plan you can have up to 10000 email addresses in the recipient list.

Read the information in this topic before Creating a subscription to the IBM Cloud Email service destination type.

To receive detailed information about an event notification in your email, select the Add notification payload option when you create an Event Notifications subscription. Your email displays the notification payload details that are associated with the event.

For more information, see Inbuilt Email.
IBM Cloud Email service with a custom domain

Custom Domain Email destinations let you to tailor your communication by adding your own domain.

You have the flexibility to send emails using the email address associated with your specific domain, personalizing your correspondence, by sending your own email content.

You can configure a custom email template. For more information, see Email Templates.

For more information about using custom domains, see IBM Cloud Email service with custom domain.

The ability to configure custom domains requires an IBM Cloud Event Notifications instance running the Standard pricing plan.

ServiceNow

You can configure a ServiceNow destination. For more information, see Configuring a ServiceNow destination.