Menu
Documentationbreadcrumb arrow Grafana Cloudbreadcrumb arrow Alerts and IRMbreadcrumb arrow IRMbreadcrumb arrow Usebreadcrumb arrow Incident managementbreadcrumb arrow Manage tasks
Grafana Cloud

Manage incident tasks in Grafana IRM

The Grafana IRM task management tools help you organize, assign, and track action items during an incident, ensuring that nothing falls through the cracks and all necessary steps are completed.

This topic explains how to create, assign, and manage tasks during incident response, as well as how to integrate tasks with external systems like GitHub and Jira.

Before you begin

To manage tasks in Grafana IRM, you need:

  • Access to an active incident in Grafana IRM
  • Appropriate permissions to modify incident details
  • Optional: Configured GitHub or Jira integrations for external issue tracking

About incident tasks

Tasks in Grafana IRM help you:

  • Track specific action items needed to resolve the incident
  • Assign responsibilities to team members
  • Monitor progress of remediation efforts
  • Create a record of actions taken during the incident
  • Integrate with external ticketing systems for follow-up work

Each task can be assigned to a team member and has a status that reflects its current state.

Create and manage tasks

Add a new task

To add a task within an incident:

  1. Navigate to the incident details page.
  2. Locate the Tasks section in the right-hand sidebar.
  3. Enter a brief, action-oriented description of the task in the text field.
  4. Click +Task to create the task.

Once created, the task will appear in the list of open tasks, where you can assign it to a team member and track its status.

Tip

Write clear, actionable task descriptions that specify what needs to be done. For example, “Restart database cluster in us-west region” is better than “Fix database.”

Assign a task

Assigning tasks establishes clear ownership and accountability during incident response:

  1. Locate the task you want to assign in the Tasks list.
  2. Click on the + people icon next to the task.
  3. Search for and select the user you want to assign the task to.

The assigned user will appear next to the task.

Unassign or reassign a task

You can change task assignments as needed during an incident:

  1. Click on the user currently assigned to the task.
  2. Select one of the following options:
    • Click Unassign user to remove the current assignment
    • Search for and select a different user to reassign the task

Update task status

Tasks in Grafana IRM have three possible statuses to track their progress:

StatusIconDescription
Todo☐Task has been created but work hasn’t started
In Progress🕜Work on the task has begun but isn’t complete
Done✔️Task has been completed

To update the status of a task:

  1. Locate the task in the Tasks list.
  2. Click the status icon next to the task.
  3. The status will cycle to the next state in the sequence (Todo → In Progress → Done → Todo).

Tip

Regularly updating task statuses helps the incident commander and team members maintain awareness of overall incident progress.

Integrate with external systems

Grafana IRM can integrate with external issue tracking systems like GitHub and Jira, allowing you to manage tasks across platforms.

GitHub integration

Convert a task to a GitHub issue

To convert an existing task to a GitHub issue:

  1. Click the menu icon (three dots) next to the task you want to convert.
  2. Select Convert to GitHub Issue.
  3. Enter the organization and repository name in the format organization/repository.
  4. Add a description for the GitHub issue.
  5. Click Convert.

The task will be updated with a link to the newly created GitHub issue and will display the current issue status.

Add a task from a GitHub issue

To add an existing GitHub issue as a task:

  1. Copy the URL of the GitHub issue you want to add.
  2. Navigate to the Tasks section of your incident.
  3. Paste the GitHub issue URL into the task text field.
  4. Click +Task.

The GitHub issue will appear in your task list, and its status will be synchronized with its current state in GitHub.

To remove the link between a task and a GitHub issue:

  1. Click the menu icon (three dots) next to the linked issue.
  2. Select Unlink issue from tasklist.

This action only removes the issue from your incident task list; it does not delete or modify the GitHub issue itself.

Jira integration

Convert a task to a Jira issue

To create a Jira issue from an existing task:

  1. Click the menu icon (three dots) next to the task.
  2. Select Convert to Jira Issue.
  3. Enter your Jira organization details.
  4. Add a description for the issue.
  5. Click Convert.

The task will be updated with a link to the newly created Jira issue.

Add a task from a Jira issue

To add an existing Jira issue as a task:

  1. Copy the URL of the Jira issue.
  2. Navigate to the Tasks section of your incident.
  3. Paste the Jira issue URL into the task text field.
  4. Click +Task.

The Jira issue will appear in your task list with its current status.

To remove a Jira issue from your task list:

  1. Click the menu icon (three dots) next to the linked issue.
  2. Select Unlink issue from tasklist.

The issue will be removed from your task list but will remain unchanged in Jira.