View a markdown version of this page

AWSSupport-CalculateEBSPerformanceMetrics - AWS Systems Manager Referência do Automation Runbook

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

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.

Executar esta automação (console)

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é AWSSupport-CalculateEBSPerformanceMetricsem Systems Manager em Documentos.

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

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

  4. Selecione Executar.

  5. A automação é iniciada.

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

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

    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.

    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.

Referências

Automação do Systems Manager

AWS documentação de serviço