AWS Systems Manager Incident Manager n'est plus ouvert aux nouveaux clients. Les clients existants peuvent continuer à utiliser le service normalement. Pour plus d'informations, consultez AWS Systems Manager Incident Manager la section Modification de la disponibilité.

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Utilisation des runbooks de migration pour OpsCenter

Ce guide fournit des step-by-step instructions pour migrer vos CloudWatch alarmes Amazon et vos EventBridge règles Amazon depuis AWS Systems Manager Incident Manager vers l' AWS Systems Manager OpsCenter utilisation de runbooks de migration automatisés.

Pour un aperçu des OpsCenter fonctionnalités et pour comprendre les différences entre Incident Manager et OpsCenter, voirMigration vers AWS Systems Manager OpsCenter.

Présentation de la migration

Le processus de migration utilise les runbooks Systems Manager Automation pour intégrer vos CloudWatch alarmes et EventBridge règles existantes. OpsCenter Le processus comprend les étapes suivantes :

Étape 1 : Déployer le CloudFormation modèle

Déployez le CloudFormation modèle pour créer le rôle IAM, le compartiment Amazon S3 et la rubrique Amazon SNS requis par les runbooks de migration.

Autorisations IAM requises

Pour déployer ce CloudFormation modèle, vous avez besoin d'autorisations IAM pour les opérations de CloudFormation stack (cloudformation:CreateStack,cloudformation:DescribeStacks), la gestion des rôles IAM (iam:CreateRole,,iam:PutRolePolicy,iam:PassRole)iam:AttachRolePolicy, la création et la configuration de compartiments Amazon S3 (s3:CreateBucket,s3:PutBucket*) et les opérations sur les rubriques Amazon SNS sns:CreateTopic (sns:Subscribe,,). sns:SetTopicAttributes

Pour plus de détails sur CloudFormation les autorisations, consultez la référence CloudFormation aux autorisations dans le guide de CloudFormation l'utilisateur.

Pour déployer le CloudFormation modèle à l'aide de la console

CloudFormation affiche le CREATE_IN_PROGRESS statut. Le statut passe au CREATE_COMPLETE moment où la pile est prête.

Pour déployer le CloudFormation modèle à l'aide du AWS CLI

Pour la première région de votre compte, utilisez la commande suivante :

aws cloudformation create-stack \
    --stack-name im-migration-infrastructure \
    --template-body file://AWS-IncidentManager-MigrationResources.yaml \
    --parameters ParameterKey=ApprovalEmail,ParameterValue=your-email@example.com \
    ParameterKey=IsPrimaryMigrationRegion,ParameterValue=true \
    --capabilities CAPABILITY_NAMED_IAM \
    --region us-east-1
      

Pour les régions supplémentaires associées au même compte, définissez les paramètres IsPrimaryMigrationRegion false suivants :

aws cloudformation create-stack \
    --stack-name im-migration-infrastructure \
    --template-body file://AWS-IncidentManager-MigrationResources.yaml \
    --parameters ParameterKey=ApprovalEmail,ParameterValue=your-email@example.com \
    ParameterKey=IsPrimaryMigrationRegion,ParameterValue=false \
    --capabilities CAPABILITY_NAMED_IAM \
    --region us-west-2
      

Pour vérifier l'état de la pile :

aws cloudformation describe-stacks \
    --stack-name im-migration-infrastructure \
    --query 'Stacks[0].StackStatus' \
    --output text
      

Attendez le retour de la commande CREATE_COMPLETE avant de passer à l'étape suivante.

Étape 2 : migrer les CloudWatch alarmes et EventBridge les règles

Utilisez les runbooks Systems Manager Automation pour migrer vos CloudWatch alarmes et EventBridge règles d'Incident Manager vers OpsCenter.

Runbooks de migration

Pour plus d'informations sur le fonctionnement de ces runbooks, y compris les descriptions détaillées des étapes, les paramètres d'entrée et les sorties, consultez la documentation des runbooks.

Comment fonctionnent les runbooks

Les deux runbooks de migration suivent le même flux de travail :

Paramètres d’entrée

Les deux runbooks nécessitent les paramètres suivants :

Pour effectuer une migration à l'aide de la console

Pour effectuer une migration à l'aide du AWS CLI

Pour les CloudWatch alarmes :

aws ssm start-automation-execution \
    --document-name "AWS-MigrateIncidentManagerCloudWatchAlarms" \
    --parameters '{
        "AutomationAssumeRole": ["arn:aws:iam::123456789012:role/IM-Migration-Automation-Role"],
        "ApproverArn": ["arn:aws:iam::123456789012:role/Admin"],
        "S3BucketName": ["im-migration-logs-123456789012-us-east-1"],
        "SNSTopicArn": ["arn:aws:sns:us-east-1:123456789012:Automation-IM-Migration-Approvals"],
        "RequireManualApproval": ["false"]
    }' \
    --region us-east-1
      

Pour EventBridge les règles :

aws ssm start-automation-execution \
    --document-name "AWS-MigrateIncidentManagerEventBridgeRules" \
    --parameters '{
        "AutomationAssumeRole": ["arn:aws:iam::123456789012:role/IM-Migration-Automation-Role"],
        "ApproverArn": ["arn:aws:iam::123456789012:role/Admin"],
        "S3BucketName": ["im-migration-logs-123456789012-us-east-1"],
        "SNSTopicArn": ["arn:aws:sns:us-east-1:123456789012:Automation-IM-Migration-Approvals"],
        "RequireManualApproval": ["false"]
    }' \
    --region us-east-1
      

Pour consulter la liste des ressources dans Amazon S3 :

# For CloudWatch alarms
aws s3 cp s3://im-migration-logs-123456789012-us-east-1/review/CloudWatch/review_CW_alarms_to_migrate_123456789012_us-east-1.json ./

# For EventBridge rules
aws s3 cp s3://im-migration-logs-123456789012-us-east-1/review/EventBridge/review_EB_rules_to_migrate_123456789012_us-east-1.json ./
      

Si RequireManualApproval ce paramètre est défini sur true, consultez la liste des ressources et approuvez la migration en cliquant sur le lien d'approbation figurant dans la notification par e-mail ou sur la page de la console d'exécution automatique. Si ce paramètre est défini sur false, la migration se poursuit automatiquement après la sauvegarde.

Étape 3 : vérifier votre migration

Une fois la migration terminée, vérifiez que vos ressources fonctionnent correctement :

Étape 4 : Nettoyer les ressources du gestionnaire d'incidents

Après avoir migré avec succès vos CloudWatch alarmes et vos EventBridge règles, vous pouvez éventuellement nettoyer les ressources d'Incident Manager pour vous déconnecter complètement du service.

Pour obtenir des instructions détaillées sur la suppression du kit de réplication, des plans de réponse, des contacts, des runbooks et d'autres ressources du gestionnaire d'incidents, consultezNettoyage des ressources du gestionnaire d'incidents.

Supprimer CloudFormation des piles (facultatif)

Vous pouvez supprimer les CloudFormation piles pour supprimer le rôle IAM, la rubrique Amazon SNS et le compartiment Amazon S3 créés pour la migration.

Pour supprimer la CloudFormation pile

aws cloudformation delete-stack --stack-name <your-stack-name>
      

Surveillance et résolution des problèmes

CloudWatch Journaux : les activités de migration sont enregistrées dans CloudWatch Logs :

Structure de sauvegarde Amazon S3 : toutes les configurations sont sauvegardées sur Amazon S3 avant la migration :

migration-logs-{AccountId}-{Region}/
├── backups/
│   ├── CloudWatch/
│   │   └── {AccountId}/
│   │       └── {Region}/
│   │           └── {AlarmName}_backup.json
│   └── EventBridge/
│       └── {AccountId}/
│           └── {Region}/
│               └── {RuleName}_backup.json
└── review/
    ├── CloudWatch/
    │   └── review_CW_alarms_to_migrate_{AccountId}_{Region}.json
    └── EventBridge/
        └── review_EB_rules_to_migrate_{AccountId}_{Region}.json
    

Problèmes courants :

Procédure de rétrogradation :

Si vous devez annuler la migration :

Questions fréquentes (FAQ)

Ressources connexes