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-TroubleshootPatchManagerLinux` **Descrição** O `AWSSupport-TroubleshootPatchManagerLinux` runbook soluciona problemas comuns que podem causar uma falha de patch em nós gerenciados baseados em Linux usando o Patch Manager, uma ferramenta do. AWS Systems Manager O objetivo principal desse runbook é identificar a causa raiz da falha do comando de patch e sugerir um plano de correção. **Como funciona?** O `AWSSupport-TroubleshootPatchManagerLinux` runbook considera o ID/Command ID de duas instâncias fornecido por você para a solução de problemas. Se nenhum ID de comando for fornecido, ele selecionará o último comando de patch com falha nos últimos 30 dias na instância fornecida. Depois de verificar o status do comando, o cumprimento dos pré-requisitos e a distribuição do sistema operacional, o runbook baixa e executa um pacote de análise de log. A saída inclui a causa raiz do problema, bem como a ação necessária para corrigir o problema. **Tipo de documento** Automação **Proprietário** Amazon **Plataformas** + Amazon Linux 2 e AL2023 + Red Hat Enterprise Linux 8.X e 9.X + Centos 8.X e 9.X + USO 15.X **Parâmetros** **Permissões obrigatórias do IAM** O parâmetro `AutomationAssumeRole` requer as seguintes ações para usar o runbook com êxito. + `ssm:SendCommand` + `ssm:DescribeDocument` + `ssm:GetCommandInvocation` + `ssm:ListCommands` + `ssm:DescribeInstanceInformation` + `ssm:ListCommandInvocations` + `ssm:GetDocument` + `ssm:DescribeAutomationExecutions` + `ssm:GetAutomationExecution` **Instruções** Siga estas etapas para configurar a automação: 1. Navegue até o [https://console.aws.amazon.com/systems-manager/documents/AWSSupport-TroubleshootPatchManagerLinux/description](https://console.aws.amazon.com/systems-manager/documents/AWSSupport-TroubleshootPatchManagerLinux/description)no AWS Systems Manager console. 1. Selecione Execute automation (Executar automação). 1. Para os parâmetros de entrada, insira o seguinte: + **InstanceId (Obrigatório):** Use o seletor de instância interativo para escolher o ID do nó gerenciado SSM baseado em Linux (Amazon Elastic Compute Cloud (Amazon EC2) ou servidor Hybrid Activated) no qual o comando patch falhou, ou insira manualmente o ID da instância gerenciada do SSM. + **AutomationAssumeRole (Opcional):** Insira o ARN da função do IAM que permite que a Automation execute ações em seu nome. Se uma função não for especificada, a automação usa as permissões do usuário que inicia esse runbook. + **RunCommandId (Opcional):** Insira o ID do comando Failed Run do `AWS-RunPatchBaseline` documento. Se você não fornecer uma ID de comando, o runbook procurará o comando de patch com falha mais recente nos últimos 30 dias na instância selecionada. ![\[Input parameters form for EC2 Instance Connect troubleshooting with instance ID and optional fields.\]](http://docs.aws.amazon.com/pt_br/systems-manager-automation-runbooks/latest/userguide/images/awssupport-troubleshoot-patch-manager-linux_input_parameters.png) 1. Selecione Executar. 1. A automação é iniciada. 1. O bucket realiza as seguintes etapas: + **CheckConcurrency:** Garante que haja apenas uma execução desse runbook direcionada à mesma instância. Se o runbook encontrar outra execução em andamento visando a mesma instância, ele retornará um erro e terminará. + **ValidateCommandIdentificação:** Valida se a ID do comando fornecida, como parâmetro de entrada, foi executada para o documento `AWS-RunPatchBaseline` SSM. Se nenhum ID de comando for fornecido, o runbook considerará a última falha de execução dos `AWS-RunPatchBaseline` últimos 30 dias na instância selecionada. + **BranchOnCommandStatus:** Confirma que o status do comando fornecido falhou. Caso contrário, o runbook encerra a execução e gera um relatório informando que o comando fornecido foi executado com sucesso. + **VerifyPrerequistes:** Confirma que os pré-requisitos mencionados acima foram cumpridos. + **GetPlatformDetails:** Recupera a distribuição e a versão do sistema operacional (OS). + **GetDownloadURL:** Recupera a URL de download do pacote PatchManager Log Analyzer. + **EvaluatePatchManagerLogs:** Faz o download e executa o pacote python do PatchManager Log Analyzer na instância para avaliar o arquivo de log. + **GenerateReport:** Gera um relatório final da execução do runbook que inclui o problema identificado e a solução sugerida. 1. Depois de concluído, revise a seção Saídas para obter os resultados detalhados da execução: ![\[Troubleshooting results showing an error downloading payload and suggested solutions.\]](http://docs.aws.amazon.com/pt_br/systems-manager-automation-runbooks/latest/userguide/images/awssupport-troubleshoot-patch-manager-linux_outputs.png) **Referências** Automação do Systems Manager + [Execute esta automação (console)](https://console.aws.amazon.com/systems-manager/documents/AWSSupport-TroubleshootPatchManagerLinux/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/)