Menu
Documentationbreadcrumb arrow Grafana Cloudbreadcrumb arrow Alerts and IRMbreadcrumb arrow IRMbreadcrumb arrow Managebreadcrumb arrow Notificationsbreadcrumb arrow Notification channels
Grafana Cloud RSS

Connect notification channels

Notification channels are how Grafana IRM delivers alerts to your team through various methods like Slack, SMS, and mobile notifications. Before setting up your notification rules, you must first connect and configure the corresponding notification channel.

Users can configure these notification channels directly:

The following notification channels require administrator setup at the organization level before users can configure them:

Before you begin

  • Ensure you have the necessary permissions to configure notification channels
  • Have your mobile device ready if setting up the IRM mobile app
  • Gather any required authentication credentials for messaging apps

Mobile push notifications

The Grafana IRM mobile app provides push notifications directly to your mobile device. The app includes features like Do Not Disturb and volume override settings.

For details about installing and using the app, refer to IRM mobile app.

Configure messaging apps

Messaging apps require configuration at both the organization and user level:

  1. An administrator configures messaging app integrations for the organization
  2. Users connect their accounts to configure notification rules

Set up Slack notifications

After administrator setup is complete:

  1. Go to your Grafana Cloud Profile
  2. Select the IRM tab
  3. Click Slack connection
  4. Click Open Slack connection page
  5. Authorize your Slack account

For more information, refer to IRM Slack integration.

Set up Microsoft Teams notifications

  1. Go to your Grafana Cloud Profile
  2. Select the IRM tab
  3. Click MS Teams connection
  4. Send the linkUser command as a direct message to the IRM bot
  5. Refresh the page to verify the connection

For more information, refer to MS Teams integration.

Set up Telegram notifications

  1. Go to your Grafana Cloud Profile
  2. Select the IRM tab
  3. Click Telegram connection
  4. Send the verification code to the OnCall Dev Bot in Telegram
  5. Refresh the page

Configure phone calls and SMS

  1. Go to your Grafana Cloud Profile
  2. Select the IRM tab
  3. Click Phone verification
  4. Enter your phone number and country code
  5. Click Send verification code
  6. Enter the code received via SMS

Note

For information about SMS/voice support by country, reference limitations, and costs, refer to Phone and SMS.

Configure email notifications

Email notifications are automatically available with a verified email address. Email works best for non-urgent alerts or summary notifications.

To verify your email:

  1. Go to your Grafana Cloud user profile
  2. Verify your email address is correct

Configure webhook notifications

Use outgoing webhooks to send notifications to external services or applications. Configure webhooks as personal notification channels that trigger based on your notification rules.

Set up webhook notifications

The setup process involves two steps:

  1. Administrator configuration:

    • Set trigger type to Personal Notification
    • Configure webhook URL, headers, and data templates
    • Make webhook available to users

  2. User configuration:

    • Go to your Grafana Cloud Profile
    • Select the IRM tab
    • Select the webhook as a notification channel
    • Optional: Add context data as a JSON object (Example: {"user_ID": "123"})

Tip

Webhook templates can reference user context data using the event.user object. For example, {{ event.user.user_ID }} references the user_ID value from profile settings.

For detailed configuration options, refer to Outgoing webhooks.

Next steps

  1. Set up notification rules to define how and when you receive alerts
  2. Configure mobile app push notification settings to override Do Not Disturb.
  3. Send test alerts to verify your notification setup is working as expected.