View a markdown version of this page

AWSSupport-CollectAmazonConnectContactFlowLog - AWS Systems Manager Referencia del manual de procedimientos de Automatización

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

Descripción

El manual de AWSSupport-CollectAmazonConnectContactFlowLog automatización se usa para recopilar los registros del flujo de contactos de Connect Customer para un ID de contacto específico. Al proporcionar tu ID de instancia de cliente de Connect y tu ID de contacto, el runbook busca en los registros de flujo de contactos del contacto del grupo de CloudWatch registros de Amazon y los carga en el bucket de Amazon Simple Storage Service (Amazon S3) que se especifica en el parámetro de solicitud. El libro de ejecución genera un resultado que proporciona la URL de la consola Amazon S3 y el comando AWS CLI para que pueda descargar los registros.

¿Cómo funciona?

El manual de AWSSupport-CollectAmazonConnectContactFlowLog automatización ayuda a recopilar los registros del flujo de contactos de Connect Customer para un identificador de contacto específico almacenado en el grupo de CloudWatch registros configurado y los carga en un bucket de Amazon S3 específico. Para garantizar la seguridad de los registros recopilados a partir del flujo de contactos del cliente de Connect, la automatización evalúa la configuración del bucket de Amazon S3 para determinar si el bucket concede permisos públicos read o de write acceso y si es propiedad de la AWS cuenta especificada en el parámetro. S3BucketOwnerAccountId Si su bucket de Amazon S3 utiliza el cifrado del lado del servidor con AWS Key Management Service claves (SSE-KMS), asegúrese de que el usuario o el rol AWS Identity and Access Management (IAM) que ejecuta esta automatización tenga kms:GenerateDataKey los permisos sobre la clave. AWS KMS Para obtener más información sobre los registros generados por tu instancia de Connect Customer, consulta los registros de flujo almacenados en un grupo de registros de Amazon CloudWatch .

importante

Las consultas de CloudWatch Logs Insights conllevan cargos en función de la cantidad de datos consultados. A los clientes de capa gratuita solo se les cobra por el uso que superar las cuotas de servicio. Para obtener más información, consulte Precios de Amazon CloudWatch.

Ejecuta esta automatización (consola)

Tipo de documento

Automatización

Propietario

Amazon

Plataformas

Linux, macOS, Windows

Parámetros

Permisos de IAM necesarios

El parámetro AutomationAssumeRole requiere las siguientes acciones para utilizar el manual de procedimientos correctamente.


        {
            "Statement": [
                {
                    "Action": [
                        "s3:GetBucketPublicAccessBlock",
                        "s3:GetBucketPolicyStatus",
                        "s3:GetBucketAcl",
                        "s3:GetObject",
                        "s3:GetObjectAttributes",
                        "s3:PutObject",
                        "s3:PutObjectAcl"
                    ],
                    "Resource": [
                    "arn:aws:s3:::amzn-s3-demo-bucket/*",
                    "arn:aws:s3:::amzn-s3-demo-bucket"
                    ],
                    "Effect": "Allow"
                },
                {
                    "Action": [
                        "connect:DescribeInstance",
                        "connect:DescribeContact",
                        "ds:DescribeDirectories"
                    ],
                    "Resource": "*",
                    "Effect": "Allow"
                },
                {
                    "Action": [
                        "logs:StartQuery",
                        "logs:GetQueryResults"

                    "Resource": "*",
                    "Effect": "Allow"
                }
            ]
        }

Instrucciones

Siga estos pasos para configurar la automatización:

  1. Navegue hasta el Administrador AWSSupport-CollectAmazonConnectContactFlowLog de sistemas, en la sección Documentos.

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

  3. Para los parámetros de entrada, introduzca lo siguiente:

    • AutomationAssumeRole (Opcional):

      El nombre de recurso de Amazon (ARN) del rol 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 inicia este libro de ejecución.

    • ConnectInstanceId (Obligatorio):

      El ID de su instancia de cliente de Connect.

    • ContactId (Obligatorio):

      El ID del contacto para el que quieres recopilar el registro del flujo de contactos.

    • S3BucketName (Obligatorio):

      El nombre del bucket de Amazon S3 de su cuenta a la que desea cargar el registro del flujo de contactos. Asegúrese de que la política de buzones no conceda read/write permisos innecesarios a las partes que no necesitan acceder a los registros recopilados.

    • S3ObjectPrefix (Opcional):

      La ruta del objeto de Amazon S3 en el bucket de Amazon S3 para cargar un registro de flujo de contactos. Por ejemplo, si lo especificaCollectedLogs, el registro se cargará comos3://your-s3-bucket/CollectedLogs/ContactFlowLog_[ContactId][AWSAccountId].gz. Si no especifica este parámetro, se utiliza el ID de ejecución de Systems Manager Automation, por ejemplo:s3://your-s3-bucket/[automation:EXECUTION_ID]/ContactFlowLog[ContactId]_[AWSAccountId].gz. Nota: si especifica un valor para esta automatización S3ObjectPrefix y la ejecuta con el mismo [ContactId], se sobrescribirá el registro de flujo de contactos.

    • S3BucketOwnerAccount (Opcional):

      El número de AWS cuenta propietario del bucket de Amazon S3 en el que desea cargar el registro del flujo de contactos. Si no especifica este parámetro, el runbook usa el ID de AWS cuenta del usuario o rol en el que se ejecuta la automatización.

    • S3BucketOwnerRoleArn (Opcional):

      El ARN del rol de IAM con permisos para obtener el bucket y la cuenta de Amazon S3, bloquear la configuración de acceso público, configurar el cifrado del bucket, las ACL del bucket, el estado de la política del bucket y cargar objetos al bucket. Si no se especifica este parámetro, el libro de ejecución utiliza el usuario AutomationAssumeRole (si se especifica) o el usuario que inicia este libro de ejecución (si AutomationAssumeRole no se especifica). Consulte la sección de permisos necesarios en la descripción del libro de ejecución.

    Formulario de parámetros de entrada para AWS Systems Manager la automatización con campos para los roles, los ID y la configuración de S3.

  4. Seleccione Ejecutar.

  5. Se inicia la automatización.

  6. Este documento realiza los siguientes pasos:

    • CheckConnectInstanceExistance

      Comprueba si la instancia de Connect Customer proporcionada en el ConnectInstanceId esACTIVE.

    • CheckS3BucketPublicStatus

      Comprueba si el bucket de Amazon S3 especificado en el S3BucketName permite permisos de acceso de lectura o escritura anónimos o públicos.

    • GenerateLogSearchTimeRange

      Genera StartTime y EndTime para el StartQuery paso en función de InitiationTimestamp los datos LastUpdateTimestamp devueltos por la DescribeContact API. StartTimeserá una hora antes InitiationTimestamp y EndTime una hora despuésLastUpdateTimestamp.

    • StartQuery

      Inicia un registro de consultas para lo proporcionado ContactId en el grupo de CloudWatch registros asociado a la instancia de Connect Customer proporcionada enConnectInstanceId. Las consultas se agotan después de 60 minutos de ejecución. Si se agota el tiempo de espera de la consulta, reduzca el intervalo de tiempo en el que se busca. Puedes ver las consultas en curso actualmente, así como el historial de consultas recientes, en la CloudWatch consola. Para obtener más información, consulte Ver las consultas en ejecución o el historial de consultas.

    • WaitForQueryCompletion

      Espera a que se complete el registro de consultas de CloudWatch registros proporcionadoContactId. Observe que la consulta se agota después de 60 minutos de ejecución. Si se agota el tiempo de espera de la consulta, reduzca el intervalo de tiempo en el que se busca. Puedes ver las consultas en curso actualmente, así como tu historial de consultas recientes, en la consola de Connect Customer. Para obtener más información, consulte Ver las consultas en curso o el historial de consultas.

    • UploadContactFlowLog

      Obtiene el resultado de la consulta y carga el registro del flujo de contactos en el bucket de Amazon S3 especificado enS3BucketName.

    • GenerateReport

      Devuelve la URL de la consola de Amazon S3 en la que se cargó el registro del flujo de contactos y un ejemplo de comando de la AWS CLI que puede usar para descargar el archivo de registro.

  7. Una vez finalizada, consulte la sección Resultados para ver los resultados detallados de la ejecución:

    • GenerateReport.OutputPayload

      Resultado que indica que el Runbook ha recuperado correctamente los registros de flujo de contactos del contacto especificado. Este informe también contiene la URL de la consola Amazon S3 y un ejemplo de comando de la AWS CLI para que pueda descargar el archivo de registro.

    El resultado muestra la recuperación correcta del registro de Contact Flow con la URL y el AWS CLI comando de la consola S3.

Referencias

Automatización de Systems Manager