Usando AWS Lambda com a Amazon EventBridge (CloudWatch Eventos)

nota

A Amazon EventBridge é a forma preferida de gerenciar seus eventos. CloudWatchEventos e EventBridge são o mesmo serviço e API subjacentes, mas EventBridge oferecem mais recursos. As alterações feitas em CloudWatch Eventos ou EventBridge aparecerão em cada console. Para obter mais informações, consulte a EventBridge documentação da Amazon.

EventBridge (CloudWatch Eventos) ajuda você a responder às mudanças de estado em seus AWS recursos. Para obter mais informações sobre EventBridge, consulte O que é a Amazon EventBridge? no Guia do EventBridge usuário da Amazon.

Quando seus recursos mudam de estado, enviam eventos automaticamente em um fluxo de evento. Com EventBridge (CloudWatch Eventos), você pode criar regras que correspondam aos eventos selecionados no stream e encaminhá-las para sua AWS Lambda função para agir. Por exemplo, você pode invocar automaticamente uma AWS Lambda função para registrar o estado de uma instância ou AutoScaling grupo do EC2.

EventBridge (CloudWatch Events) invoca sua função de forma assíncrona com um documento de evento que agrupa o evento de sua origem. O exemplo a seguir mostra um evento originado de um snapshot de banco de dados no Amazon Relational Database Service.

exemplo EventBridge CloudWatch evento (Eventos)

{
    "version": "0",
    "id": "fe8d3c65-xmpl-c5c3-2c87-81584709a377",
    "detail-type": "RDS DB Instance Event",
    "source": "aws.rds",
    "account": "123456789012",
    "time": "2020-04-28T07:20:20Z",
    "region": "us-east-2",
    "resources": [
        "arn:aws:rds:us-east-2:123456789012:db:rdz6xmpliljlb1"
    ],
    "detail": {
        "EventCategories": [
            "backup"
        ],
        "SourceType": "DB_INSTANCE",
        "SourceArn": "arn:aws:rds:us-east-2:123456789012:db:rdz6xmpliljlb1",
        "Date": "2020-04-28T07:20:20.112Z",
        "Message": "Finished DB Instance backup",
        "SourceIdentifier": "rdz6xmpliljlb1"
    }
}

Também é possível criar uma função do Lambda e direcionar o AWS Lambda para invocá-la em uma programação regular. É possível especificar uma taxa fixa (por exemplo, invocar uma função do Lambda a cada hora ou a cada 15 minutos) ou especificar uma expressão Cron.

exemplo EventBridge evento de mensagem (CloudWatch Eventos)

{
  "version": "0",
  "account": "123456789012",
  "region": "us-east-2",
  "detail": {},
  "detail-type": "Scheduled Event",
  "source": "aws.events",
  "time": "2019-03-01T01:23:45Z",
  "id": "cdc73f9d-aea9-11e3-9d5a-835b769c0d9c",
  "resources": [
    "arn:aws:events:us-east-2:123456789012:rule/my-schedule"
  ]
}

Para configurar EventBridge (CloudWatch Eventos) para invocar sua função

1. Abra a página Funções do console do Lambda.

2. Escolha uma função.

3. Em Visão geral da função, escolha Adicionar gatilho.

4. Defina o tipo de gatilho como EventBridge (CloudWatch Eventos).

5. Em Rule (Regra), selecione Create a new rule (Criar uma regra).

6. Configure as opções restantes e selecione Add (Adicionar).

Para obter mais informações sobre programações de expressões, consulte Programar expressões usando rate ou cron.

Cada AWS conta pode ter até 100 fontes de eventos exclusivas do tipo de fonte EventBridge (CloudWatch Eventos) - Programação. Cada uma dessas pode ser a fonte de eventos para até cinco funções do Lambda. Ou seja, você pode ter até 500 funções do Lambda em execução em um cronograma na sua conta da AWS.

Tópicos

• Tutorial: usar o AWS Lambda com eventos programados
• Programar expressões usando rate ou cron