View a markdown version of this page

Utilisation du décalage automatique zonal avec Amazon EventBridge - Contrôleur de restauration des applications Amazon (ARC)
Surveillez une ressource autoshift zonale avec EventBridgeExemples de modèles d'événements de décalage automatique zonalExemples d'événements de décalage automatique zonauxSpécifiez un groupe de CloudWatch journaux à utiliser comme cible

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 du décalage automatique zonal avec Amazon EventBridge

À l'aide d'Amazon EventBridge, vous pouvez configurer des règles pilotées par des événements qui surveillent vos ressources zonales de transfert automatique et lancent des actions ciblées utilisant d'autres services. AWS Par exemple, vous pouvez définir une règle pour l'envoi de notifications par e-mail en signalant à une rubrique Amazon SNS le début d'un exercice d'entraînement pour le décalage automatique zonal.

Vous pouvez créer des règles dans Amazon EventBridge pour agir sur le décalage automatique zonal. Un événement pour le décalage automatique zonal spécifie des informations d'état relatives aux essais ou aux décalages automatiques, par exemple, lorsqu'un exercice d'entraînement est démarré. Vous pouvez configurer le décalage automatique zonal pour vous informer des événements de décalage automatique zonal pour les ressources que vous activez pour le service.

Vous pouvez également choisir, en plus ou à la place d'autres notifications, d'activer la notification Autoshift Observer, qui fournit un événement de notification chaque fois qu'un changement automatique AWS démarre pour une zone de disponibilité potentiellement altérée. La notification Autoshift Observer est distincte des notifications que vous recevez lorsque le trafic des ressources que vous avez activées pour le décalage automatique zonal est déplacé hors d'une zone de disponibilité. Vous n'avez pas besoin de configurer les ressources avec le décalage automatique zonal pour activer la notification Autoshift Observer. Pour de plus amples informations, veuillez consulter Activation et utilisation du décalage automatique zonal.

Pour capturer les événements de décalage automatique zonaux spécifiques qui vous intéressent, définissez des modèles spécifiques à l'événement que vous EventBridge pouvez utiliser pour détecter les événements. Les modèles d'événements ont la même structure que les événements auxquels ils correspondent. Le modèle place entre guillemets les champs que vous voulez faire correspondre et fournit les valeurs que vous recherchez.

Les événements sont générés dans la mesure du possible. Ils sont livrés de l'ARC à presque EventBridge en temps réel, dans des circonstances opérationnelles normales. Cependant, des situations peuvent survenir qui pourraient retarder ou empêcher la livraison d'un événement.

Pour plus d'informations sur la façon dont EventBridge les règles fonctionnent avec les modèles d'événements, voir Événements et modèles d'événements dans EventBridge.

Surveillez une ressource autoshift zonale avec EventBridge

Avec EventBridge, vous pouvez créer des règles qui définissent les actions à entreprendre lorsque ARC émet des événements pour ses ressources. Par exemple, vous pouvez créer une règle qui envoie un message électronique au début d'un exercice d'entraînement pour le décalage automatique zonal.

Pour taper ou copier et coller un modèle d'événement dans la EventBridge console, sélectionnez l'option permettant d'utiliser l'option Entrer ma propre option dans la console. Pour vous aider à déterminer les modèles d'événements qui pourraient vous être utiles, cette rubrique inclut des exemples de modèles de correspondance d'événements de décalage automatique zonal et d'événements de décalage automatique zonaux que vous pouvez utiliser.

Pour créer une règle pour un événement de ressource

  1. Ouvrez la EventBridge console Amazon à l'adresse https://console.aws.amazon.com/events/.

  2. Choisissez la région dans Région AWS laquelle vous souhaitez créer la règle, c'est-à-dire la région pour laquelle vous souhaitez suivre les événements.

  3. Choisissez Create rule.

  4. Entrez un nom et éventuellement une description pour la règle.

  5. Pour Event bus, conservez la valeur par défaut, default.

  6. Choisissez Suivant.

  7. Pour l'étape Créer un modèle d'événement, pour Source de l'événement, laissez la valeur par défaut, AWS events.

  8. Sous Exemple d'événement, choisissez Entrez le mien.

  9. Pour Exemples d'événements, saisissez ou copiez et collez un modèle d'événement.

Exemples de modèles d'événements de décalage automatique zonal

Les modèles d'événements ont la même structure que les événements auxquels ils correspondent. Le modèle place entre guillemets les champs que vous voulez faire correspondre et fournit les valeurs que vous recherchez.

Vous pouvez copier et coller des modèles d'événements depuis cette section EventBridge pour créer des règles que vous pouvez utiliser pour surveiller les actions et les ressources de décalage automatique zonal.

Lorsque vous créez des modèles d'événements pour des événements de décalage automatique zonaux, vous pouvez spécifier l'une des options suivantes pour : detail-type

  • Autoshift In Progress

  • Autoshift Completed

  • Practice Run Started

  • Practice Run Succeeded

  • Practice Run Interrupted

  • Practice Run Failed

  • FIS Experiment Autoshift In Progress

  • FIS Experiment Autoshift Completed

  • FIS Experiment Autoshift Canceled

  • Manual Shift Started

  • Manual Shift Updated

  • Manual Shift Canceled

Lorsqu'une séance d'entraînement est interrompue, pour plus d'informations sur la cause de l'interruption, consultez le additionalFailureInfo champ.

Vous pouvez choisir de surveiller tous les AWS changements automatiques en activant les notifications Autoshift Observer. Après avoir activé la notification Autoshift Observer, pour recevoir les notifications, choisissez d'être averti pour le type de détail du décalage automatique zonal. Autoshift In Progress Pour connaître les étapes à suivre pour activer la notification Autoshift Observer, consultezActivation et utilisation du décalage automatique zonal.

Pour des exemples, consultez la section Exemples d'événements de décalage automatique zonal.

  • Sélectionnez tous les événements à partir du décalage automatique zonal où un décalage automatique a commencé.

    Notez ce qui suit :

    • Si la notification Autoshift Observer est activée, ARC renvoie tous les événements AutoShift.

    • Si la notification Autoshift Observer n'est pas activée, ARC renvoie les événements Autoshift uniquement lorsqu'une ressource que vous avez configurée pour le décalage automatique zonal est incluse dans un Autoshift.

    {
    "source": [
        "aws.arc-zonal-shift"
    ],
    "detail-type": [
        "Autoshift In Progress"
    ]
}

  • Sélectionnez tous les événements à partir du décalage automatique zonal où une séance d'entraînement a commencé. 

    {
    "source": [
        "aws.arc-zonal-shift"
    ],
    "detail-type": [
        "Practice Run Started"
    ]
}

  • Sélectionnez tous les événements dans le décalage automatique zonal pour lesquels une séance d'entraînement a échoué. 

    {
    "source": [
        "aws.arc-zonal-shift"
    ],
    "detail-type": [
        "Practice Run Failed"
    ]
}

Exemples d'événements de décalage automatique zonaux

Cette section inclut des exemples d'événements pour les actions de décalage automatique zonal.

Voici un exemple d'événement pour l'Autoshift In Progressaction, lorsque 1) la notification Autoshift Observer est activée et 2) vous n'avez pas configuré de ressource avec un décalage automatique zonal inclus dans un Autoshift :

{
    "version": "0",
    "id": "05d4d2d5-9c76-bfea-72d2-d4614802adb4",
    "detail-type": "Autoshift In Progress",
    "source": "aws.arc-zonal-shift",
    "account": "111122223333",
    "time": "2023-11-16T23:38:14Z",
    "region": "us-east-1",
    "resources": [],
    "detail": {
        "version": "0.0.1",
        "data": "",
        "metadata": {
            "awayFrom": "use1-az2",
            "notes":"AWS has started an autoshift for an impaired Availability Zone. This notification 
            is separate from autoshift notifications for resources, if any, that you have configured for 
            zonal autoshift. For details, see the Developer Guide."
        }
    }
}

Voici un exemple d'événement pour l'Autoshift In Progressaction, lorsque 1) la notification Autoshift Observer est désactivée et 2) vous avez configuré une ressource avec un décalage automatique zonal inclus dans un Autoshift :

{
    "version": "0",
    "id": "05d4d2d5-9c76-bfea-72d2-d4614802adb4",
    "detail-type": "Autoshift In Progress",
    "source": "aws.arc-zonal-shift",
    "account": "111122223333",
    "time": "2023-11-16T23:38:14Z",
    "region": "us-east-1",
    "resources": [
        "TEST-EXAMPLE-2023-11-16-23-28-11-5"
    ],
    "detail": {
        "version": "0.0.1",
        "data": "",
        "metadata": {
            "awayFrom": "use1-az2",
            "notes":""
        }
    }
}

Voici un exemple d'événement pour l'Practice Run Interruptedaction :

{
    "version": "0",
    "id": "05d4d2d5-9c76-bfea-72d2-d4614802adb4",
    "detail-type": "Practice Run Interrupted",
    "source": "aws.arc-zonal-shift",
    "account": "111122223333",
    "time": "2023-11-16T23:38:14Z",
    "region": "us-east-1",
    "resources": [
        "TEST-EXAMPLE-2023-11-16-23-28-11-5"
    ],
    "detail": {
        "version": "0.0.1",
        "data": {
            "additionalFailureInfo": "Practice run interrupted. The blocking alarm entered ALARM state."
        },
        "metadata": {
            "awayFrom": "use1-az2"
        }
    }
}

Voici un exemple d'événement pour l'FIS Experiment Autoshift In Progressaction :

{
    "version": "0",
    "id": "05d4d2d5-9c76-bfea-72d2-d4614802adb4",
    "detail-type": "FIS Experiment Autoshift In Progress",
    "source": "aws.arc-zonal-shift",
    "account": "111122223333",
    "time": "2023-11-16T23:38:14Z",
    "region": "us-east-1",
    "resources": [
        "TEST-EXAMPLE-2023-11-16-23-28-11-5"
    ],
    "detail": {
        "version": "0.0.1",
        "data": "",
        "metadata": {
            "awayFrom": "use1-az2",
            "notes":""
        }
    }
}

Voici un exemple d'événement pour l'Manual Shift Startedaction. Il est émis lorsque l'StartZonalShiftAPI est appelée sur une ressource :

{
    "version": "0",
    "id": "05d4d2d5-9c76-bfea-72d2-d4614802adb4",
    "detail-type": "Manual Shift Started",
    "source": "aws.arc-zonal-shift",
    "account": "111122223333",
    "time": "2023-11-16T23:38:14Z",
    "region": "us-east-1",
    "resources": [
        "TEST-EXAMPLE-2023-11-16-23-28-11-5"
    ],
    "detail": {
        "version": "0.0.1",
        "data": "",
        "metadata": {
            "awayFrom": "use1-az2",
            "notes":""
        }
    }
}

Spécifiez un groupe de CloudWatch journaux à utiliser comme cible

Lorsque vous créez une EventBridge règle, vous devez spécifier la cible vers laquelle sont envoyés les événements correspondant à la règle. Pour obtenir la liste des cibles disponibles pour EventBridge, consultez la section Cibles disponibles dans la EventBridge console. L'une des cibles que vous pouvez ajouter à une EventBridge règle est un groupe de CloudWatch journaux Amazon. Cette section décrit les exigences relatives à l'ajout de groupes de CloudWatch journaux en tant que cibles et fournit une procédure pour ajouter un groupe de journaux lorsque vous créez une règle.

Pour ajouter un groupe de CloudWatch journaux en tant que cible, vous pouvez effectuer l'une des opérations suivantes :

  • Création d'un nouveau groupe de journaux

  • Choisissez un groupe de journaux existant

Si vous spécifiez un nouveau groupe de journaux à l'aide de la console lorsque vous créez une règle, le groupe de journaux est EventBridge automatiquement créé pour vous. Assurez-vous que le groupe de journaux que vous utilisez comme cible pour la EventBridge règle commence par/aws/events. Si vous souhaitez choisir un groupe de journaux existant, sachez que seuls les groupes de journaux commençant par /aws/events apparaissent en tant qu'options dans le menu déroulant. Pour plus d'informations, consultez Créer un nouveau groupe de journaux dans le Guide de CloudWatch l'utilisateur Amazon.

Si vous créez ou utilisez un groupe de CloudWatch journaux à utiliser comme cible à l'aide d' CloudWatch opérations extérieures à la console, assurez-vous de définir correctement les autorisations. Si vous utilisez la console pour ajouter un groupe de journaux à une EventBridge règle, la politique basée sur les ressources pour le groupe de journaux est automatiquement mise à jour. Toutefois, si vous utilisez le AWS Command Line Interface ou un AWS SDK pour spécifier un groupe de journaux, vous devez mettre à jour la politique basée sur les ressources pour le groupe de journaux. L'exemple de politique suivant illustre les autorisations que vous devez définir dans une stratégie basée sur les ressources pour le groupe de journaux :

JSON
{
    "Version":"2012-10-17",

    "Statement": [
        {
            "Action": [
                "logs:CreateLogStream",
                "logs:PutLogEvents"
            ],
            "Effect": "Allow",
            "Principal": {
                "Service": [
                    "events.amazonaws.com",
                    "delivery.logs.amazonaws.com"
                ]
            },
            "Resource": "arn:aws:logs:us-east-1:222222222222:log-group:/aws/events/*:*",
            "Sid": "TrustEventsToStoreLogEvent"
        }
    ]
}

Vous ne pouvez pas configurer de politique basée sur les ressources pour un groupe de journaux à l'aide de la console. Pour ajouter les autorisations requises à une politique basée sur les ressources, utilisez l'opération CloudWatch PutResourcePolicy API. Vous pouvez ensuite utiliser la commande CLI describe-resource-policies pour vérifier que votre politique a été correctement appliquée.

Pour créer une règle pour un événement de ressource et spécifier une cible de groupe de CloudWatch journaux

  1. Ouvrez la EventBridge console Amazon à l'adresse https://console.aws.amazon.com/events/.

  2. Choisissez la règle dans Région AWS laquelle vous souhaitez créer la règle.

  3. Choisissez Créer une règle, puis entrez toutes les informations relatives à cette règle, telles que le schéma de l'événement ou les détails du calendrier.

    Pour plus d'informations sur la création de EventBridge règles pour ARC, consultez les sections précédentes dans cette rubrique.

  4. Sur la page Sélectionner la cible, choisissez CloudWatch comme cible.

  5. Choisissez un groupe de CloudWatch journaux dans le menu déroulant.