

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

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

 **Descrição** 

 O `AWSSupport-CalculateEBSPerformanceMetrics` runbook ajuda a diagnosticar problemas de desempenho do Amazon EBS calculando e publicando métricas de desempenho em um painel. CloudWatch O painel exibe a média estimada de IOPS e a taxa de transferência de um volume alvo do Amazon EBS ou de todos os volumes anexados à instância de destino do Amazon Elastic Compute Cloud (Amazon EC2). Para instâncias do Amazon EC2, ele também mostra a média de IOPS e a taxa de transferência da instância. O runbook gera o link para o CloudWatch painel recém-criado que exibe as métricas calculadas CloudWatch relevantes. O CloudWatch painel é criado em sua conta com o nome:`AWSSupport-<ResourceId>-EBS-Performance-<automation:EXECUTION_ID>`. 

 **Como funciona?** 

 O runbook executa as seguintes etapas: 
+ Garante que os carimbos de data/hora especificados sejam válidos.
+ Valida se o ID do recurso (volume do Amazon EBS ou instância do Amazon EC2) é válido.
+ Quando você fornece um Amazon EC2 como ResourceID, ele cria um CloudWatch painel com o total real dessa instância do IOPS/Throughput Amazon EC2 e um gráfico de média estimada de IOPs/taxa de transferência para todos os volumes do Amazon EBS anexados a uma instância do Amazon EC2.
+ Quando você fornece um volume do Amazon EBS como um ResourceID, ele cria CloudWatch um painel com gráfico de IOPS/Throughput média estimada para esse volume.
+ Depois que o CloudWatch painel for gerado, se a média estimada de IOPS ou a taxa de transferência média estimada for maior que a IOPS máxima ou a taxa de transferência máxima, respectivamente, o microbursting será possível para o volume ou volumes anexados a uma instância do Amazon EC2. 

**nota**  
 Para volumes com capacidade de intermitência (gp2, sc2 e st1), o máximo IOPS/throughput deve ser considerado até que você tenha um equilíbrio de intermitência. Depois que o equilíbrio de ruptura for completamente utilizado, ou seja, ele se tornar zero, considere as métricas básicas IOPS/throughput . 

**Importante**  
 A criação CloudWatch do painel pode resultar em cobranças extras em sua conta. Para obter mais informações, consulte o [guia de CloudWatch preços da Amazon](https://aws.amazon.com/cloudwatch/pricing). 

 [Executar esta automação (console)](https://console.aws.amazon.com/systems-manager/automation/execute/AWSSupport-CalculateEBSPerformanceMetrics) 

**Tipo de documento**

Automação

**Proprietário**

Amazon

**Plataformas**

Linux, macOS, Windows

**Parâmetros**

**Permissões obrigatórias do IAM**

O parâmetro `AutomationAssumeRole` requer as seguintes ações para usar o runbook com êxito.
+ `ec2:DescribeVolumes`
+ `ec2:DescribeInstances`
+ `ec2:DescribeInstanceTypes`
+ `cloudwatch:PutDashboard`

Política de amostra

------
#### [ 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": "*"
        }
    ]
}
```

------

 **Instruções** 

Siga estas etapas para configurar a automação:

1. Navegue até [https://console.aws.amazon.com/systems-manager/documents/AWSSupport-CalculateEBSPerformanceMetrics/description](https://console.aws.amazon.com/systems-manager/documents/AWSSupport-CalculateEBSPerformanceMetrics/description)em Systems Manager em Documentos.

1. Selecione Execute automation (Executar automação).

1. Para os parâmetros de entrada, insira o seguinte:
   + **AutomationAssumeRole (Opcional):**

     O Amazon Resource Name (ARN) da função AWS AWS Identity and Access Management (IAM) que permite que o Systems Manager Automation execute as ações em seu nome. Se nenhuma função for especificada, o Systems Manager Automation usa as permissões do usuário que inicia esse runbook.
   + **ResourceID (obrigatório):**

     O ID da instância do Amazon EC2 ou do volume do Amazon EBS.
   + **Hora de início (obrigatório):**

     A hora de início para visualizar os dados CloudWatch. A hora deve estar no formato `yyyy-mm-ddThh:mm:ss` e em UTC.
   + **Hora de término (obrigatório):**

     A hora de término para visualizar os dados CloudWatch. A hora deve estar no formato `yyyy-mm-ddThh:mm:ss` e em UTC.  
![\[Input parameters form for AWS Systems Manager Automation with fields for role, resource ID, and time range.\]](http://docs.aws.amazon.com/pt_br/systems-manager-automation-runbooks/latest/userguide/images/awssupport-calculate-ebs-performance-metrics_input_parameters.png)

1. Selecione Executar.

1. A automação é iniciada.

1. O bucket realiza as seguintes etapas:
   + **CheckResourceIdAndTimeStamps:**

     Verifica se a hora de término é maior que a hora de início em pelo menos um minuto e se o recurso fornecido existe.
   + **CreateCloudWatchDashboard:**

     Calcula o desempenho do Amazon EBS e exibe um gráfico com base no seu ID de recurso. Se você fornecer um ID de volume do Amazon EBS para o parâmetro Resource ID, esse runbook cria um CloudWatch painel com IOPS médio estimado e taxa de transferência média estimada para o volume do Amazon EBS. Se você fornecer um ID de instância do Amazon EC2 para o parâmetro Resource ID, esse runbook cria um CloudWatch painel com média total de IOPS e taxa de transferência total média para a instância do Amazon EC2 e com média estimada de IOPS e taxa de transferência média estimada para todos os volumes do Amazon EBS vinculados à instância do Amazon EC2.

1. Depois de concluído, revise a seção Saídas para obter os resultados detalhados da execução:  
![\[CloudWatch dashboard creation output showing a URL link and a message with instructions.\]](http://docs.aws.amazon.com/pt_br/systems-manager-automation-runbooks/latest/userguide/images/awssupport-calculate-ebs-performance-metrics_outputs.png)

   Exemplo de CloudWatch painel para ID de recurso como instância do Amazon EC2  
![\[CloudWatch dashboard showing EC2 instance metrics with graphs for IOPS, throughput, and volume performance.\]](http://docs.aws.amazon.com/pt_br/systems-manager-automation-runbooks/latest/userguide/images/awssupport-calculate-ebs-performance-metrics_dashboard_ec2_instance.png)

   Exemplo de CloudWatch painel para ID de recurso como ID de volume do Amazon EBS  
![\[CloudWatch dashboard showing EBS volume performance metrics with IOPS and throughput graphs.\]](http://docs.aws.amazon.com/pt_br/systems-manager-automation-runbooks/latest/userguide/images/awssupport-calculate-ebs-performance-metrics_dashboard_ebs_volume.png)

 **Referências** 

Automação do Systems Manager
+ [Execute esta automação (console)](https://console.aws.amazon.com/systems-manager/documents/AWSSupport-CalculateEBSPerformanceMetrics/description)
+ [Executar uma automação](https://docs.aws.amazon.com//systems-manager/latest/userguide/automation-working-executing.html)
+ [Configurar a automação](https://docs.aws.amazon.com//systems-manager/latest/userguide/automation-setup.html)
+ [Página inicial dos fluxos de trabalho de automação](https://aws.amazon.com/premiumsupport/technology/saw/)

AWS documentação de serviço
+ [Como posso identificar se meu volume do Amazon EBS está microestourando e evitar que isso aconteça?](https://repost.aws/knowledge-center/ebs-identify-micro-bursting)
+ [Como faço CloudWatch para visualizar as métricas agregadas de desempenho do Amazon EBS para uma instância do EC2?](https://repost.aws/knowledge-center/ebs-aggregate-cloudwatch-performance)