AWSSupport-CalculateEBSPerformanceMetrics - AWS Systems Manager Guide de référence du manuel d'automatisation

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

Description

Le AWSSupport-CalculateEBSPerformanceMetrics runbook permet de diagnostiquer les problèmes de performances d'Amazon EBS en calculant et en publiant des indicateurs de performance sur un CloudWatch tableau de bord. Le tableau de bord affiche l'estimation des IOPS et du débit moyens pour un volume Amazon EBS cible ou pour tous les volumes attachés à l'instance Amazon Elastic Compute Cloud (Amazon EC2) cible. Pour les EC2 instances Amazon, 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 sous le nom :AWSSupport-<ResourceId>-EBS-Performance-<automation:EXECUTION_ID>.

Comment fonctionne-t-il ?

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 EC2 instance Amazon) est valide.

  • Lorsque vous fournissez un Amazon EC2 en tant que ResourceID, il crée CloudWatch un tableau de bord avec un graphique du IOPS/Throughput for that Amazon EC2 instance and Estimated Average IOPS/Throughput total réel pour tous les volumes Amazon EBS attachés à une instance Amazon. EC2

  • Lorsque vous fournissez un volume Amazon EBS en tant que ResourceID, un tableau de bord est créé avec CloudWatch un graphique d'IOPS/débit moyen estimé pour ce volume.

  • Une fois le CloudWatch tableau de bord généré, si le débit moyen estimé par seconde ou le débit moyen estimé est supérieur au nombre maximal d'IOPS ou au débit maximal, le microbursting est possible pour le ou les volumes attachés à une instance Amazon. EC2

Note

Pour les volumes éclatables (gp2, sc2 et st1), les métriques maximales. IOPS/throughput should be consider, until you have burst balance. After burst balance is completely utilized i.e. it becomes zero, consider baseline IOPS/throughput

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 Amazon.

Exécuter cette automatisation (console)

Type de document

 Automatisation

Propriétaire

Amazon

Plateformes

Linux, macOS, 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


        {
            "Version": "2012-10-17",
            "Statement": [
                {
                    "Sid": "VisualEditor0",
                    "Effect": "Allow",
                    "Action": "cloudwatch:PutDashboard",
                    "Resource": "arn:aws:cloudwatch::Account-id: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à Systems Manager sous Documents.

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

  3. Pour les paramètres d'entrée, entrez ce qui suit :

    • AutomationAssumeRole (Facultatif) :

      Amazon Resource Name (ARN) du rôle AWS AWS Identity and Access Management (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 lance ce runbook.

    • ResourceID (obligatoire) :

      L'ID de l' EC2 instance Amazon 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.

    Input parameters form for AWS Systems Manager Automation with fields for role, resource ID, and time range.

  4. Sélectionnez Exécuter.

  5. L'automatisation démarre.

  6. 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 basé sur votre identifiant de ressource. Si vous fournissez un identifiant de volume Amazon EBS pour le paramètre Resource ID, ce runbook crée un CloudWatch tableau de bord avec des estimations d'IOPS moyennes et un débit moyen estimé pour le volume Amazon EBS. Si vous fournissez un ID d' EC2 instance Amazon pour le paramètre Resource ID, ce runbook crée un CloudWatch tableau de bord avec le total moyen d'IOPS et le débit total moyen pour l' EC2 instance Amazon, ainsi que les IOPS moyens estimés et le débit moyen estimé pour tous les volumes Amazon EBS attachés à l'instance Amazon. EC2

  7. Une fois terminé, consultez la section Sorties pour obtenir les résultats détaillés de l'exécution :

    CloudWatch dashboard creation output showing a URL link and a message with instructions.

    Exemple CloudWatch de tableau de bord pour l'ID de ressource en tant qu' EC2 instance Amazon

    CloudWatch dashboard showing EC2 instance metrics with graphs for IOPS, throughput, and volume performance.

    Exemple CloudWatch de tableau de bord pour l'ID de ressource en tant qu'identifiant de volume Amazon EBS

    CloudWatch dashboard showing EBS volume performance metrics with IOPS and throughput graphs.

Références

Systems Manager Automation

AWS documentation de service