Configuración de la comprobación de estado de Route 53 para los puntos de conexión globales de EventBridge - Amazon EventBridge
Plantilla de CloudFormation para definir una comprobación de estado de Route 53Propiedades de alarmas de CloudWatchPropiedades de la comprobación de estado de Route 53

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.

Configuración de la comprobación de estado de Route 53 para los puntos de conexión globales de EventBridge

Cuando utilice puntos de conexión globales, debe someterse a una comprobación de estado de Route 53 para supervisar el estado de sus regiones. La siguiente plantilla define una alarma de Amazon CloudWatch y la utiliza para definir una comprobación de estado de Route 53.

Plantilla de CloudFormation para definir una comprobación de estado de Route 53

Use la siguiente plantilla para definir su comprobación de estado de Route 53.

Description: |-
  Global endpoints health check that will fail when the average Amazon EventBridge 
  latency is above 30 seconds for a duration of 5 minutes. Note, missing data will 
  cause the health check to fail, so if you only send events intermittently, consider 
  changing the heath check to use a longer evaluation period or instead treat missing 
  data as 'missing' instead of 'breaching'.

Metadata:
  AWS::CloudFormation::Interface:
    ParameterGroups: 
      - Label: 
          default: "Global endpoint health check alarm configuration"
        Parameters:
          - HealthCheckName
          - HighLatencyAlarmPeriod
          - MinimumEvaluationPeriod
          - MinimumThreshold
          - TreatMissingDataAs
    ParameterLabels:
      HealthCheckName:
        default: Health check name
      HighLatencyAlarmPeriod:
        default: High latency alarm period
      MinimumEvaluationPeriod:
        default: Minimum evaluation period
      MinimumThreshold:
        default: Minimum threshold
      TreatMissingDataAs:
        default: Treat missing data as

Parameters:
  HealthCheckName:
    Description: Name of the health check
    Type: String
    Default: LatencyFailuresHealthCheck
  HighLatencyAlarmPeriod:
    Description: The period, in seconds, over which the statistic is applied. Valid values are 10, 30, 60, and any multiple of 60.
    MinValue: 10
    Type: Number
    Default: 60
  MinimumEvaluationPeriod:
    Description: The number of periods over which data is compared to the specified threshold. You must have at least one evaluation period.
    MinValue: 1
    Type: Number
    Default: 5
  MinimumThreshold:
    Description: The value to compare with the specified statistic.
    Type: Number
    Default: 30000
  TreatMissingDataAs:
    Description: Sets how this alarm is to handle missing data points.
    Type: String
    AllowedValues:
      - breaching
      - notBreaching
      - ignore
      - missing
    Default: breaching  

Mappings:
  "InsufficientDataMap":
    "missing":
      "HCConfig": "LastKnownStatus"
    "breaching":
      "HCConfig": "Unhealthy"  

Resources:
  HighLatencyAlarm:
      Type: AWS::CloudWatch::Alarm
      Properties:
        AlarmDescription: High Latency in Amazon EventBridge
        MetricName: IngestionToInvocationStartLatency
        Namespace: AWS/Events
        Statistic: Average
        Period: !Ref HighLatencyAlarmPeriod
        EvaluationPeriods: !Ref MinimumEvaluationPeriod
        Threshold: !Ref MinimumThreshold
        ComparisonOperator: GreaterThanThreshold
        TreatMissingData: !Ref TreatMissingDataAs

  LatencyHealthCheck:
      Type: AWS::Route53::HealthCheck
      Properties:
        HealthCheckTags:
          - Key: Name
            Value: !Ref HealthCheckName
        HealthCheckConfig:
          Type: CLOUDWATCH_METRIC
          AlarmIdentifier:
            Name:
              Ref: HighLatencyAlarm
            Region: !Ref AWS::Region
          InsufficientDataHealthStatus: !FindInMap [InsufficientDataMap, !Ref TreatMissingDataAs, HCConfig]

Outputs:
  HealthCheckId:
    Description: The identifier that Amazon Route 53 assigned to the health check when you created it.
    Value: !GetAtt LatencyHealthCheck.HealthCheckId

Los ID de los eventos pueden cambiar entre llamadas a la API, por lo que para correlacionar los eventos entre regiones es necesario disponer de un identificador único e inmutable. Los consumidores también deben diseñarse teniendo en cuenta la idempotencia. De esta forma, si replica eventos o los reproduce desde archivos, no habrá efectos secundarios por el procesamiento de los eventos en ambas regiones.

Propiedades de la plantilla de alarmas de CloudWatch

nota

Para todos los campos editable, tenga en cuenta el rendimiento por segundo. Si solo envía los eventos de forma intermitente, considere la posibilidad de cambiar la comprobación de estado para utilizar un período de evaluación más largo o, en su lugar, tratar los datos faltantes como missing, en lugar de breaching.

Las siguientes propiedades se utilizan en la sección de alarmas de CloudWatch de la plantilla:

Métrica Descripción

AlarmDescription

La descripción de la alarma.

Valor predeterminado: High Latency in Amazon EventBridge

MetricName

El nombre de la métrica asociada a la alarma. Esto es necesario para alarmas basadas en métricas. Para alarmas basadas en expresiones matemáticas, se utiliza en cambio Metrics y no se puede especificar MetricName.

Valor predeterminado: IngestionToInvocationStartLatency

Namespace

El espacio de nombres de la métrica asociada a la alarma. Esto es necesario para alarmas basadas en métricas. Para alarmas basadas en expresiones matemáticas, no puede especificar Namespace. En cambio, debe utilizar Metrics.

Valor predeterminado: AWS/Events

Statistic

La estadística para la métrica asociada a la alarma, aparte de percentil.

Valor predeterminado: Promedio

Period

El periodo, en segundos, durante el cual se aplica la estadística. Esto es necesario para alarmas basadas en métricas. Los valores válidos son 10, 30, 60 y cualquier múltiplo de 60.

Valor predeterminado: 60

EvaluationPeriods

El número de periodos en los que los datos se comparan con el umbral especificado. Si configura una alarma que requiere que se infrinjan varios puntos de datos consecutivos para desencadenar la alarma, este valor especifica ese número. Si configura una alarma “M de N”, este valor es la N y DatapointsToAlarm es la M.

Valor predeterminado: 5

Threshold

El valor para comparar con la estadística especificada.

Valor predeterminado: 30,000

ComparisonOperator

La operación aritmética que debe usar al comparar el umbral y la estadística especificados. El valor de estadística especificado se utiliza como el primer operando.

Valor predeterminado: GreaterThanThreshold

TreatMissingData

Establece cómo administra esta alarma los puntos de datos que faltan.

Los valores aceptados son: breaching, notBreaching, ignore y missing

Valor predeterminado: breaching

Propiedades de la plantilla de comprobación de estado de Route 53

nota

Para todos los campos editable, tenga en cuenta el rendimiento por segundo. Si solo envía los eventos de forma intermitente, considere la posibilidad de cambiar la comprobación de estado para utilizar un período de evaluación más largo o, en su lugar, tratar los datos faltantes como missing, en lugar de breaching.

Las siguientes propiedades se utilizan en la sección de comprobación de estado de Route 53 de la plantilla:

Métrica Descripción

HealthCheckName

El nombre de la comprobación de estado.

Valor predeterminado: LatencyFailuresHealthCheck

InsufficientDataHealthStatus

Cuando CloudWatch no tiene suficientes datos sobre la métrica para determinar el estado de alarma, el estado que desea que Amazon Route 53 asigne a la comprobación de estado

Valores válidos:

  • Healthy: Route 53 considera que la comprobación de estado es correcta.

  • Unhealthy: Route 53 considera que la comprobación de estado no es correcta.

  • LastKnownStatus: Route 53 utiliza el estado de la comprobación de estado de la última vez que CloudWatch tenía datos suficientes para determinar el estado de alarma. En el caso de las nuevas comprobaciones de estado que no tienen un último estado conocido, el estado predeterminado para la comprobación de estado es correcto.

Valor predeterminado: Mal estado

nota

Este campo se actualiza en función de la entrada en el campo TreatMissingData. Si TreatingMissingData se establece enMissing, se actualizará a LastKnownStatus. Si TreatingMissingData se establece en Breaching, se actualizará a Unhealthy.