Connect notification channels
Notification channels determine how Grafana IRM delivers alerts to your team. Available channels include Slack, SMS, email, and mobile push notifications. Before configuring notification rules, connect and set up your preferred notification channels.
Available notification channels
The following channels can be configured directly by users:
- IRM mobile app - Push notifications with Do Not Disturb controls
- Phone and SMS - Voice calls and text messages
- Email - Automated email notifications
These channels require administrator setup before users can configure them:
- Slack - Team chat and collaboration
- Microsoft Teams - Team chat and collaboration
- Telegram - Instant messaging
- Webhooks - Custom notification integrations
Channel visibility
Administrators can manage the availability of notification channels in IRM settings.
To use a notification channel in your personal notification rules, the channel must be:
- Installed and configured in IRM > Integrations
- Enabled in IRM > Settings > Admin & API
By default, messaging app integrations (Slack, Microsoft Teams, Telegram) are enabled upon installation. If a notification channel is unavailable in your User profile, contact your administrator.
Note
Disabling a notification channel only removes it as a notification channel for users. The underlying integration remains installed. To manage integrations, refer to IRM Integrations.
Mobile push notifications
The Grafana IRM mobile app delivers push notifications directly to your device, with features including:
- Do Not Disturb settings
- Volume override controls
- Custom notification preferences
For setup instructions and features, refer to IRM mobile app.
Configure messaging apps
To use messaging app notification channels in personal notification rules, Administrator setup is required. For more detail, refer to the Channel visibility section.
Set up Slack notifications
After your administrator enables Slack integration:
- Navigate to your Grafana Cloud Profile
- Select the IRM tab
- Click Slack connection
- Select Open Slack connection page
- Authorize your Slack account
For details, refer to IRM Slack integration.
Set up Microsoft Teams notifications
- Navigate to your Grafana Cloud Profile
- Select the IRM tab
- Click MS Teams connection
- Send the linkUser command to the IRM bot
- Refresh the page to confirm connection
For details, refer to Microsoft Teams integration.
Set up Telegram notifications
- Navigate to your Grafana Cloud Profile
- Select the IRM tab
- Click Telegram connection
- Send the verification code to the OnCall Dev Bot
- Refresh the page to confirm connection
Configure phone calls and SMS
- Navigate to the IRM tab of your Grafana Cloud Profile
- Select Phone verification
- Enter your phone number, starting with + followed by your country code and your local number. No spaces, parentheses, or dashes.
- Click Send verification code and enter the code received via SMS
To help you recognize IRM calls and optionally bypass Do Not Disturb (DnD), you can sync the IRM contact to your mobile device using the IRM mobile app. For setup instructions, refer to Sync IRM phone numbers to your contacts.
Note
For information about country-specific support, expected phone number format, and notification behavior, refer to the Phone and SMS documentation.
Configure email notifications
Email notifications are automatically enabled when you verify your email address. This channel is best suited for non-urgent alerts and summary notifications.
To verify your email:
- Navigate to your Grafana Cloud user profile
- Confirm your email address is correct
Configure webhook notifications
Use webhooks to send notifications to external services or applications. Webhooks can be configured as personal notification channels that trigger based on your notification rules.
Set up webhook notifications
Configuration requires two steps:
Administrator setup:
- Configure trigger type as
Personal Notification
- Set webhook URL, headers, and data templates
- Enable webhook for user access
- Configure trigger type as
User setup:
- Navigate to your Grafana Cloud Profile
- Select the IRM tab
- Choose the webhook as a notification channel
- Optional: Add custom context data as JSON (Example:
{"user_ID": "123"}
)
Tip
Access user context data in webhook templates using the
event.user
object. Example:{{ event.user.user_ID }}
references theuser_ID
from profile settings.
For configuration details, refer to Outgoing webhooks.
Next steps
- Configure notification rules to define when and how you receive alerts
- Set up mobile app push notifications and Do Not Disturb overrides
- Test your notification setup with test alerts