Visão geral das notificações de eventos do Amazon RDS

O Amazon RDS agrupa eventos em categorias em que você pode se inscrever para receber notificações quando um evento ocorrer na categoria.

Recursos do RDS elegíveis para assinatura de eventos

No Amazon Aurora, os eventos ocorrem tanto no nível do cluster de banco de dados como no da instância de banco de dados. Você pode se inscrever em uma categoria de evento para os seguintes recursos:

• DB instance (Instância de banco de dados)

• Cluster de banco de dados

• Snapshot de cluster de banco de dados

• DB parameter group (grupo de parâmetros de banco de dados)

• DB security group (grupo de segurança de banco de dados)

• RDS Proxy

• Versões de mecanismo personalizadas

Por exemplo, se você se inscrever na categoria de backup para uma determinada instância de banco de dados, receberá notificações sempre que houver um evento relacionado ao backup que afete a instância de banco de dados. Se você se inscrever em uma categoria de alteração de configuração para uma instância de banco de dados, será notificado quando a instância de banco de dados for alterada. Você também recebe uma notificação quando uma assinatura de notificação de evento é alterada.

Você pode querer criar várias assinaturas diferentes. Por exemplo, você pode criar uma assinatura que receba todas as notificações de eventos de todas as instâncias de banco de dados e outra que inclua somente eventos críticos de um subconjunto das instâncias de bancos de dados. Para a segunda assinatura, especifique uma ou mais instâncias de banco de dados no filtro.

Processo básico de assinatura de notificações de eventos do Amazon RDS

O processo de inscrição na notificação de evento do Amazon RDS é o seguinte:

1. Você cria uma assinatura de notificação de eventos do Amazon RDS usando o console do Amazon RDS, a AWS CLI ou a API.

   O Amazon RDS usa o ARN de um tópico do Amazon SNS para identificar cada assinatura. O console do Amazon RDS cria o ARN para você quando cria a assinatura. Crie o ARN usando o console do Amazon SNS, a AWS CLI ou a API do Amazon SNS.

2. O Amazon RDS envia um e-mail ou mensagem SMS de aprovação para os endereços que você submeteu com a assinatura.

3. Você confirma a assinatura escolhendo o link na notificação que recebeu.

4. O console do Amazon RDS atualiza a seção My Event Subscriptions (Minhas assinaturas de eventos) com o status de sua assinatura.

5. O Amazon RDS começa a enviar notificações aos endereços que você forneceu ao criar a assinatura.

Para saber mais sobre o Gerenciamento de Identidade e Acesso ao usar o Amazon SNS, consulte Gerenciamento de Identidade e Acesso no Amazon SNS no Guia do desenvolvedor do Amazon Simple Notification Service.

É possível usar o AWS Lambda para processar notificações de eventos de uma instância de banco de dados. Para obter mais informações, consulte Uso do AWS Lambda com o Amazon RDS no Guia do desenvolvedor do AWS Lambda.

Entrega de notificações de evento do RDS

O Amazon RDS envia notificações aos endereços que você fornece ao criar a assinatura. A notificação pode incluir atributos de mensagem que fornecem metadados estruturados sobre a mensagem. Para obter mais informações sobre os atributos de mensagem, consulte Categorias de eventos e mensagens de eventos do Amazon RDS.

As notificações de eventos podem levar até cinco minutos para serem entregues.

Importante

O Amazon RDS não garante a ordem dos eventos enviados em um fluxo de eventos. A ordem do evento está sujeita a alterações.

Quando o Amazon SNS envia uma notificação para um endpoint HTTP ou HTTPS inscrito, a mensagem POST enviada ao endpoint tem um corpo de mensagem que contém um documento JSON. Para obter mais informações, consulte Mensagens do Amazon SNS e formatos JSON no Guia do desenvolvedor do Amazon Simple Notification Service.

É possível configurar o SNS para notificar você com mensagens de texto. Para obter mais informações, consulte Mensagens de texto móveis (SMS) no Guia do desenvolvedor do Amazon Simple Notification Service.

Para desativar as notificações sem excluir uma assinatura, escolha No (Não) para Enabled (Habilitado) no console do Amazon RDS. Ou você pode definir o parâmetro Enabled para false usando a AWS CLI ou a API do Amazon RDS.

Faturamento de notificações de eventos do Amazon RDS

O faturamento da notificação de eventos do Amazon RDS é feito por meio do Amazon SNS. As taxas do Amazon SNS se aplicam durante o uso da notificação de eventos. Para obter mais informações sobre o faturamento do Amazon SNS, consulte Preço do Amazon Simple Notification Service.

Exemplos de eventos do Aurora

Os exemplos a seguir mostram diferentes tipos de eventos do Aurora no formato JSON. Para acessar um tutorial que mostre como capturar e visualizar eventos no formato JSON, consulte Tutorial: Registro de alterações de estado de uma instância de banco de dados usando o Amazon EventBridge.

Tópicos

• Exemplo de um evento de cluster de banco de dados
• Exemplo de um evento de grupo de parâmetros de banco de dados
• Exemplo de um evento de snapshot de cluster de banco de dados

Exemplo de um evento de cluster de banco de dados

Veja a seguir um exemplo de um evento de cluster de banco de dados no formato JSON. O evento mostra que o cluster chamado my-db-cluster foi corrigido. O ID do evento é RDS-EVENT-0173.

{
  "version": "0",
  "id": "844e2571-85d4-695f-b930-0153b71dcb42",
  "detail-type": "RDS DB Cluster Event",
  "source": "aws.rds",
  "account": "123456789012",
  "time": "2018-10-06T12:26:13Z",
  "region": "us-east-1",
  "resources": [
    "arn:aws:rds:us-east-1:123456789012:cluster:my-db-cluster"
  ],
  "detail": {
    "EventCategories": [
      "notification"
    ],
    "SourceType": "CLUSTER",
    "SourceArn": "arn:aws:rds:us-east-1:123456789012:cluster:my-db-cluster",
    "Date": "2018-10-06T12:26:13.882Z",
    "Message": "Database cluster has been patched",
    "SourceIdentifier": "my-db-cluster",
    "EventID": "RDS-EVENT-0173"
  }
}

Exemplo de um evento de grupo de parâmetros de banco de dados

Veja a seguir um exemplo de um evento de grupo de parâmetros de banco de dados no formato JSON. O evento mostra que o parâmetro time_zone foi atualizado no grupo de parâmetros my-db-param-group. O ID do evento é RDS-EVENT-0037.

{
  "version": "0",
  "id": "844e2571-85d4-695f-b930-0153b71dcb42",
  "detail-type": "RDS DB Parameter Group Event",
  "source": "aws.rds",
  "account": "123456789012",
  "time": "2018-10-06T12:26:13Z",
  "region": "us-east-1",
  "resources": [
    "arn:aws:rds:us-east-1:123456789012:pg:my-db-param-group"
  ],
  "detail": {
    "EventCategories": [
      "configuration change"
    ],
    "SourceType": "DB_PARAM",
    "SourceArn": "arn:aws:rds:us-east-1:123456789012:pg:my-db-param-group",
    "Date": "2018-10-06T12:26:13.882Z",
    "Message": "Updated parameter time_zone to UTC with apply method immediate",
    "SourceIdentifier": "my-db-param-group",
    "EventID": "RDS-EVENT-0037"
  }
}

Exemplo de um evento de snapshot de cluster de banco de dados

Veja a seguir um exemplo de um evento de snapshot de cluster de banco de dados no formato JSON. O evento mostra a criação do snapshot chamado my-db-cluster-snapshot. O ID do evento é RDS-EVENT-0074.

{
  "version": "0",
  "id": "844e2571-85d4-695f-b930-0153b71dcb42",
  "detail-type": "RDS DB Cluster Snapshot Event",
  "source": "aws.rds",
  "account": "123456789012",
  "time": "2018-10-06T12:26:13Z",
  "region": "us-east-1",
  "resources": [
    "arn:aws:rds:us-east-1:123456789012:cluster-snapshot:rds:my-db-cluster-snapshot"
  ],
  "detail": {
    "EventCategories": [
      "backup"
    ],
    "SourceType": "CLUSTER_SNAPSHOT",
    "SourceArn": "arn:aws:rds:us-east-1:123456789012:cluster-snapshot:rds:my-db-cluster-snapshot",
    "Date": "2018-10-06T12:26:13.882Z",
    "SourceIdentifier": "my-db-cluster-snapshot",
    "Message": "Creating manual cluster snapshot",
    "EventID": "RDS-EVENT-0074"
  }
}