Menu
Documentationbreadcrumb arrow Grafana Cloudbreadcrumb arrow Alerts and IRMbreadcrumb arrow IRMbreadcrumb arrow Set upbreadcrumb arrow Migration options
Grafana Cloud RSS

Migrate to Grafana IRM

This guide provides an overview of migration options to help you consolidate your on-call management and incident response workflows into Grafana IRM.

Overview

Grafana IRM offers migration paths from various on-call management tools. Currently, the migration tool supports migration from:

  • PagerDuty
  • Splunk OnCall (VictorOps)
  • Grafana OnCall OSS

For detailed migration steps and automation tools, refer to the Migrator Tool in the Grafana OnCall GitHub repository.

Migration options

1. Resources that can be migrated

The following resources can be migrated using the Migrator Tool:

  1. Escalation policies
  2. On-call schedules (including rotations and scheduled overrides)
  3. User notification preferences
  4. Services and integrations
  5. Event rules

Note

Some limitations apply to specific migration sources. For example, when migrating from Splunk OnCall:

  • Primary paging policies are migrated but custom paging policies are not supported
  • Not all escalation step types are supported
  • Delays between notification/escalation rules might differ slightly from the original

2. User migration

Users are matched by email address between systems. The migration process includes:

  1. Matching existing users by email
  2. Option to automatically create Grafana users for unmatched emails
  3. Migration of user notification preferences and permissions

Note

If users are automatically created during migration, they will need to reset their passwords in Grafana.

Migration workflow

1. Review your current configuration

Before starting the migration:

  1. Document your existing setup
  2. Identify critical workflows and integrations
  3. Review the migration tool documentation for your specific platform

2. Prepare for migration

Complete these preparation steps:

  1. Install and configure Docker
  2. Build the migration tool Docker image
  3. Obtain necessary API credentials:
    • Grafana IRM API token and URL from your instance settings
    • Source platform API credentials (PagerDuty token or Splunk OnCall API ID/key)

3. Generate a migration plan

Run the migration tool in plan mode to:

  1. Preview which resources will be migrated
  2. Identify potential issues (like unmatched users)
  3. Review any resources that will be modified or deleted
  4. Understand the impact on existing configurations

4. Execute the migration

After reviewing the migration plan:

  1. Run the migration tool in migrate mode
  2. Monitor the migration progress
  3. Validate transferred resources

5. Post-migration tasks

After migration, ensure that:

  1. Users configure and verify their notification preferences in Grafana IRM
  2. Integrations are reconnected using the “How to connect” button
  3. Schedules are properly configured, especially if migrated via iCal
  4. All critical workflows are tested and validated

Additional resources