Migration Lifecycle Notifications & Performance Metrics when importing from Bitbucket

Summary

• Customer opened a support ticket to request a feature proposal for the following:
• Enhance the GitLab Import engine to provide automated notifications and detailed performance metrics for repository migrations from Bitbucket to GitLab, improving transparency and enabling better planning for large-scale migrations.

Problem Statement

Large-scale repository migrations are time-intensive and involve multiple stakeholders. Currently, the lack of granular status updates and post-migration performance data makes it difficult to:

• Plan maintenance windows for large repositories
• Baseline migration performance
• Provide audit-ready metrics to leadership
• Keep stakeholders informed during lengthy migration processes

Requested Features

1. Lifecycle Alerts

• Automatic notifications to the migration initiator when a migration:
  • Starts
  • Completes successfully
  • Fails
• Optional group notifications to designated stakeholders
• Real-time status updates throughout the migration process

2. Migration Summary Report

Upon migration completion, provide a comprehensive summary including:

• Total Duration: Complete start-to-finish migration time
• Object Migration Counts:
  • Pull Requests migrated
  • Issues migrated
  • Commits migrated
• Success/failure status for each object type

Business Value

• Performance Baselining: Enable Engineering Systems teams to establish migration performance benchmarks
• Improved Planning: help plan a better maintenance window for large repository migrations
• Audit Compliance: Provide leadership with audit-ready migration metrics
• Enhanced Transparency: Keep all stakeholders informed throughout the migration process
• Workflow Optimisation: Support continuous optimisation of DevOps workflows and migration paths

Additional Context

• There is an open feature proposal that partially overlaps (#586471). Opening this new work item as this feature proposal requests for a wider time and status range - notifying the status of the entire migration lifecycle from start to end in real time.

Acceptance Criteria

• Migration initiator receives automated start notification
• Migration initiator receives automated completion/failure notification
• Optional group notification functionality is available
• Migration summary report includes total duration
• Migration summary report includes count of migrated objects (PRs, Issues, Commits)
• Summary report is generated for both successful and failed migrations
• Notifications and reports are audit-ready and suitable for leadership reporting