AWSSupport-TroubleshootWindowsPerformance - AWS Systems Manager Referência do runbook de automação

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

Descrição

O runbook AWSSupport-TroubleshootWindowsPerformance ajuda a solucionar problemas contínuos de desempenho na instância Windows do Amazon Elastic Compute Cloud (Amazon EC2). O runbook captura registros da instância de destino e analisa as métricas de desempenho de CPU, memória, disco e rede. Opcionalmente, a automação pode capturar um despejo do processo para ajudá-lo a determinar a causa potencial da degradação do desempenho. A automação também captura os registros de eventos e do sistema usando a EC2Rescueferramenta mais recente, se você permitir que esse runbook a instale.

Como funciona?

O runbook executa as seguintes etapas:

  • Verifica os pré-requisitos na instância do Amazon EC2.

  • Gera registros de desempenho no disco raiz da instância Windows do Amazon EC2

  • Armazena os registros capturados na pasta C:\ProgramData\Amazon\SSM\TroubleshootWindowsPerformance

  • Se um bucket do Amazon Simple Storage Service (Amazon S3) for fornecido e a função de assumir a automação tiver as permissões necessárias, os logs capturados serão enviados para o bucket do Amazon S3.

  • Instala a EC2Rescue ferramenta mais recente na instância Windows do Amazon EC2 para capturar eventos e registros do sistema se você optar por instalá-la, mas ela não analisa o despejo do processo e os registros capturados por. EC2Rescue

Importante
  • Para executar esse runbook, a instância Windows do Amazon EC2 deve ser gerenciada pelo. AWS Systems Manager Para obter mais informações, consulte Por que minha instância do Amazon EC2 não está sendo exibida como um nó gerenciado.

  • Para executar esse runbook, a instância Windows do Amazon EC2 deve estar em execução nas versões Windows 8.1/Windows Server 2012 R2 (6.3) ou mais recentes PowerShell com 4.0 ou superior. Para obter mais informações, consulte a versão do sistema operacional Windows.

  • Para a geração de registros de desempenho, é necessário pelo menos 10 GB de espaço livre no dispositivo raiz. Se o disco raiz for maior que 100 GB, o espaço livre deverá ser maior que 10% do tamanho do disco. Se você despejar um processo durante a execução, o espaço livre deverá ser maior que 10 GB mais o tamanho total da memória consumida pelo processo quando o processo consumir mais de 10 GB de memória.

  • Os registros gerados no dispositivo raiz não são excluídos automaticamente.

  • O runbook não desinstala a EC2Rescue ferramenta. Para obter mais informações, consulte Usar EC2Rescue para Windows Server.

  • É uma prática recomendada executar essa automação durante um impacto no desempenho. Você também pode executá-lo periodicamente usando uma associação AWS Systems Manager do State Manager ou agendando janelas de AWS Systems Manager manutenção.

Execute esta automação (console)

Tipo de documento

Automação

Proprietário

Amazon

Plataformas

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:DescribeInstances

  • ssm:DescribeAutomationExecutions

  • ssm:DescribeInstanceInformation

  • ssm:GetAutomationExecution

  • ssm:ListCommands

  • ssm:ListCommandInvocations

  • ssm:SendCommand

  • s3:ListBucket

  • s3:GetEncryptionConfiguration

  • s3:GetBucketPublicAccessBlock

  • s3:GetBucketPolicyStatus

  • s3:PutObject

  • s3:GetBucketAcl

  • s3:GetAccountPublicAccessBlock

(Opcional) A função do IAM anexada ao perfil da instância ou ao usuário do IAM configurado na instância exige as seguintes ações para carregar os registros no bucket do Amazon S3 especificado para o parâmetro: LogUploadBucketName

  • s3:PutObject

  • s3:GetObject

  • s3:ListBucket

Instruções

Siga estas etapas para configurar a automação:

  1. Navegue até AWSSupport-TroubleshootWindowsPerformanceem 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.

    • InstanceId (Obrigatório):

      O ID da instância Windows de destino do Amazon EC2 em que você deseja executar a automação. A instância deve ser gerenciada pelo Systems Manager para executar a automação.

    • CaptureProcessDump (Opcional):

      O tipo de despejo do processo a ser capturado. A automação pode capturar um despejo de processo para o processo que está potencialmente causando o impacto no desempenho no início da automação. O volume raiz da instância requer pelo menos 10 GB de espaço livre (maior que 10% do tamanho do disco quando o tamanho do volume raiz é maior que 100 GB e 10 GB mais o tamanho total da memória consumida pelo processo quando o processo consome mais de 10 GB de memória).

    • LogCaptureDuration (Opcional):

      O número de minutos, entre 1 e15, em que essa automação capturará os registros enquanto o problema estiver presente. O padrão é5.

    • LogUploadBucketName (Opcional):

      O bucket do Amazon S3 na sua conta em que você deseja fazer o upload dos registros. O bucket deve ser configurado com criptografia do lado do servidor (SSE), e a política do bucket não deve conceder permissões desnecessárias de leitura/gravação a partes que não precisam acessar os registros capturados. A instância Windows do Amazon EC2 deve ter acesso ao bucket do Amazon S3.

    • Instale o EC2 RescueTool (opcional):

      Defina Yes para permitir que o runbook instale a versão mais recente da EC2Rescue ferramenta para capturar os registros de eventos e do sistema do Windows. O padrão éNo.

    • Reconhecimento (obrigatório):

      Leia os detalhes completos das ações realizadas por esse runbook de automação e, se concordar, digiteYes, I understand and acknowledge.

    Input parameters form for troubleshooting Amazon EC2 Windows instance performance issues.
  4. Selecione Executar.

  5. A automação é iniciada.

  6. O bucket realiza as seguintes etapas:

    • CheckConcurrency:

      Garante que haja apenas uma execução desse runbook direcionada à instância. Se o runbook encontrar outra execução direcionada à mesma instância, ele retornará um erro e terminará.

    • AssertInstanceIsWindows:

      Afirma que a instância do Amazon EC2 está sendo executada no sistema operacional Windows. Caso contrário, a automação termina.

    • AssertInstanceIsManagedInstance:

      Afirma que a instância do Amazon EC2 é gerenciada por. AWS Systems Manager Caso contrário, a automação termina.

    • VerifyPrerequisites:

      Verifica a PowerShell versão no sistema operacional da instância e garante que a instância possa ser conectada por meio do Systems Manager para executar PowerShell comandos. Essa automação oferece suporte à PowerShell versão 4.0 e superior em execução nas versões Windows 8.1/Server 2012 R2 (6.3) ou mais recentes. Se a versão for mais antiga, a automação falhará. Quando você opta por fazer o upload de registros para o bucket do Amazon S3, essa automação verifica se o PowerShell módulo AWS Tools for está disponível. Caso contrário, a automação termina.

    • BranchOnProcessDump:

      Ramifica com base em se você o configurou para capturar o despejo de processos que afetaram o desempenho.

    • CaptureProcessDump:

      Verifica se a instância tem espaço suficiente para executar essa automação (quando você escolhe CPU/Memória mais alta).

    • CapturePerformanceLogs:

      Verifica o espaço em disco novamente e executa o PowerShell script na instância para criar contadores perfmon e iniciar o registro do Monitor de Desempenho e do Gravador de Desempenho do Windows. O script é interrompido depois que o definido LogCaptureDuration é atendido.

    • SummarizePerformanceLogs:

      Resume o relatório XML gerado na etapa anterior,CapturePerformanceLogs, para encontrar o processo responsável que consome mais WorkingSet 64 (memória) e% de tempo de processador (CPU) mostrados como saída na automação. Ele gera informações semelhantes para uso de Interface de Rede LogicalDisk, Memória, TCPv4, IPv4 e UDPv4 e as salva na pasta de saída. analysis_output.log

    • BranchOnInstallEC2Rescue:

      Ramifica se você configurá-lo para instalar a EC2Rescue ferramenta mais recente na instância do Amazon EC2.

    • InstallEC2RescueTool:

      Instala a EC2Rescue ferramenta no sistema operacional da instância para capturar EC2Rescue registros usandoAWS-ConfigureAWSPackage.

    • RunEC2RescueTool:

      Executa a EC2Rescue ferramenta no sistema operacional da instância para capturar todos os registros necessários. EC2Rescuecaptura somente os registros necessários para economizar espaço.

    • BranchOnIfS3BucketProvided:

      Ramifica com base na entrada do usuário de LogUploadBucketName para ver se há um nome de bucket disponível para fazer upload de registros.

    • GetS3BucketPublicStatus:

      Determina se um bucket do Amazon S3 é fornecido e, em caso afirmativo, confirma que o bucket do Amazon S3 não é público e está configurado com SSE.

    • UploadLogResult:

      Carrega os registros no bucket Amazon S3 fornecido. Se a PowerShell versão for 5.0 ou superior, ela compactará os registros em um arquivo ZIP e os carregará. Ele exclui o arquivo ZIP após a conclusão do upload. Se a PowerShell versão estiver abaixo de 5.0, ele carregará os arquivos diretamente para uma pasta.

    • CleanUpLogsOnFailure:

      Limpa todos os registros gerados pela CapturePerformanceLogs etapa quando ela falha. A CleanUpLogsOnFailure etapa pode falhar ou atingir o tempo limite se o SSM Agent não estiver funcionando corretamente ou se o sistema Windows não estiver respondendo.

  7. Depois de concluído, revise a seção Saídas para obter os resultados detalhados da execução:

    Execução em que a instância de destino tem todos os pré-requisitos necessários.

    Output logs showing performance capture process, EC2Rescue completion, and top CPU/memory usage processes.

    Execução em que a instância de destino está na plataforma Linux e a execução falhou. Você selecionaria o ID da etapa para ver os detalhes da falha.

    Execution status showing failed overall status with 2 executed steps, 1 succeeded and 1 failed.

    Os detalhes da falha da etapaAssertInstanceIsWindows.

    Failure details showing verification error for Linux property value instead of Windows.

Referências

Automação do Systems Manager