

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# `AWSSupport-CollectSAPHANALogs`
<a name="automation-awssupport-collectsaphanalogs"></a>

 **Descripción** 

El `AWSSupport-CollectSAPHANALogs` manual recopila los registros del sistema de SAP HANA en una instancia de Amazon Elastic Compute Cloud (Amazon EC2) que forma parte de un SAP en el momento de la implementación. AWS La instancia de Amazon EC2 debe gestionarla AWS Systems Manager (Systems Manager). El runbook comprueba los paquetes necesarios y los instala si faltan, ejecuta la herramienta de recopilación de registros adecuada para el sistema operativo detectado y, opcionalmente, carga los registros recopilados en un depósito de Amazon Simple Storage Service (Amazon S3).

**importante**  
Este runbook requiere al menos 200 MB de espacio disponible en disco en la partición. `/var/log` Al ejecutar este runbook, es posible que se instalen paquetes adicionales en la instancia Amazon EC2 de destino. Debe reconocerlo configurando el `Acknowledgement` parámetro en. `Yes` El almacenamiento de registros en Amazon S3 conlleva cargos estándar de almacenamiento y solicitud de Amazon S3.

 **Sistemas operativos compatibles** 
+ Red Hat Enterprise Linux8.4 y versiones posteriores
+ SUSE Linux Enterprise Server SP5 12
+ SUSE Linux Enterprise Server15 SP3 y versiones posteriores

 **Paquetes instalados si faltan** 

SUSE Linux Enterprise Server:
+ `supportutils`
+ `yast2-support`
+ `supportutils-plugin-suse-public-cloud`
+ `supportutils-plugin-ha-sap`
+ `crmsh`
+ `unzip`
+ `curl`
+ `aws-cli`(opcional, se instala si `InstallAWSCLI` está configurado en`Yes`)

Red Hat Enterprise Linux:
+ `sos`
+ `crm_report`
+ `unzip`
+ `curl`
+ `aws-cli`(opcional, se instala si `InstallAWSCLI` está configurado en`Yes`)

[Ejecuta esta automatización (consola)](https://console.aws.amazon.com/systems-manager/automation/execute/AWSSupport-CollectSAPHANALogs)

**Tipo de documento**

Automatización

**Propietario**

Amazon

**Plataformas**

Linux

**Parámetros**
+ AutomationAssumeRole

  Tipo: cadena

  Descripción: (opcional) el Nombre de recurso de Amazon (ARN) del rol de AWS Identity and Access Management (IAM) que permite a Systems Manager Automation realizar las acciones en su nombre. Si no se especifica ningún rol, Systems Manager Automation utiliza los permisos del usuario que comienza este manual de procedimientos.
+ InstanceID

  Escriba AWS::EC2::Instance: :Id

  Descripción: (obligatorio) El ID de la instancia de Amazon EC2 que ejecuta la carga de trabajo de SAP desde la que se deben recopilar los registros.
+ Reconocimiento

  Tipo: cadena

  Valores válidos: Yes

  Descripción: (Obligatorio) Reconozco que este runbook puede instalar paquetes adicionales en la instancia Amazon EC2 de destino para la recopilación de registros.
+ S3 LogDestination

  Tipo: AWS::S3::Bucket :Nombre

  Descripción: (opcional) El nombre del depósito de Amazon S3 en el que se cargan los registros. El bucket no debe ser público y debe pertenecer a la misma AWS cuenta. Si no se proporciona, los registros se almacenan en el almacenamiento local de la instancia.
+ S3Prefix

  Tipo: cadena

  Predeterminado: AWSSupport-CollectSAPHANALogs

  Patrón permitido: `^$|^[a-zA-Z0-9][-./a-zA-Z0-9]{0,255}$`

  Descripción: (opcional) El prefijo del bucket de Amazon S3 donde se almacenan los registros. Si no se proporciona, el valor predeterminado es. `AWSSupport-CollectSAPHANALogs`
+ Instalar AWSCLI

  Tipo: cadena

  Valores válidos: Yes \$1 No

  Valor predeterminado: No

  Descripción: (opcional) Si se debe instalar la AWS CLI en la instancia. Si`Yes`, el runbook instala la AWS CLI si aún no está presente.

**Permisos de IAM necesarios**

El parámetro `AutomationAssumeRole` requiere las siguientes acciones para utilizar el manual de procedimientos correctamente.
+ `ssm:DescribeInstanceInformation`
+ `ssm:SendCommand`
+ `ssm:GetCommandInvocation`
+ `s3:GetBucketPublicAccessBlock`
+ `s3:GetBucketAcl`
+ `s3:GetBucketLocation`
+ `s3:GetBucketOwnershipControls`
+ `s3:GetEncryptionConfiguration`
+ `s3:PutObject`

 **Pasos de documentos** 

1. `AssertInstanceIsSSMManaged`- Verifica que la instancia Amazon EC2 de destino esté gestionada por Systems Manager y tenga un `PingStatus` de. `Online` El runbook se cancela si la instancia no está administrada.

1. `GetInstanceInformation`- Recupera información sobre la instancia Amazon EC2 especificada, incluido el nombre de la plataforma, que se utiliza para determinar el método de recopilación de registros adecuado.

1. `CollectLogs`- Ejecuta un script de shell en la instancia para recopilar los registros. Por SUSE Linux Enterprise Server ejemplo, el script usa`supportconfig`. Por Red Hat Enterprise Linux ejemplo, usa`sos report`. En el caso de los clústeres de alta disponibilidad, el script también recopila registros de alta disponibilidad adicionales de los últimos 7 días mediante el `crm report` comando. Si faltan, se instalan los paquetes necesarios.

1. `BranchOnS3BucketProvided`- Ramifica la ejecución en función de si se ha incluido un bucket de Amazon S3`S3LogDestination`. Si no se ha proporcionado ningún bucket, el manual pasa a. `GenerateReport` De lo contrario, pasa a. `CheckS3BucketPublicStatus`

1. `CheckS3BucketPublicStatus`- Comprueba si el bucket de Amazon S3 especificado `S3LogDestination` está configurado con cifrado del lado del servidor (SSE) y si permite permisos de acceso de lectura o escritura públicos o anónimos. También verifica que el propietario real del bucket sea el mismo que el propietario esperado del bucket. Si este paso no se realiza correctamente, el runbook seguirá `GenerateReport` sin cargarse.

1. `UploadLogsToS3`- Carga los registros recopilados en el bucket de Amazon S3 especificado. Si `InstallAWSCLI` está configurado en `Yes` y la AWS CLI no está instalada, el script instala la AWS CLI antes de cargarla.

1. `GenerateReport`- Genera un informe del proceso de recopilación de registros. Si se proporcionó un bucket de Amazon S3, este incluye el nombre y el prefijo del bucket de Amazon S3 donde se cargaron los registros. De lo contrario, indica que los registros se almacenaron localmente en la instancia. También indica por qué fallaron los pasos anteriores.

 **Salidas** 

`GenerateReport.Summary`- Un resumen del resultado de la recopilación de registros.

`GenerateReport.LogLocation`- La ubicación en la que se almacenaron los registros, ya sea una ruta local de la instancia o un URI de Amazon S3.

`GenerateReport.Status`- El estado general de la ejecución de la recopilación de registros.

 **Instrucciones** 

Siga estos pasos para configurar la automatización:

1. Navegue hasta [https://console.aws.amazon.com/systems-manager/documents/AWSSupport-CollectSAPHANALogs/description](https://console.aws.amazon.com/systems-manager/documents/AWSSupport-CollectSAPHANALogs/description)Systems Manager en Documentos.

1. Elija Execute automation (Ejecutar automatización).

1. Para los parámetros de entrada, introduzca lo siguiente:
   + **AutomationAssumeRole (Opcional):**

     El ARN de la función de IAM que permite a Systems Manager Automation realizar acciones en su nombre. Si no se especifica ningún rol, Systems Manager Automation utiliza los permisos del usuario que inicia este runbook.
   + **InstanceID (obligatorio):**

     El ID de la instancia de Amazon EC2 que ejecuta la carga de trabajo de SAP.
   + **Reconocimiento (obligatorio):**

     Introduzca `Yes` para confirmar que el runbook puede instalar paquetes adicionales en la instancia Amazon EC2 de destino.
   + **S3 LogDestination (opcional):**

     El nombre del bucket de Amazon S3 en el que se van a cargar los registros. Si no se proporcionan, los registros se almacenan localmente en la instancia.
   + **Prefijo S3 (opcional):**

     El prefijo de bucket de Amazon S3 para los registros almacenados. El valor predeterminado es `AWSSupport-CollectSAPHANALogs`.
   + **Instalar AWSCLI (opcional):**

     Seleccione esta opción `Yes` para instalar automáticamente la AWS CLI si no está presente en la instancia. El valor predeterminado es `No`.

1. Seleccione Ejecutar.

1. Se inicia la automatización.

1. Este documento realiza los siguientes pasos:
   + **`AssertInstanceIsSSMManaged`**

     Verifica que la instancia Amazon EC2 de destino esté gestionada por Systems Manager y tenga un `PingStatus` de. `Online`
   + **`GetInstanceInformation`**

     Recupera información sobre la instancia de Amazon EC2 especificada, incluido el nombre de la plataforma.
   + **`CollectLogs`**

     Ejecuta un script de shell para recopilar registros utilizando `supportconfig` for SLES o `sos report` for. RHEL En el caso de los clústeres de alta disponibilidad, también recopila los registros de alta disponibilidad de los últimos 7 días de uso`crm report`.
   + **`BranchOnS3BucketProvided`**

     Salta a `GenerateReport` si no se ha proporcionado ningún bucket de Amazon S3; de lo contrario, pasa a`CheckS3BucketPublicStatus`.
   + **`CheckS3BucketPublicStatus`**

     Verifica que el bucket de Amazon S3 tenga SSE habilitado, no permita el acceso público y sea propiedad de la misma AWS cuenta.
   + **`UploadLogsToS3`**

     Carga los registros recopilados en el bucket de Amazon S3 especificado. Instala la AWS CLI si `InstallAWSCLI` está `Yes` y no está ya presente.
   + **`GenerateReport`**

     Genera un resumen del resultado de la recopilación de registros, que incluye la ubicación del registro y cualquier error en los pasos.

1. Una vez finalizada, revise la sección de resultados para ver los resultados detallados de la ejecución.

 **Referencias** 

Automatización de Systems Manager
+ [Ejecuta esta automatización (consola)](https://console.aws.amazon.com/systems-manager/documents/AWSSupport-CollectSAPHANALogs/description)
+ [Ejecución de una automatización](https://docs.aws.amazon.com//systems-manager/latest/userguide/automation-working-executing.html)
+ [Configuración de Automatización](https://docs.aws.amazon.com//systems-manager/latest/userguide/automation-setup.html)
+ [Página de inicio de Support Automation Workflows](https://aws.amazon.com/premiumsupport/technology/saw/)