Add and manage incident participants
During active incidents, you need the right people involved at the right time. Grafana IRM’s participant management features allow you to quickly bring in teammates to help investigate and resolve incidents.
This topic explains how to add participants to incidents, manage invitations, and track participation status.
Before you begin
To add and manage participants in Grafana IRM, you need:
- Access to an active incident (or drill incident in Grafana IRM
- Appropriate permissions to modify incident details
- For team invitations: properly configured teams in Grafana Cloud
About incident participation
When you add participants to an incident, Grafana IRM:
- Sends notifications to the invited users through their configured notification rules
- Tracks their response status (invited, acknowledged, accepted, or declined)
- Allows participants to contribute to incident resolution
All invitations are delivered using the OnCall Direct Paging integration, which creates an alert group associated with the incident. This integration uses:
- Individual notification rules configured in Grafana Cloud IRM profiles
- Team on-call schedules when adding an entire team
- Escalation chains for automatic escalation if configured
Add participants to an incident
You can invite both individuals and teams to participate in an incident. Invitations trigger notifications through configured channels such as email, Slack, SMS, or phone.
Invite individual users
To invite specific users to an incident:
- Navigate to the incident details page.
- Locate the Participants section in the right sidebar.
- Click + Invite.
- In the invitation dialog, switch to the Users tab if not already selected.
- Search for and select the users you want to invite.
- In the confirmation window, select the notification priority:
- Default: Uses the user’s standard notification settings
- Important: Uses the user’s high-priority notification settings
- Click Confirm to send the invitations.
Tip
Use the Important priority option when you need an immediate response from the invited participants.
Invite teams
To invite an entire team to an incident:
- Navigate to the incident details page.
- Locate the Participants section in the right sidebar.
- Click + Invite.
- In the invitation dialog, switch to the Teams tab.
- Search for and select the teams you want to invite.
- In the confirmation window, select the notification priority.
- Click Confirm to send the invitations.
Note
When you invite a team, the notification goes to the currently on-call team member(s) as defined in the team’s on-call schedule.
Respond to an invitation
When you receive an incident invitation, you can respond in several ways depending on your availability and role.
Response options
When you receive an invitation notification (via email, Slack, SMS, or phone call), you can:
- Accept: Join the incident and actively participate in the resolution
- Decline: Indicate you’re unable to participate
- Dismiss: Acknowledge the notification without committing to participate
Your response affects the associated alert group:
- Accepting/Declining: Resolves the associated alert group and stops any escalation chains
- Dismissing: Leaves the alert group active, allowing potential escalation to continue
Change your response later
If you initially dismissed an invitation or need to change your response:
- Navigate to the incident page.
- Find your name in the Participants section.
- Click the appropriate action icon:
- ✔️ (Checkmark): Accept the invitation
- 🗑️ (Trash): Decline the invitation
Manage participants
The incident owner and users with appropriate permissions can manage participants throughout the incident lifecycle.
Monitor participant status
The Participants section displays each invited participant’s current status:
Icon | Status | Description |
---|---|---|
🔔 | Invited | User has been invited but hasn’t responded |
👁️ | Acknowledged | User has seen the invitation but hasn’t formally accepted |
✔️ | Accepted | User has accepted the invitation and is actively participating |
❌ | Declined | User has declined the invitation |
Remove participants
To remove a participant from an incident:
- Navigate to the incident details page.
- In the Participants section, find the participant you want to remove.
- Click the 🗑️ (Trash) icon next to their name.
- Confirm the removal when prompted.
Note
Removing a participant stops any ongoing notifications to that user and resolves the associated alert group.
View notification details
To see the notification history for a participant:
- Navigate to the incident details page.
- In the Participants section, find the participant.
- Click on their profile icon or name.
- In the popup menu, select View notification details.
This shows the alert group associated with the invitation, including notification delivery attempts and status.
Troubleshoot participant invitations
If you encounter issues with participant invitations, check these common causes:
Team not appearing in the invitation list
If you don’t see a team in the invitation dialog:
- Verify the team is properly registered in Grafana Cloud teams.
- Ensure the team has a Direct Paging integration with configured notification channels.
- Check that you have permission to view and modify the team.
User not receiving invitations
If a user reports not receiving invitations:
- Verify their notification rules are properly configured in their Grafana Cloud IRM profile.
- Check that they have the correct contact information (email, phone number) in their profile.
- Confirm they are a member of your Grafana Cloud organization with appropriate permissions.