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 métricas de desempenho de CPU, memória, disco e rede. Opcionalmente, a automação pode capturar um despejo de 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 [`EC2Rescue`](https://docs.aws.amazon.com/AWSEC2/latest/WindowsGuide/Windows-Server-EC2Rescue.html) ferramenta mais recente, se você permitir que esse runbook a instale. **Como funciona?** O runbook executa as seguintes etapas: + Verifica os pré-requisitos da 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 automação assumir 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 pelo. `EC2Rescue` **Importante** Para executar esse runbook, a instância Windows do Amazon EC2 deve ser gerenciada por. 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ó ](https://repost.aws/knowledge-center/systems-manager-ec2-instance-not-appear) gerenciado. Para executar esse runbook, a instância Windows do Amazon EC2 deve estar em execução nas versões Windows 81/Windows Server 2012 R2 (6.3) ou mais recentes com 4.0 ou superior. PowerShell Para obter mais informações, consulte Versão do sistema operacional [ Windows](https://learn.microsoft.com/en-us/windows/win32/sysinfo/operating-system-version). Para gerar 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 consome 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](https://docs.aws.amazon.com/AWSEC2/latest/WindowsGuide/Windows-Server-EC2Rescue.html). É 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. [Executar esta automação (console)](https://console.aws.amazon.com/systems-manager/automation/execute/AWSSupport-TroubleshootWindowsPerformance) **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 fazer o upload dos registros para o 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é o [`AWSSupport-TroubleshootWindowsPerformance`](https://console.aws.amazon.com/systems-manager/documents/AWSSupport-TroubleshootWindowsPerformance/description) Systems Manager em Documentos. 1. Selecione Execute automation (Executar automação). 1. Para os parâmetros de entrada, insira o seguinte: + **AutomationAssumeRole (Opcional): ** O nome de recurso da Amazon (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 do Amazon EC2 de destino 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 exige pelo menos 10 GB de espaço livre (mais de 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` e`15`, em que essa automação capturará registros enquanto o problema estiver presente. O padrão é `5`. + **LogUploadBucketName (Opcional): ** O bucket do Amazon S3 em 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 read/write permissões desnecessárias às partes que não precisam acessar os registros capturados. A instância Windows do Amazon EC2 deve ter acesso ao bucket do Amazon S3. + **InstallEC2RescueTool (Opcional): ** Defina como `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`. + **Confirmação (Obrigatório): ** Leia os detalhes completos das ações realizadas por esse runbook de automação e, se concordar, digite`Yes, I understand and acknowledge`. ![Formulário de parâmetros de entrada com campos para InstanceId AutomationAssumeRole, CaptureProcessDump, e outras opções de configuração.](https://docs.aws.amazon.com/pt_br/systems-manager-automation-runbooks/latest/userguide/images/awssupport-troubleshoot-windows-performance_input_parameters.png) 1. Selecione Executar. 1. A automação é iniciada. 1. O bucket realiza as seguintes etapas: + **`CheckConcurrency:`** Garante que haja somente uma execução desse runbook direcionada à instância. Se o runbook encontrar outra execução direcionada à mesma instância, ele retornará um erro e será encerrado. + **`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 81/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 as AWS ferramentas do PowerShell módulo estão disponíveis. Caso contrário, a automação termina. + **`BranchOnProcessDump:`** Ramificações com base em se você a 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 Performance Monitor e do Windows Performance Recorder. 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:`** Branches 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 usando`AWS-ConfigureAWSPackage`. + **`RunEC2RescueTool:`** Executa a `EC2Rescue` ferramenta no sistema operacional da instância para capturar todos os registros necessários. `EC2Rescue`captura somente os registros necessários para economizar espaço. + **`BranchOnIfS3BucketProvided:`** Ramificações com base na entrada do usuário `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 o SSE. + **`UploadLogResult:`** Faz o upload dos registros para o bucket Amazon S3 fornecido. Se a PowerShell versão for 5.0 ou superior, ela comprime os registros em um arquivo ZIP e os carrega. Ele exclui o arquivo ZIP após a conclusão do upload. Se a PowerShell versão for inferior a 5.0, ela carregará os arquivos diretamente em uma pasta. + **`CleanUpLogsOnFailure:`** Limpa todos os registros gerados pela `CapturePerformanceLogs` etapa quando ela falha. A `CleanUpLogsOnFailure` etapa pode falhar ou expirar se o SSM Agent não estiver funcionando corretamente ou se o sistema Windows não responder. 1. Depois de concluído, revise a seção Saídas para ver os resultados detalhados da execução: Execução em que a instância de destino tem todos os pré-requisitos necessários. ![Seção de saídas mostrando a captura bem-sucedida do log de desempenho e os resultados da execução da ferramenta EC2Rescue.](https://docs.aws.amazon.com/pt_br/systems-manager-automation-runbooks/latest/userguide/images/awssupport-troubleshoot-windows-performance_outputs_all_prerequisites_met.png) 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. ![Status de execução mostrando 2 etapas: CheckConcurrency bem-sucedida, AssertInstanceIsWindows falhada.](https://docs.aws.amazon.com/pt_br/systems-manager-automation-runbooks/latest/userguide/images/awssupport-troubleshoot-windows-performance_outputs_failed_linux_instance.png) Os detalhes da falha da etapa`AssertInstanceIsWindows`. ![Mensagem de falha mostrando o valor do Linux retornado em vez do valor esperado do Windows.](https://docs.aws.amazon.com/pt_br/systems-manager-automation-runbooks/latest/userguide/images/awssupport-troubleshoot-windows-performance_outputs_assert_windows_fail.png) **Referências** Automação do Systems Manager + [Execute esta automação (console)](https://console.aws.amazon.com/systems-manager/documents/AWSSupport-TroubleshootWindowsPerformance/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/)