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.
# EventBridge À utiliser pour gérer les événements Auto Scaling
Amazon EventBridge, anciennement appelé CloudWatch Events, vous aide à configurer des règles basées sur les événements qui surveillent les ressources et initient des actions ciblées utilisant d'autres AWS services.
Les événements d'Amazon EC2 Auto Scaling sont transmis EventBridge en temps quasi réel. Vous pouvez établir des EventBridge règles qui invoquent des actions programmatiques et des notifications en réponse à divers événements de ce type. Par exemple, lorsque les instances sont en cours de lancement ou d'arrêt, vous pouvez appeler une AWS Lambda fonction pour exécuter une tâche préconfigurée.
Les cibles des EventBridge règles peuvent inclure AWS Lambda des fonctions, des rubriques Amazon SNS, des destinations d'API, des bus d'événements Comptes AWS, etc. Pour plus d'informations sur les cibles prises en charge, consultez [ EventBridge les cibles Amazon](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-targets.html) dans le *guide de EventBridge l'utilisateur Amazon*.
Commencez par créer des EventBridge règles avec un exemple à l'aide d'une rubrique Amazon SNS et d'une EventBridge règle. Ensuite, lorsqu'un utilisateur démarre une actualisation d'instance, Amazon SNS vous avertit par e-mail chaque fois qu'un point de contrôle est atteint. Pour de plus amples informations, veuillez consulter [Créez des EventBridge règles pour les événements d'actualisation, par exemple](monitor-events-eventbridge-sns.md).
**Topics**
+ [Référence de l'événement Amazon EC2 Auto Scaling](ec2-auto-scaling-event-reference.md)
+ [Exemples d'événements et de modèles d'actualisation des instances](instance-refresh-eventbridge-events.md)
+ [Exemples d’événements et de modèles de groupe chaud](warm-pools-eventbridge-events.md)
+ [Utilisez les EventBridge règles d'Amazon pour automatiser les actions](create-eventbridge-rules.md)
# Référence de l'événement Amazon EC2 Auto Scaling
À l'aide d'Amazon EventBridge, vous pouvez créer des *règles* qui correspondent aux *événements* entrants et les acheminer vers *des cibles à des* fins de traitement.
**Topics**
+ [Événements d’action de cycle de vie](#ec2-auto-scaling-lifecycle-action-events)
+ [Événements réussis de mise à l’échelle](#ec2-auto-scaling-successful-scaling-events)
+ [Échec des événements de mise à l’échelle](#ec2-auto-scaling-unsuccessful-scaling-events)
## Événements d’action de cycle de vie
Lorsque vous ajoutez des hooks de cycle de vie à votre groupe Auto Scaling, Amazon EC2 Auto Scaling envoie des événements EventBridge lorsqu'une instance passe en état d'attente. Les événements sont générés sur la base du meilleur effort.
**Topics**
+ [Action du cycle de vie de montée en puissance](#launch-lifecycle-action)
+ [Action du cycle de vie de mise à l’échelle horizontale](#terminate-lifecycle-action)
### Action du cycle de vie de montée en puissance
L’événement suivant en exemple montre que Amazon EC2 Auto Scaling a déplacé une instance vers un état `Pending:Wait` en raison d’un hook de cycle de vie de lancement.
```
{
"version": "0",
"id": "12345678-1234-1234-1234-123456789012",
"detail-type": "EC2 Instance-launch Lifecycle Action",
"source": "aws.autoscaling",
"account": "123456789012",
"time": "yyyy-mm-ddThh:mm:ssZ",
"region": "us-west-2",
"resources": [
"auto-scaling-group-arn"
],
"detail": {
"LifecycleActionToken": "87654321-4321-4321-4321-210987654321",
"AutoScalingGroupName": "my-asg",
"LifecycleHookName": "my-lifecycle-hook",
"EC2InstanceId": "i-1234567890abcdef0",
"LifecycleTransition": "autoscaling:EC2_INSTANCE_LAUNCHING",
"NotificationMetadata": "additional-info",
"Origin": "EC2",
"Destination": "AutoScalingGroup"
}
}
```
### Action du cycle de vie de mise à l’échelle horizontale
L’événement suivant en exemple montre que Amazon EC2 Auto Scaling a déplacé une instance vers un état `Terminating:Wait` en raison d’un hook de cycle de vie de résiliation.
**Important**
Lorsqu’un groupe Auto Scaling renvoie des instances vers un groupe chaud lors de la mise à l’échelle horizontale, ce renvoi peut également générer des événements `EC2 Instance-terminate Lifecycle Action`. Les événements générés lorsqu’une instance passe à l’état d’attente lors de mise à l’échelle horizontale indiquent `WarmPool` comme valeur de `Destination`. Pour de plus amples informations, veuillez consulter [Instance reuse policy](ec2-auto-scaling-warm-pools.md#instance-reuse-policy).
```
{
"version": "0",
"id": "12345678-1234-1234-1234-123456789012",
"detail-type": "EC2 Instance-terminate Lifecycle Action",
"source": "aws.autoscaling",
"account": "123456789012",
"time": "yyyy-mm-ddThh:mm:ssZ",
"region": "us-west-2",
"resources": [
"auto-scaling-group-arn"
],
"detail": {
"LifecycleActionToken":"87654321-4321-4321-4321-210987654321",
"AutoScalingGroupName":"my-asg",
"LifecycleHookName":"my-lifecycle-hook",
"EC2InstanceId":"i-1234567890abcdef0",
"LifecycleTransition":"autoscaling:EC2_INSTANCE_TERMINATING",
"NotificationMetadata":"additional-info",
"Origin": "AutoScalingGroup",
"Destination": "EC2"
}
}
```
## Événements réussis de mise à l’échelle
Les exemples suivants montrent les types d’événements en cas d’événements réussis de mise à l’échelle. Les événements sont générés sur la base du meilleur effort.
**Topics**
+ [Événement réussi de montée en puissance](#launch-successful)
+ [Événement réussi de mise à l’échelle horizontale](#terminate-successful)
### Événement réussi de montée en puissance
L’événement suivant en exemple montre que Amazon EC2 Auto Scaling a lancé une instance avec succès.
```
{
"version": "0",
"id": "12345678-1234-1234-1234-123456789012",
"detail-type": "EC2 Instance Launch Successful",
"source": "aws.autoscaling",
"account": "123456789012",
"time": "yyyy-mm-ddThh:mm:ssZ",
"region": "us-west-2",
"resources": [
"auto-scaling-group-arn",
"instance-arn"
],
"detail": {
"StatusCode": "InProgress",
"Description": "Launching a new EC2 instance: i-12345678",
"AutoScalingGroupName": "my-asg",
"ActivityId": "87654321-4321-4321-4321-210987654321",
"Details": {
"Availability Zone": "us-west-2b",
"Subnet ID": "subnet-12345678"
},
"RequestId": "12345678-1234-1234-1234-123456789012",
"StatusMessage": "",
"EndTime": "yyyy-mm-ddThh:mm:ssZ",
"EC2InstanceId": "i-1234567890abcdef0",
"StartTime": "yyyy-mm-ddThh:mm:ssZ",
"Cause": "description-text",
"Origin": "EC2",
"Destination": "AutoScalingGroup"
}
}
```
### Événement réussi de mise à l’échelle horizontale
L’événement suivant en exemple montre que Amazon EC2 Auto Scaling a résilié une instance avec succès.
**Important**
Lorsqu’un groupe Auto Scaling renvoie des instances vers un groupe chaud lors de la mise à l’échelle horizontale, ce renvoi peut également générer des événements `EC2 Instance Terminate Successful`. Les événements générés lorsqu’une instance retourne avec succès dans le groupe chaud indiquent `WarmPool` comme valeur de `Destination`. Pour de plus amples informations, veuillez consulter [Instance reuse policy](ec2-auto-scaling-warm-pools.md#instance-reuse-policy).
```
{
"version": "0",
"id": "12345678-1234-1234-1234-123456789012",
"detail-type": "EC2 Instance Terminate Successful",
"source": "aws.autoscaling",
"account": "123456789012",
"time": "yyyy-mm-ddThh:mm:ssZ",
"region": "us-west-2",
"resources": [
"auto-scaling-group-arn",
"instance-arn"
],
"detail": {
"StatusCode": "InProgress",
"Description": "Terminating EC2 instance: i-12345678",
"AutoScalingGroupName": "my-asg",
"ActivityId": "87654321-4321-4321-4321-210987654321",
"Details": {
"Availability Zone": "us-west-2b",
"Subnet ID": "subnet-12345678"
},
"RequestId": "12345678-1234-1234-1234-123456789012",
"StatusMessage": "",
"EndTime": "yyyy-mm-ddThh:mm:ssZ",
"EC2InstanceId": "i-1234567890abcdef0",
"StartTime": "yyyy-mm-ddThh:mm:ssZ",
"Cause": "description-text",
"Origin": "AutoScalingGroup",
"Destination": "EC2"
}
}
```
## Échec des événements de mise à l’échelle
Les exemples suivants montrent les types d’événements en cas d’échec des événements de mise à l’échelle. Les événements sont générés sur la base du meilleur effort.
**Topics**
+ [Échec de l’événement de montée en puissance](#launch-unsuccessful)
+ [Échec de l’événement de mise à l’échelle horizontale](#terminate-unsuccessful)
### Échec de l’événement de montée en puissance
L’événement suivant en exemple montre que Amazon EC2 Auto Scaling n’a pas pu lancer une instance.
```
{
"version": "0",
"id": "12345678-1234-1234-1234-123456789012",
"detail-type": "EC2 Instance Launch Unsuccessful",
"source": "aws.autoscaling",
"account": "123456789012",
"time": "yyyy-mm-ddThh:mm:ssZ",
"region": "us-west-2",
"resources": [
"auto-scaling-group-arn",
"instance-arn"
],
"detail": {
"StatusCode": "Failed",
"AutoScalingGroupName": "my-asg",
"ActivityId": "87654321-4321-4321-4321-210987654321",
"Details": {
"Availability Zone": "us-west-2b",
"Subnet ID": "subnet-12345678"
},
"RequestId": "12345678-1234-1234-1234-123456789012",
"StatusMessage": "message-text",
"EndTime": "yyyy-mm-ddThh:mm:ssZ",
"EC2InstanceId": "i-1234567890abcdef0",
"StartTime": "yyyy-mm-ddThh:mm:ssZ",
"Cause": "description-text",
"Origin": "EC2",
"Destination": "AutoScalingGroup"
}
}
```
### Échec de l’événement de mise à l’échelle horizontale
L’événement suivant en exemple montre que Amazon EC2 Auto Scaling n’a pas pu résilier une instance.
**Important**
Lorsqu’un groupe Auto Scaling renvoie des instances vers un groupe chaud lors de la mise à l’échelle horizontale, l’échec de ce renvoi peut également générer des événements `EC2 Instance Terminate Unsuccessful`. Les événements générés lorsqu’une instance ne parvient pas à retourner dans le groupe chaud indiquent `WarmPool` comme valeur de `Destination`. Pour de plus amples informations, veuillez consulter [Instance reuse policy](ec2-auto-scaling-warm-pools.md#instance-reuse-policy).
```
{
"version": "0",
"id": "12345678-1234-1234-1234-123456789012",
"detail-type": "EC2 Instance Terminate Unsuccessful",
"source": "aws.autoscaling",
"account": "123456789012",
"time": "yyyy-mm-ddThh:mm:ssZ",
"region": "us-west-2",
"resources": [
"auto-scaling-group-arn",
"instance-arn"
],
"detail": {
"StatusCode": "Failed",
"AutoScalingGroupName": "my-asg",
"ActivityId": "87654321-4321-4321-4321-210987654321",
"Details": {
"Availability Zone": "us-west-2b",
"Subnet ID": "subnet-12345678"
},
"RequestId": "12345678-1234-1234-1234-123456789012",
"StatusMessage": "message-text",
"EndTime": "yyyy-mm-ddThh:mm:ssZ",
"EC2InstanceId": "i-1234567890abcdef0",
"StartTime": "yyyy-mm-ddThh:mm:ssZ",
"Cause": "description-text",
"Origin": "AutoScalingGroup",
"Destination": "EC2"
}
}
```
# Exemples d'événements et de modèles d'actualisation des instances
À l'aide d'Amazon EventBridge, vous pouvez créer des *règles* qui correspondent aux *événements* entrants et les acheminer vers *des cibles à des* fins de traitement.
**Topics**
+ [Événements d’actualisation d’instance](#instance-refresh-events)
+ [Actualisation des instances : remplacement des événements du cycle de vie du volume racine](#instance-refresh-rvr-lifecycle-events)
## Événements d’actualisation d’instance
Les exemples suivants illustrent des événements de la fonction d’actualisation des instances. Les événements sont générés sur la base du meilleur effort.
**Topics**
+ [Point de contrôle atteint](#instance-refresh-checkpoint-reached)
+ [Début de l’actualisation de l’instance](#instance-refresh-started)
+ [Actualisation de l’instance réussie](#instance-refresh-succeeded)
+ [Échec de l’actualisation de l’instance](#instance-refresh-failed)
+ [Annulation de l’actualisation de l’instance](#instance-refresh-cancelled)
+ [L'annulation de l'actualisation de l'instance a commencé](#instance-refresh-rollback-started)
+ [Annulation de l'actualisation de l'instance réussie](#instance-refresh-rollback-succeeded)
+ [L'annulation de l'actualisation de l'instance a échoué](#instance-refresh-rollback-failed)
### Point de contrôle atteint
Lorsque le nombre d’instances qui ont été remplacées atteint le seuil (en pourcentage) défini pour le point de contrôle, Amazon EC2 Auto Scaling envoie l’événement suivant.
```
{
"version": "0",
"id": "12345678-1234-1234-1234-123456789012",
"detail-type": "EC2 Auto Scaling Instance Refresh Checkpoint Reached",
"source": "aws.autoscaling",
"account": "123456789012",
"time": "yyyy-mm-ddThh:mm:ssZ",
"region": "us-west-2",
"resources": [
"auto-scaling-group-arn"
],
"detail": {
"InstanceRefreshId": "ab00cf8f-9126-4f3c-8010-dbb8cad6fb86",
"AutoScalingGroupName": "my-asg",
"CheckpointPercentage": "50",
"CheckpointDelay": "300"
}
}
```
### Début de l’actualisation de l’instance
Lorsque le statut d’une actualisation d’instance passe à `InProgress`, Amazon EC2 Auto Scaling envoie les événements suivants.
```
{
"version": "0",
"id": "12345678-1234-1234-1234-123456789012",
"detail-type": "EC2 Auto Scaling Instance Refresh Started",
"source": "aws.autoscaling",
"account": "123456789012",
"time": "yyyy-mm-ddThh:mm:ssZ",
"region": "us-west-2",
"resources": [
"auto-scaling-group-arn"
],
"detail": {
"InstanceRefreshId": "c613620e-07e2-4ed2-a9e2-ef8258911ade",
"AutoScalingGroupName": "my-asg"
}
}
```
### Actualisation de l’instance réussie
Lorsque le statut d’une actualisation d’instance passe à `Successful`, Amazon EC2 Auto Scaling envoie les événements suivants.
```
{
"version": "0",
"id": "12345678-1234-1234-1234-123456789012",
"detail-type": "EC2 Auto Scaling Instance Refresh Succeeded",
"source": "aws.autoscaling",
"account": "123456789012",
"time": "yyyy-mm-ddThh:mm:ssZ",
"region": "us-west-2",
"resources": [
"auto-scaling-group-arn"
],
"detail": {
"InstanceRefreshId": "c613620e-07e2-4ed2-a9e2-ef8258911ade",
"AutoScalingGroupName": "my-asg"
}
}
```
### Échec de l’actualisation de l’instance
Lorsque le statut d’une actualisation d’instance passe à `Failed`, Amazon EC2 Auto Scaling envoie les événements suivants.
```
{
"version": "0",
"id": "12345678-1234-1234-1234-123456789012",
"detail-type": "EC2 Auto Scaling Instance Refresh Failed",
"source": "aws.autoscaling",
"account": "123456789012",
"time": "yyyy-mm-ddThh:mm:ssZ",
"region": "us-west-2",
"resources": [
"auto-scaling-group-arn"
],
"detail": {
"InstanceRefreshId": "c613620e-07e2-4ed2-a9e2-ef8258911ade",
"AutoScalingGroupName": "my-asg"
}
}
```
### Annulation de l’actualisation de l’instance
Lorsque le statut d’une actualisation d’instance passe à `Cancelled`, Amazon EC2 Auto Scaling envoie les événements suivants.
```
{
"version": "0",
"id": "12345678-1234-1234-1234-123456789012",
"detail-type": "EC2 Auto Scaling Instance Refresh Cancelled",
"source": "aws.autoscaling",
"account": "123456789012",
"time": "yyyy-mm-ddThh:mm:ssZ",
"region": "us-west-2",
"resources": [
"auto-scaling-group-arn"
],
"detail": {
"InstanceRefreshId": "c613620e-07e2-4ed2-a9e2-ef8258911ade",
"AutoScalingGroupName": "my-asg"
}
}
```
### L'annulation de l'actualisation de l'instance a commencé
Lorsque le statut d’une actualisation d’instance passe à `RollbackInProgress`, Amazon EC2 Auto Scaling envoie les événements suivants.
```
{
"version": "0",
"id": "12345678-1234-1234-1234-123456789012",
"detail-type": "EC2 Auto Scaling Instance Refresh Rollback Started",
"source": "aws.autoscaling",
"account": "123456789012",
"time": "yyyy-mm-ddThh:mm:ssZ",
"region": "us-west-2",
"resources": [
"auto-scaling-group-arn"
],
"detail": {
"InstanceRefreshId": "c613620e-07e2-4ed2-a9e2-ef8258911ade",
"AutoScalingGroupName": "my-asg"
}
}
```
### Annulation de l'actualisation de l'instance réussie
Lorsque le statut d’une actualisation d’instance passe à `RollbackSuccessful`, Amazon EC2 Auto Scaling envoie les événements suivants.
```
{
"version": "0",
"id": "12345678-1234-1234-1234-123456789012",
"detail-type": "EC2 Auto Scaling Instance Refresh Rollback Succeeded",
"source": "aws.autoscaling",
"account": "123456789012",
"time": "yyyy-mm-ddThh:mm:ssZ",
"region": "us-west-2",
"resources": [
"auto-scaling-group-arn"
],
"detail": {
"InstanceRefreshId": "c613620e-07e2-4ed2-a9e2-ef8258911ade",
"AutoScalingGroupName": "my-asg"
}
}
```
### L'annulation de l'actualisation de l'instance a échoué
Lorsque le statut d’une actualisation d’instance passe à `Failed`, Amazon EC2 Auto Scaling envoie les événements suivants.
```
{
"version": "0",
"id": "12345678-1234-1234-1234-123456789012",
"detail-type": "EC2 Auto Scaling Instance Refresh Rollback Failed",
"source": "aws.autoscaling",
"account": "123456789012",
"time": "yyyy-mm-ddThh:mm:ssZ",
"region": "us-west-2",
"resources": [
"auto-scaling-group-arn"
],
"detail": {
"InstanceRefreshId": "c613620e-07e2-4ed2-a9e2-ef8258911ade",
"AutoScalingGroupName": "my-asg"
}
}
```
## Actualisation des instances : remplacement des événements du cycle de vie du volume racine
Lorsque vous ajoutez des hooks de cycle de vie à votre groupe Auto Scaling, Amazon EC2 Auto Scaling envoie des événements EventBridge lorsqu'une instance passe en état d'attente. Pour de plus amples informations, veuillez consulter [Utilisez des hooks de cycle de vie pour remplacer le volume racine](replace-root-volume.md#replace-root-volume-lifecycle-hooks).
Les exemples suivants montrent des événements lorsque votre groupe Auto Scaling possède des instances en cours de remplacement d'un volume racine lors d'une actualisation d'instance. Les événements sont générés sur la base du meilleur effort.
**Topics**
+ [Lancer l'action de remplacement du cycle de vie du volume racine](#rvr-start-lifecycle-action)
+ [Fin de l'action de remplacement du cycle de vie du volume racine](#rvr-end-lifecycle-action)
+ [Exemples de modèles d'événement](#rvr-event-patterns)
### Lancer l'action de remplacement du cycle de vie du volume racine
Lorsqu'une instance est sélectionnée pour le remplacement du volume racine lors de l'actualisation de l'instance et que son état passe à`ReplacingRootVolume:Wait`.
```
{
"version": "0",
"id": "12345678-1234-1234-1234-123456789012",
"detail-type": "EC2 Instance-terminate Lifecycle Action",
"source": "aws.autoscaling",
"account": "123456789012",
"time": "2021-01-13T00:12:37.214Z",
"region": "us-west-2",
"resources": [
"auto-scaling-group-arn"
],
"detail": {
"LifecycleActionToken": "71514b9d-6a40-4b26-8523-05e7eEXAMPLE",
"AutoScalingGroupName": "my-asg",
"LifecycleHookName": "my-terminate-lifecycle-hook",
"EC2InstanceId": "i-1234567890abcdef0",
"LifecycleTransition": "autoscaling:EC2_INSTANCE_TERMINATING",
"NotificationMetadata": "additional-info",
"Origin": "AutoScalingGroup",
"Destination": "AutoScalingGroup",
"Action": "ReplaceRootVolume"
}
}
```
### Fin de l'action de remplacement du cycle de vie du volume racine
Lorsqu'une instance a terminé le remplacement du volume racine et que son état passe à`Pending:Wait`.
```
{
"version": "0",
"id": "12345678-1234-1234-1234-123456789012",
"detail-type": "EC2 Instance-launch Lifecycle Action",
"source": "aws.autoscaling",
"account": "123456789012",
"time": "2021-01-13T00:12:37.214Z",
"region": "us-west-2",
"resources": [
"auto-scaling-group-arn"
],
"detail": {
"LifecycleActionToken": "71514b9d-6a40-4b26-8523-05e7eEXAMPLE",
"AutoScalingGroupName": "my-asg",
"LifecycleHookName": "my-launch-lifecycle-hook",
"EC2InstanceId": "i-1234567890abcdef0",
"LifecycleTransition": "autoscaling:EC2_INSTANCE_LAUNCHING",
"NotificationMetadata": "additional-info",
"Origin": "AutoScalingGroup",
"Destination": "AutoScalingGroup",
"Action": "ReplaceRootVolume"
}
}
```
### Exemples de modèles d'événement
La section précédente fournit des exemples d'événements émis par Amazon EC2 Auto Scaling lors d'une actualisation d'instance avec une stratégie de remplacement du volume racine. EventBridge 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 champs suivants de l'événement constituent le modèle d'événement défini dans la règle permettant d'appeler une action :
`"source": "aws.autoscaling"`
Identifie que l'événement provient de Amazon EC2 Auto Scaling.
`"detail-type": "EC2 Instance-launch Lifecycle Action"`
Identifie le type d’événement.
`"Action": "ReplaceRootVolume"`
Identifie l'action en cours d'exécution sur l'instance.
Utilisez l'exemple de modèle d'événements suivant pour capturer tous les événements associés aux instances qui se préparent à remplacer leur volume racine :
```
{
"source": [ "aws.autoscaling" ],
"detail-type": [ "EC2 Instance-terminate Lifecycle Action" ],
"detail": {
"Action": [ "ReplaceRootVolume" ]
}
}
```
Utilisez l'exemple de modèle d'événement suivant pour capturer tous les événements associés à la remise en service des instances après le remplacement du volume racine :
```
{
"source": [ "aws.autoscaling" ],
"detail-type": [ "EC2 Instance-launch Lifecycle Action" ],
"detail": {
"Action": [ "ReplaceRootVolume" ]
}
}
```
# Exemples d’événements et de modèles de groupe chaud
Amazon EC2 Auto Scaling prend en charge plusieurs modèles prédéfinis dans Amazon EventBridge. Cela simplifie la création d'un modèle d'événement. Vous sélectionnez les valeurs des champs dans un formulaire et vous EventBridge générez le modèle pour vous. Pour le moment, Amazon EC2 Auto Scaling ne prend pas en charge les modèles prédéfinis pour les événements émis par un groupe Auto Scaling doté d'un groupe d'instances pré-initialisées. Vous devez entrer le modèle en tant qu'objet JSON. Cette section et la rubrique [Créez des EventBridge règles pour les événements en piscine chaude](warm-pool-events-eventbridge-rules.md) vous montre comment utiliser un modèle d'événements pour sélectionner des événements et les envoyer à des cibles.
Pour créer des EventBridge règles filtrant les événements liés au warm pool auxquels Amazon EC2 Auto Scaling envoie EventBridge, incluez `Origin` les champs `Destination` et de la section de `detail` l'événement.
Les valeurs de `Origin` et `Destination` peuvent être les suivantes :
`EC2` \$1 `AutoScalingGroup` \$1 `WarmPool`
**Topics**
+ [Exemples d’événements](#warm-pool-events)
+ [Exemples de modèles d'événement](#warm-pools-eventbridge-patterns)
## Exemples d’événements
Lorsque vous ajoutez des hooks de cycle de vie à votre groupe Auto Scaling, Amazon EC2 Auto Scaling envoie des événements EventBridge lorsqu'une instance passe en état d'attente. Pour de plus amples informations, veuillez consulter [Utilisez des hooks de cycle de vie avec un pool de chaleur dans le groupe Auto Scaling](warm-pool-instance-lifecycle.md).
Cette section comprend des exemples de ces événements lorsque votre groupe Auto Scaling dispose d’un groupe chaud. Les événements sont générés sur la base du meilleur effort.
**Note**
Pour les événements auxquels Amazon EC2 Auto Scaling envoie EventBridge une fois le dimensionnement réussi, [Événements réussis de mise à l’échelle](ec2-auto-scaling-event-reference.md#ec2-auto-scaling-successful-scaling-events) consultez. Pour les événements où la mise à l’échelle échoue, consultez [Échec des événements de mise à l’échelle](ec2-auto-scaling-event-reference.md#ec2-auto-scaling-unsuccessful-scaling-events).
**Topics**
+ [Action du cycle de vie de montée en puissance](#warm-pool-scale-out-events)
+ [Action du cycle de vie de mise à l’échelle horizontale](#warm-pool-scale-in-events)
### Action du cycle de vie de montée en puissance
Les événements générés lorsqu’une instance passe à un état d’attente pour des événements de montée en puissance indiquent `EC2 Instance-launch Lifecycle Action` comme valeur de `detail-type`. Dans l’objet `detail`, les valeurs des attributs `Origin` et `Destination` indiquent d’où vient l’instance et où elle va.
Dans cet exemple d’événement de montée en puissance, une nouvelle instance est lancée et son état passe à `Warmed:Pending:Wait` parce qu’elle est ajoutée au groupe chaud. Pour de plus amples informations, veuillez consulter [Transitions de l'état du cycle de vie pour les instances dans un groupe d'instances pré-initialisées](warm-pool-instance-lifecycle.md#lifecycle-state-transitions).
```
{
"version": "0",
"id": "12345678-1234-1234-1234-123456789012",
"detail-type": "EC2 Instance-launch Lifecycle Action",
"source": "aws.autoscaling",
"account": "123456789012",
"time": "2021-01-13T00:12:37.214Z",
"region": "us-west-2",
"resources": [
"auto-scaling-group-arn"
],
"detail": {
"LifecycleActionToken": "71514b9d-6a40-4b26-8523-05e7eEXAMPLE",
"AutoScalingGroupName": "my-asg",
"LifecycleHookName": "my-launch-lifecycle-hook",
"EC2InstanceId": "i-1234567890abcdef0",
"LifecycleTransition": "autoscaling:EC2_INSTANCE_LAUNCHING",
"NotificationMetadata": "additional-info",
"Origin": "EC2",
"Destination": "WarmPool"
}
}
```
Dans cet exemple d’événement de montée en puissance, l’état de l’instance passe à `Pending:Wait` parce qu’elle est ajoutée au groupe Auto Scaling depuis le groupe chaud. Pour de plus amples informations, veuillez consulter [Transitions de l'état du cycle de vie pour les instances dans un groupe d'instances pré-initialisées](warm-pool-instance-lifecycle.md#lifecycle-state-transitions).
```
{
"version": "0",
"id": "12345678-1234-1234-1234-123456789012",
"detail-type": "EC2 Instance-launch Lifecycle Action",
"source": "aws.autoscaling",
"account": "123456789012",
"time": "2021-01-19T00:35:52.359Z",
"region": "us-west-2",
"resources": [
"auto-scaling-group-arn"
],
"detail": {
"LifecycleActionToken": "19cc4d4a-e450-4d1c-b448-0de67EXAMPLE",
"AutoScalingGroupName": "my-asg",
"LifecycleHookName": "my-launch-lifecycle-hook",
"EC2InstanceId": "i-1234567890abcdef0",
"LifecycleTransition": "autoscaling:EC2_INSTANCE_LAUNCHING",
"NotificationMetadata": "additional-info",
"Origin": "WarmPool",
"Destination": "AutoScalingGroup"
}
}
```
### Action du cycle de vie de mise à l’échelle horizontale
Les événements générés lorsqu’une instance passe à un état d’attente pour des événements de mise à l’échelle horizontale indiquent `EC2 Instance-terminate Lifecycle Action` comme valeur de `detail-type`. Dans l’objet `detail`, les valeurs des attributs `Origin` et `Destination` indiquent d’où vient l’instance et où elle va.
Dans cet exemple d’événement de type mise à l’échelle horizontale, l’état d’une instance passe à `Warmed:Pending:Wait` car elle est retournée au groupe chaud. Pour de plus amples informations, veuillez consulter [Transitions de l'état du cycle de vie pour les instances dans un groupe d'instances pré-initialisées](warm-pool-instance-lifecycle.md#lifecycle-state-transitions).
```
{
"version": "0",
"id": "12345678-1234-1234-1234-123456789012",
"detail-type": "EC2 Instance-terminate Lifecycle Action",
"source": "aws.autoscaling",
"account": "123456789012",
"time": "2022-03-28T00:12:37.214Z",
"region": "us-west-2",
"resources": [
"auto-scaling-group-arn"
],
"detail": {
"LifecycleActionToken": "42694b3d-4b70-6a62-8523-09a1eEXAMPLE",
"AutoScalingGroupName": "my-asg",
"LifecycleHookName": "my-termination-lifecycle-hook",
"EC2InstanceId": "i-1234567890abcdef0",
"LifecycleTransition": "autoscaling:EC2_INSTANCE_TERMINATING",
"NotificationMetadata": "additional-info",
"Origin": "AutoScalingGroup",
"Destination": "WarmPool"
}
}
```
## Exemples de modèles d'événement
La section précédente fournit des exemples d'événements émis par Amazon EC2 Auto Scaling.
EventBridge 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 champs suivants de l'événement constituent le modèle d'événement défini dans la règle permettant d'appeler une action :
`"source": "aws.autoscaling"`
Identifie que l'événement provient de Amazon EC2 Auto Scaling.
`"detail-type": "EC2 Instance-launch Lifecycle Action"`
Identifie le type d’événement.
`"Origin": "EC2"`
Identifie l'origine de l'instance.
`"Destination": "WarmPool"`
Identifie la destination de l'instance.
Utilisez l’exemple de modèle d’événement suivant pour capturer tous les événements `EC2 Instance-launch Lifecycle Action` associés aux instances qui intègrent le groupe chaud.
```
{
"source": [ "aws.autoscaling" ],
"detail-type": [ "EC2 Instance-launch Lifecycle Action" ],
"detail": {
"Origin": [ "EC2" ],
"Destination": [ "WarmPool" ]
}
}
```
Utilisez l’exemple de modèle d’événement suivant pour capturer tous les événements `EC2 Instance-launch Lifecycle Action` associés aux instances qui sortent du groupe chaud en réponse à un événement de montée en puissance.
```
{
"source": [ "aws.autoscaling" ],
"detail-type": [ "EC2 Instance-launch Lifecycle Action" ],
"detail": {
"Origin": [ "WarmPool" ],
"Destination": [ "AutoScalingGroup" ]
}
}
```
Utilisez l’exemple de modèle d’événement suivant pour capturer tous les événements `EC2 Instance-launch Lifecycle Action` associés aux instances lancées directement dans le groupe Auto Scaling.
```
{
"source": [ "aws.autoscaling" ],
"detail-type": [ "EC2 Instance-launch Lifecycle Action" ],
"detail": {
"Origin": [ "EC2" ],
"Destination": [ "AutoScalingGroup" ]
}
}
```
Utilisez l’exemple de modèle d’événement suivant pour capturer tous les événements `EC2 Instance-terminate Lifecycle Action` associés aux instances renvoyées vers le groupe chaud mis à l’échelle horizontale.
```
{
"source": [ "aws.autoscaling" ],
"detail-type": [ "EC2 Instance-terminate Lifecycle Action" ],
"detail": {
"Origin": [ "AutoScalingGroup" ],
"Destination": [ "WarmPool" ]
}
}
```
Utilisez l'exemple de modèle d'événement suivant pour capturer tous les événements associés à `EC2 Instance-launch Lifecycle Action`, quelle que soit l'origine ou la destination.
```
{
"source": [ "aws.autoscaling" ],
"detail-type": [ "EC2 Instance-launch Lifecycle Action" ]
}
```
# Utilisez les EventBridge règles d'Amazon pour automatiser les actions
Lorsqu'un événement est émis par Amazon EC2 Auto Scaling, une notification d'événement est envoyée à EventBridge Amazon sous forme de fichier JSON. Vous pouvez écrire une EventBridge règle pour automatiser les actions à effectuer lorsqu'un modèle d'événement correspond à la règle. S'il EventBridge détecte un modèle d'événement correspondant à un modèle défini dans une règle, EventBridge invoque la cible (ou les cibles) spécifiée dans la règle.
Vous pouvez utiliser les procédures d'exemple de cette section comme point de départ.
Vous pourriez également trouver la documentation suivante utile.
+ Pour exécuter des actions personnalisées sur les instances au moment de leur lancement ou avant qu'elles ne soient terminées à l'aide d'une fonction Lambda, consultez la rubrique [Didacticiel : configurer un hook de cycle de vie qui appelle une fonction Lambda](tutorial-lifecycle-hook-lambda.md).
+ Pour appeler une fonction Lambda sur les appels d'API enregistrés avec CloudTrail, consultez [Tutoriel : journalisation des appels d' AWS API EventBridge à l'aide](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-log-api-call.html) du guide de l'* EventBridge utilisateur Amazon*.
+ Pour plus d'informations sur la création de règles relatives aux événements, consultez la section [Création de EventBridge règles Amazon qui réagissent aux événements](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-create-rule.html) dans le *guide de EventBridge l'utilisateur Amazon*.
**Topics**
+ [Créez des EventBridge règles pour les événements d'actualisation, par exemple](monitor-events-eventbridge-sns.md)
+ [Créez des EventBridge règles pour les événements en piscine chaude](warm-pool-events-eventbridge-rules.md)
# Créez des EventBridge règles pour les événements d'actualisation, par exemple
L'exemple suivant crée une EventBridge règle pour envoyer une notification par e-mail. Elle effectue cette opération chaque fois que votre groupe Auto Scaling émet un événement lorsqu'un point de contrôle est atteint pendant une actualisation d'instance. La procédure de configuration des notifications par e-mail à l'aide d'Amazon SNS est incluse. Pour utiliser Amazon SNS afin d'envoyer des notifications par e-mail, vous devez d'abord créer une *rubrique*, puis abonner les adresses e-mail requises à cette rubrique.
Pour plus d'informations sur la fonction d'actualisation d'instance, consultez la rubrique [Utiliser une actualisation d'instance pour mettre à jour les instances d'un groupe Auto Scaling](asg-instance-refresh.md).
## Créer une rubrique Amazon SNS
Une rubrique SNS est un point d'accès logique, un canal de communication utilisé par le groupe Auto Scaling pour envoyer les notifications. Pour créer une rubrique, donnez-lui un nom.
Les noms de rubrique doivent respecter les critères suivants :
+ Avoir 1 à 256 caractères
+ Contenir des lettres majuscules et minuscules ASCII, des chiffres, des traits de soulignement ou de traits d'union
Pour plus d'informations, consultez [Création d'une rubrique Amazon SNS](https://docs.aws.amazon.com/sns/latest/dg/sns-create-topic.html) dans le *Guide du développeur Amazon Simple Notification Service*.
## Abonner à la rubrique Amazon SNS
Pour recevoir les notifications que votre groupe Auto Scaling envoie à la rubrique, vous devez abonner un point de terminaison à cette dernière. Dans cette procédure, sous **Point de terminaison**, spécifiez l'adresse e-mail à laquelle vous souhaitez recevoir les notifications envoyées par Amazon EC2 Auto Scaling.
Pour plus d'informations, consultez [Abonnement à une rubrique Amazon SNS](https://docs.aws.amazon.com/sns/latest/dg/sns-create-subscribe-endpoint-to-topic.html) dans le *Guide du développeur Amazon Simple Notification Service*.
## Confirmer votre abonnement Amazon SNS
Amazon SNS envoie un e-mail de confirmation à l'adresse que vous avez spécifiée à l'étape précédente.
Assurez-vous d'ouvrir l'e-mail depuis AWS Notifications et de choisir le lien pour confirmer l'abonnement avant de passer à l'étape suivante.
Vous recevrez un message d'accusé de réception de. AWS Amazon SNS est maintenant configuré pour recevoir des notifications et envoyer la notification par e-mail à l'adresse spécifiée.
## Acheminer les événements vers votre rubrique Amazon SNS
Créez une règle qui correspond aux événements sélectionnés et les achemine vers votre rubrique Amazon SNS pour envoyer des notifications aux adresses e-mail abonnées.
**Pour créer une règle qui envoie des notifications à votre rubrique Amazon SNS**
1. Ouvrez la EventBridge console Amazon à l'adresse [https://console.aws.amazon.com/events/](https://console.aws.amazon.com/events/).
1. Dans le panneau de navigation, choisissez **Rules**.
1. Choisissez **Créer une règle**.
1. Pour **Define rule detail** (Définir les détails de la règle), procédez comme suit :
1. Entrez un **nom** et éventuellement une description pour la règle.
Une règle ne peut pas avoir le même nom qu’une autre règle de la même région et sur le même bus d’événement.
1. Pour **Event bus** (Bus d’événement), choisissez **default** (défaut). Lorsqu'un AWS service de votre compte génère un événement, celui-ci est toujours redirigé vers le bus d'événements par défaut de votre compte.
1. Pour **Type de règle**, choisissez **Règle avec un modèle d’événement**.
1. Choisissez **Suivant**.
1. Pour **Build event pattern** (Créer un modèle d’événement), procédez comme suit :
1. Dans **Source de l'événement**, choisissez **AWS des événements ou des événements EventBridge partenaires**.
1. Pour **Event pattern** (Modèle d’événement), procédez comme suit :
1. Pour **Event source (Source d’événement)**, choisissez **Services AWS**.
1. Pour **Service AWS**, choisissez **Auto Scaling**.
1. Dans **Type d'événement**, choisissez **Actualisation d'instance**.
1. Par défaut, la règle correspond à tout événement d'actualisation d'instance. Pour créer une règle permettant d'envoyer une notification chaque fois qu'un point de contrôle est atteint pendant une actualisation d'instance, choisissez **Specific instance event(s)** (Événement[s] d'instance spécifique[s]) et sélectionnez **EC2 Auto Scaling Instance Refresh Checkpoint Reached** (Point de contrôle lié à une actualisation d'instance EC2 Auto Scaling atteint).
1. Par défaut, la règle correspond à tout groupe Auto Scaling de la région. Pour que la règle corresponde à un groupe Auto Scaling spécifique, choisissez **Nom(s) de groupe spécifique(s)**, puis sélectionnez un ou plusieurs groupes Auto Scaling.
1. Choisissez **Suivant**.
1. Pour **Select target(s)** (Sélectionner la ou les cibles), procédez comme suit :
1. Pour **Target types** (Types de cibles), choisissez **Service AWS**.
1. Pour **Select a target** (Sélectionnez une cible), choisissez **SNS Topic** (Rubrique SNS).
1. Pour **Topic** (Rubrique), choisissez votre rubrique Amazon SNS.
1. (Facultatif) Sous **Additional settings** (Paramètres supplémentaires), vous pouvez configurer des paramètres supplémentaires. Pour plus d'informations, consultez [la section Création de EventBridge règles Amazon qui réagissent aux événements](https://docs.aws.amazon.com//eventbridge/latest/userguide/eb-create-rule.html) dans le *guide de EventBridge l'utilisateur Amazon*.
1. Choisissez **Suivant**.
1. (Facultatif) Pour **Tags** (Identifications), vous pouvez également attribuer une ou plusieurs identifications à votre règle, puis choisir **Next** (Suivant).
1. Pour **Review and create** (Vérifier et créer), examinez les détails de la règle et modifiez-les si nécessaire. Puis choisissez **Create rule** (Créer une règle).
# Créez des EventBridge règles pour les événements en piscine chaude
L'exemple suivant crée une EventBridge règle pour invoquer des actions programmatiques. Elle effectue cette opération chaque fois que votre groupe Auto Scaling émet un événement lorsqu'une nouvelle instance est ajoutée au groupe d'instances pré-initialisées.
Avant de créer la règle, créez la AWS Lambda fonction que vous souhaitez que la règle utilise comme cible. Vous devez spécifier cette fonction comme étant la cible de la règle. La procédure suivante décrit uniquement les étapes permettant de créer la EventBridge règle qui agit lorsque de nouvelles instances entrent dans le pool de chaleur. Pour un tutoriel d'introduction qui vous montre comment créer une simple fonction Lambda à invoquer lorsqu'un événement entrant correspond à une règle, consultez la rubrique [Didacticiel : configurer un hook de cycle de vie qui appelle une fonction Lambda](tutorial-lifecycle-hook-lambda.md).
Pour plus d'informations sur la création et l'utilisation de groupes d'instances pré-initialisées, consultez la rubrique [Réduisez la latence pour les applications dont le temps de démarrage est long à l'aide de pools chauds](ec2-auto-scaling-warm-pools.md).
**Pour créer une règle d'événement qui invoque une fonction Lambda**
1. Ouvrez la EventBridge console Amazon à l'adresse [https://console.aws.amazon.com/events/](https://console.aws.amazon.com/events/).
1. Dans le panneau de navigation, choisissez **Rules**.
1. Choisissez **Créer une règle**.
1. Pour **Define rule detail** (Définir les détails de la règle), procédez comme suit :
1. Entrez un **nom** et éventuellement une description pour la règle.
Une règle ne peut pas avoir le même nom qu’une autre règle de la même région et sur le même bus d’événement.
1. Pour **Event bus** (Bus d’événement), choisissez **default** (défaut). Lorsqu'un événement est généré Service AWS dans votre compte, il est toujours redirigé vers le bus d'événements par défaut de votre compte.
1. Pour **Type de règle**, choisissez **Règle avec un modèle d’événement**.
1. Choisissez **Suivant**.
1. Pour **Build event pattern** (Créer un modèle d’événement), procédez comme suit :
1. Dans **Source de l'événement**, choisissez **AWS des événements ou des événements EventBridge partenaires**.
1. Pour **Modèle d'événement**, choisissez **Modèle personnalisé (éditeur JSON)** et collez le modèle suivant dans la zone **Modèle d'événement**, en **italics**remplaçant le texte par le nom de votre groupe Auto Scaling.
```
{
"source": [ "aws.autoscaling" ],
"detail-type": [ "EC2 Instance-launch Lifecycle Action" ],
"detail": {
"AutoScalingGroupName": [ "my-asg" ],
"Origin": [ "EC2" ],
"Destination": [ "WarmPool" ]
}
}
```
Pour créer une règle qui correspond à d'autres événements, modifiez le modèle d'événement. Pour plus d'informations, consultez la rubrique [Exemples de modèles d'événement](warm-pools-eventbridge-events.md#warm-pools-eventbridge-patterns).
1. Choisissez **Next** (Suivant).
1. Pour **Select target(s)** (Sélectionner la ou les cibles), procédez comme suit :
1. Pour **Target types** (Types de cibles), choisissez **Service AWS**.
1. Pour **Select a target** (Sélectionner une cible), choisissez **Lambda Function** (Fonction Lambda).
1. Pour **Function** (Fonction), choisissez la fonction à laquelle vous souhaitez envoyer les événements.
1. (Facultatif) Pour **Configure version/alias** (Configurer la version/l'alias), saisissez les paramètres de version et d'alias pour la fonction Lambda cible.
1. (Facultatif) Pour **Additional settings** (Paramètres supplémentaires), saisissez tout paramètre supplémentaire approprié à votre application. Pour plus d'informations, consultez [la section Création de EventBridge règles Amazon qui réagissent aux événements](https://docs.aws.amazon.com//eventbridge/latest/userguide/eb-create-rule.html) dans le *guide de EventBridge l'utilisateur Amazon*.
1. Choisissez **Suivant**.
1. (Facultatif) Pour **Tags** (Identifications), vous pouvez également attribuer une ou plusieurs identifications à votre règle, puis choisir **Next** (Suivant).
1. Pour **Review and create** (Vérifier et créer), examinez les détails de la règle et modifiez-les si nécessaire. Puis choisissez **Create rule** (Créer une règle).