View a markdown version of this page

AWSSupport-DeploySESSendingLogsToCloudWatchLogs - 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-DeploySESSendingLogsToCloudWatchLogs

Descripción

El manual de AWSSupport-DeploySESSendingLogsToCloudWatchLogs automatización ayuda a configurar la infraestructura necesaria para la publicación de eventos de Amazon Simple Email Service (Amazon SES) en Amazon CloudWatch Logs (CloudWatch Logs). Este manual configura los componentes necesarios para capturar los eventos de envío de correo electrónico y almacenarlos en los CloudWatch registros para su supervisión y análisis. Para obtener más información sobre la publicación de eventos de Amazon SES, consulte Supervisar el envío de correos electrónicos mediante la publicación de eventos de Amazon SES.

Cuando el ApproveDeployAnalyticEnvironment parámetro se establece enapprove, este manual crea nuevos AWS recursos en su AWS cuenta. La CloudFormation pila se elimina automáticamente después del tiempo especificado en el SleepTime parámetro, a menos que se establezca en. 0

¿Cómo funciona?

Este libro de operaciones realiza las siguientes acciones:

  • Enumera los conjuntos de configuración existentes que tienen destinos de eventos configurados para temas o flujos de entrega de Amazon Simple Notification Service (Amazon SNS).

  • Crea la infraestructura necesaria para publicar los eventos de Amazon SES en CloudWatch Logs cuando el ApproveDeployAnalyticEnvironment parámetro se establece en. approve

Cuando el ApproveDeployAnalyticEnvironment parámetro se establece enapprove, el runbook crea los siguientes recursos:

  • Una CloudFormation pila con un nombre AWSSupport-SESSendingLogsToCloudWatchLogs que incluye:

    • Tema de Amazon SNS con cifrado AWS Key Management Service (AWS KMS)

    • Cola de Amazon Simple Queue Service (Amazon SQS)

    • AWS Lambda función para procesar eventos de envío de correo electrónico

    • AWS Identity and Access Management rol de ejecución (IAM) con permisos para Amazon SQS y Logs CloudWatch

    • CloudWatch Registra el grupo de registros

    • AWS KMS clave de cifrado

    • Conjunto de configuración de Amazon SES con destinos de eventos

  • La infraestructura procesa los eventos de envío de correo electrónico siguiendo el siguiente flujo: Amazon SES Email Sending Events → Amazon SES Configuration Set → Amazon SNS Topic → Amazon SQS Queue → Lambda Function → Logs CloudWatch

  • Asocia el conjunto de configuraciones creado como el conjunto de configuración predeterminado para una identidad de Amazon SES específica cuando se proporciona el SesIdentity parámetro.

Ejecuta esta automatización (consola)

Tipo de documento

Automatización

Propietario

Amazon

Plataformas

/

Permisos de IAM necesarios

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

  • cloudformation:CreateStack

  • cloudformation:DeleteStack

  • cloudformation:DescribeStackEvents

  • cloudformation:DescribeStacks

  • iam:CreateRole

  • iam:AttachRolePolicy

  • iam:PassRole

  • kms:CreateKey

  • kms:CreateAlias

  • lambda:CreateFunction

  • lambda:AddPermission

  • logs:CreateLogGroup

  • logs:PutRetentionPolicy

  • ses:CreateConfigurationSet

  • ses:CreateConfigurationSetEventDestination

  • ses:ListConfigurationSets

  • ses:PutEmailIdentityConfigurationSetAttributes

  • sns:CreateTopic

  • sns:Subscribe

  • sqs:CreateQueue

  • sqs:SetQueueAttributes

  • ssm:DescribeAutomationExecutions

Ejemplo de política: 

{
       "Version": "2012-10-17",
       "Statement": [
           {
           "Effect": "Allow",
           "Action": [
               "cloudformation:CreateStack",
               "cloudformation:DeleteStack",
               "cloudformation:DescribeStackEvents",
               "cloudformation:DescribeStacks",
               "iam:CreateRole",
               "iam:AttachRolePolicy",
               "iam:PassRole",
               "kms:CreateKey",
               "kms:CreateAlias",
               "lambda:CreateFunction",
               "lambda:AddPermission",
               "logs:CreateLogGroup",
               "logs:PutRetentionPolicy",
               "ses:CreateConfigurationSet",
               "ses:CreateConfigurationSetEventDestination",
               "ses:ListConfigurationSets",
               "ses:PutEmailIdentityConfigurationSetAttributes",
               "sns:CreateTopic",
               "sns:Subscribe",
               "sqs:CreateQueue",
               "sqs:SetQueueAttributes",
               "ssm:DescribeAutomationExecutions"
           ],
           "Resource": "*"
           }
       ]
       }

Instrucciones

Siga estos pasos para configurar la automatización:

  1. Navegue hasta AWSSupport-DeploySESSendingLogsToCloudWatchLogs el Administrador 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):

      • Descripción: (opcional) El nombre de recurso de Amazon (ARN) de la función de 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.

      • Tipo: AWS::IAM::Role::Arn

    • ApproveDeployAnalyticEnvironment (Opcional):

      • Descripción: (opcional) Aprobación para implementar la infraestructura de publicación de eventos de Amazon SES. Ingrese approve para crear la CloudFormation pila y los recursos relacionados. Si se deja vacío, el libro de instrucciones solo muestra los conjuntos de configuración existentes con destinos de eventos de Amazon SNS en la región actual.

      • Tipo: String

      • Patrón permitido: ^$|^approve$

      • Valor predeterminado: ""

    • SesIdentity (Opcional):

      • Descripción: (opcional) Identidad de Amazon SES (dirección de correo electrónico o dominio) para asociarla al conjunto de configuraciones recién creado como conjunto de configuraciones predeterminado. Esto sobrescribirá cualquier conjunto de configuración predeterminado existente para la identidad especificada.

      • Tipo: String

      • Valor predeterminado: ""

    • CloudWatchLogGroupName (Opcional):

      • Descripción: (opcional) Nombre del grupo de CloudWatch registros que se va a crear para almacenar los eventos de envío de correo electrónico de Amazon SES.

      • Tipo: String

      • Patrón permitido: ^[0-9a-zA-Z_.#/\\-]{1,512}$

      • Valor predeterminado: /ses/sending_event_logs

    • MaskPiidata (opcional):

      • Descripción: (opcional) Especifique si desea ocultar los datos de información de identificación personal (PII), como las direcciones de correo electrónico de destino y los asuntos de los correos electrónicos, en los registros. CloudWatch FalseConfigúralo para incluir esta información en los registros.

      • Tipo: String

      • Valores permitidos: [True, False]

      • Valor predeterminado: True

    • SleepTime (Opcional):

      • Descripción: (opcional) Número de minutos que deben transcurrir antes de eliminar automáticamente la CloudFormation pila. El valor predeterminado es de 24 horas (1440 minutos) y el máximo es de 7 días (10,080 minutos). Establézcalo 0 para evitar la eliminación automática.

      • Tipo: String

      • Patrón permitido: ^(?:[0-9]|[1-9]\\d{1,3}|100[0-7][0-9])$

      • Valor predeterminado: 1440

    • RetainCloudWatchLogsOnDeletion (Opcional):

      • Descripción: (opcional) Especifique si desea conservar el grupo de CloudWatch registros cuando se elimine la CloudFormation pila. FalseConfigúralo para eliminar el grupo de registros junto con la pila.

      • Tipo: String

      • Valores permitidos: [True, False]

      • Valor predeterminado: True

    • UniqueId (Opcional):

      • Descripción: (Opcional) un identificador único para el flujo de trabajo.

      • Tipo: String

      • Patrón permitido: \\{\\{ automation:EXECUTION_ID \\}\\}|[a-zA-Z0-9-]+

      • Valor predeterminado: {{ automation:EXECUTION_ID }}

      • Caracteres máximos: 64

  4. Seleccione Ejecutar.

  5. Se inicia la automatización.

  6. Este documento realiza los siguientes pasos:

    • BranchOnValueOfParameterApproveDeployAnalyticEnvironment

      Determina si se debe implementar la infraestructura de publicación de eventos de Amazon SES en función del valor del ApproveDeployAnalyticEnvironment parámetro.

    • GetEligibleConfigurationSets

      Recupera los conjuntos de configuración de Amazon SES existentes e identifica aquellos con destinos de eventos configurados para flujos de entrega o temas de Amazon SNS.

    • CheckConcurrency

      Verifica que no exista ninguna pila existente y que ninguna otra ejecución simultánea de este runbook esté creando la misma pila.

    • DeploySesEventDestinations

      Crea la CloudFormation pila que contiene la infraestructura de publicación de eventos de Amazon SES, que incluye el tema de Amazon SNS, la cola de Amazon SQS, la función Lambda y el grupo de registros de Logs. CloudWatch

    • RelateConfigurationSetAsDefaultConfigurationSet

      Asocia el conjunto de configuraciones de Amazon SES recién creado como el conjunto de configuración predeterminado para la identidad de Amazon SES especificada (si se proporciona).

    • SleepBeforeDeleteCloudFormationStack

      Espera el tiempo especificado en el SleepTime parámetro antes de proceder a eliminar la CloudFormation pila.

    • DeleteCloudFormationStack

      Elimina la CloudFormation pila después del período de tiempo especificado.

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

Referencias

Automatización de Systems Manager