

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.

# `AWSSupport-CalculateEBSPerformanceMetrics`
<a name="automation-calculate-ebs-performance-metrics"></a>

 **Description** 

 Le `AWSSupport-CalculateEBSPerformanceMetrics` runbook permet de diagnostiquer les problèmes de performances d'Amazon EBS en calculant et en publiant des mesures de performance sur un CloudWatch tableau de bord. Le tableau de bord affiche les IOPS et le débit moyens estimés pour un volume Amazon EBS cible ou pour tous les volumes attachés à l'instance Amazon Elastic Compute Cloud (Amazon EC2) cible. Pour les instances Amazon EC2, il indique également les IOPS et le débit moyens de l'instance. Le runbook affiche le lien vers le tableau de CloudWatch bord nouvellement créé qui affiche les CloudWatch mesures calculées pertinentes. Le CloudWatch tableau de bord est créé dans votre compte avec le nom :`AWSSupport-<ResourceId>-EBS-Performance-<automation:EXECUTION_ID>`. 

 **Fonctionnement** 

 Le runbook exécute les étapes suivantes : 
+ Garantit la validité des horodatages spécifiés.
+ Valide si l'ID de ressource (volume Amazon EBS ou instance Amazon EC2) est valide.
+ Lorsque vous fournissez un Amazon EC2 comme ResourceID, cela crée un CloudWatch tableau de bord avec le total réel IOPS/Throughput pour cette instance Amazon EC2 et un IOPS/Throughput graphique de la moyenne estimée pour tous les volumes Amazon EBS attachés à une instance Amazon EC2.
+ Lorsque vous indiquez un volume Amazon EBS en tant que ResourceID, un tableau de CloudWatch bord contenant un IOPS/Throughput graphique de la moyenne estimée pour ce volume est créé.
+ Une fois le CloudWatch tableau de bord généré, si les IOPS moyens estimés ou le débit moyen estimé sont supérieurs aux IOPS ou au débit maximum, respectivement, le microbursting est possible pour le ou les volumes attachés à une instance Amazon EC2. 

**Note**  
 Pour les volumes éclatables (gp2, sc2 et st1), le maximum IOPS/throughput doit être pris en compte, jusqu'à ce que vous obteniez un équilibre en rafale. Une fois que la balance de rafale est complètement utilisée, c'est-à-dire qu'elle devient nulle, considérez IOPS/throughput les mesures de base. 

**Important**  
 La création du CloudWatch tableau de bord peut entraîner des frais supplémentaires sur votre compte. Pour plus d'informations, consultez le guide de CloudWatch tarification d'[Amazon](https://aws.amazon.com/cloudwatch/pricing). 

 [Exécutez cette automatisation (console) ](https://console.aws.amazon.com/systems-manager/automation/execute/AWSSupport-CalculateEBSPerformanceMetrics) 

**Type de document **

 Automatisation

**Propriétaire**

Amazon

**Plateformes**

LinuxmacOS, Windows

**Paramètres**

**Autorisations IAM requises **

Le `AutomationAssumeRole` paramètre nécessite les actions suivantes pour utiliser correctement le runbook.
+ `ec2:DescribeVolumes`
+ `ec2:DescribeInstances`
+ `ec2:DescribeInstanceTypes`
+ `cloudwatch:PutDashboard`

Exemple de politique

------
#### [ JSON ]

****  

```
{
    "Version":"2012-10-17",		 	 	 
    "Statement": [
        {
            "Sid": "VisualEditor0",
            "Effect": "Allow",
            "Action": "cloudwatch:PutDashboard",
            "Resource": "arn:aws:cloudwatch::{{111122223333}}:dashboard/*-EBS-Performance-*"
        },
        {
            "Sid": "VisualEditor1",
            "Effect": "Allow",
            "Action": [
                "ec2:DescribeInstances",
                "ec2:DescribeVolumes",
                "ec2:DescribeInstanceTypes"
            ],
            "Resource": "*"
        }
    ]
}
```

------

 **Instructions** 

Pour configurer l'automatisation, procédez comme suit :

1. Accédez à [`AWSSupport-CalculateEBSPerformanceMetrics`](https://console.aws.amazon.com/systems-manager/documents/AWSSupport-CalculateEBSPerformanceMetrics/description) la section Documents dans Systems Manager.

1. Sélectionnez Execute automation (Exécuter l'automatisation).

1. Pour les paramètres d'entrée, entrez les informations suivantes :
   + **AutomationAssumeRole (Facultatif) : **

     Le nom de ressource Amazon (ARN) du rôle AWS Gestion des identités et des accès AWS (IAM) qui permet à Systems Manager Automation d'effectuer les actions en votre nom. Si aucun rôle n'est spécifié, Systems Manager Automation utilise les autorisations de l'utilisateur qui démarre ce runbook.
   + **ID de ressource (obligatoire) : **

     L'ID de l'instance Amazon EC2 ou du volume Amazon EBS.
   + **Heure de début (obligatoire) : **

     Heure de début de l'affichage des données CloudWatch. L'heure doit être au format `yyyy-mm-ddThh:mm:ss` et en UTC.
   + **Heure de fin (obligatoire) : **

     Heure de fin d'affichage des données CloudWatch. L'heure doit être au format `yyyy-mm-ddThh:mm:ss` et en UTC.  
![Section des paramètres d'entrée affichant les champs pour AutomationAssumeRole ResourceId, StartTime, et EndTime.](https://docs.aws.amazon.com/fr_fr/systems-manager-automation-runbooks/latest/userguide/images/awssupport-calculate-ebs-performance-metrics_input_parameters.png)

1. Sélectionnez Exécuter.

1. L'automatisation démarre.

1. Le document exécute les étapes suivantes :
   + **CheckResourceIdAndTimeStamps:**

     Vérifie si l'heure de fin est supérieure à l'heure de début d'au moins une minute et si la ressource fournie existe.
   + **CreateCloudWatchDashboard:**

     Calcule les performances d'Amazon EBS et affiche un graphique en fonction de votre ID de ressource. Si vous fournissez un ID de volume Amazon EBS pour le paramètre Resource ID, ce runbook crée un CloudWatch tableau de bord avec des IOPS moyennes estimées et un débit moyen estimé pour le volume Amazon EBS. Si vous fournissez un ID d'instance Amazon EC2 pour le paramètre Resource ID, ce runbook crée un CloudWatch tableau de bord avec le total moyen des IOPS et le débit total moyen pour l'instance Amazon EC2, ainsi que des IOPS moyens estimés et un débit moyen estimé pour tous les volumes Amazon EBS attachés à l'instance Amazon EC2.

1. Une fois terminé, consultez la section Sorties pour obtenir les résultats détaillés de l'exécution :  
![Section des sorties affichant l'URL du CloudWatch tableau de bord et le message de réussite pour la création du tableau de bord.](https://docs.aws.amazon.com/fr_fr/systems-manager-automation-runbooks/latest/userguide/images/awssupport-calculate-ebs-performance-metrics_outputs.png)

   Exemple CloudWatch de tableau de bord pour l'ID de ressource en tant qu'instance Amazon EC2  
![CloudWatch tableau de bord présentant les mesures de performance EBS pour l'instance EC2 avec des graphiques d'IOPS et de débit.](https://docs.aws.amazon.com/fr_fr/systems-manager-automation-runbooks/latest/userguide/images/awssupport-calculate-ebs-performance-metrics_dashboard_ec2_instance.png)

   Exemple CloudWatch de tableau de bord pour l'ID de ressource en tant qu'identifiant de volume Amazon EBS  
![CloudWatch tableau de bord affichant les mesures de débit et d'E/S par seconde du volume EBS avec des seuils de référence.](https://docs.aws.amazon.com/fr_fr/systems-manager-automation-runbooks/latest/userguide/images/awssupport-calculate-ebs-performance-metrics_dashboard_ebs_volume.png)

 **Références** 

Systems Manager Automation
+ [Exécutez cette automatisation (console) ](https://console.aws.amazon.com/systems-manager/documents/AWSSupport-CalculateEBSPerformanceMetrics/description)
+ [Exécutez une automatisation ](https://docs.aws.amazon.com/systems-manager/latest/userguide/automation-working-executing.html)
+ [Configuration d'une automatisation ](https://docs.aws.amazon.com/systems-manager/latest/userguide/automation-setup.html)
+ [Page d'accueil des flux de travail d'automatisation du support ](https://aws.amazon.com/premiumsupport/technology/saw/)

AWS documentation de service
+ [Comment puis-je déterminer si mon volume Amazon EBS est en micro-éclatement et éviter que cela ne se produise ? ](https://repost.aws/knowledge-center/ebs-identify-micro-bursting)
+ [Comment puis-je consulter les mesures CloudWatch de performance agrégées d'Amazon EBS pour une instance EC2 ? ](https://repost.aws/knowledge-center/ebs-aggregate-cloudwatch-performance)