App notifiers let you choose where Scalingo sends messages about your application activity. A notifier is defined for one application and contains:

• a name, to identify it in the dashboard;
• a notification channel, such as email, Slack, webhook, or Rocket.Chat;
• the event types that should trigger a notification.

When an event matching the notifier configuration occurs, Scalingo sends a notification through the selected channel.

Vocabulary

Event

An occurrence of an event type generated by the platform for an app.

Event type

An event identifier that can be selected in a notifier, for example app_deployed.

Notifier

A per-app configuration that defines where selected events are sent.

Notification

The message sent by a notifier.

Alert

A metric threshold rule that can trigger notifications through selected notifiers.

Default Notifier

Each app has a default notifier. This notifier is configured to send critical alerts by email to the application owner.

Scalingo regularly updates the default notifier to include new critical alerts.

We recommend keeping the default notifier active, keeping critical alert event types selected, and adding the application’s collaborators to this notifier.

Creating Custom Notifiers

Create additional notifiers when you need specific channels, recipients, or event types.

For example, you can create a notifier dedicated to deployment events, another one for alerts, or another one for a webhook-based integration.

From the Dashboard

• From your web browser, open your Scalingo dashboard.
• Select the app for which you want to configure notifiers.
• Click the Settings tab.
• In the settings menu, select Notifiers.
• Click Add.
• Select the notification platform.
• Configure the notifier name and recipients.
• Select the event types for which the notifier reacts.
• Click Finish.

Notification Platform Settings

Depending on the selected notification platform, the notifier asks for different delivery settings:

• Email: target app collaborators or additional email addresses.
• Webhook-based platforms: provide a webhook URL.
• Slack: use an Incoming Webhook URL. You can refer to Slack documentation to set it up.
• Rocket.Chat: configure the webhook URL.
• Mattermost: use the Slack integration.

Using Notifiers With Alerts

Notifiers are also used by application metric alerts. When an alert is triggered, Scalingo creates an event and sends a notification to the notifiers selected in the alert configuration.

Event Types

A notifier can react to all events, to deployment events only, or to a custom selection of event types.

The available event types are: