As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
# Monitorar eventos do MemoryDB
Quando ocorrem eventos significativos em um cluster, o MemoryDB envia uma notificação para um tópico específico do Amazon SNS. Exemplos incluem uma falha ao adicionar um nó, êxito ao adicionar um nó, a modificação de um grupo de segurança, e outros. Ao monitorar eventos chave, você pode se manter informado sobre o atual estado dos seus clusters e, dependendo do evento, poderá executar uma ação corretiva.
**Topics**
+ [Gerenciamento de notificações do Amazon SNS do MemoryDB](mdbevents.sns.md)
+ [Visualizar eventos do MemoryDB](mdbevents.viewing.md)
+ [Notificações de eventos e o Amazon SNS](memorydbsns.md)
# Gerenciamento de notificações do Amazon SNS do MemoryDB
Você pode configurar o MemoryDB para enviar notificações sobre eventos importantes do cluster usando o Amazon Simple Notification Service (Amazon SNS). Nestes exemplos, você configurará um cluster com o nome de recurso da Amazon (ARN) de um tópico do Amazon SNS para receber notificações.
**nota**
Esse tópico pressupõe que você tenha se cadastrado no Amazon SNS e configurado e assinado um tópico do Amazon SNS. Para obter informações sobre como fazer isso, consulte o [Guia do desenvolvedor do Amazon Simple Notification Service](https://docs.aws.amazon.com/sns/latest/dg/).
## Adição de um tópico do Amazon SNS
As seções a seguir mostram como adicionar um tópico do Amazon SNS usando o Console da AWS, a AWS CLI, ou a API do MemoryDB.
### Adição de um tópico do Amazon SNS (console)
O procedimento a seguir mostra como adicionar um tópico do Amazon SNS para um cluster.
**nota**
Esse processo também pode ser usado para modificar o tópico do Amazon SNS.
**Para adicionar ou modificar um tópico do Amazon SNS para um cluster (console)**
1. Faça login no Console de gerenciamento da AWS e abra o console do MemoryDB em [https://console.aws.amazon.com/memorydb/](https://console.aws.amazon.com/memorydb/).
1. Em **Clusters**, escolha o cluster para o qual deseja adicionar ou modificar um ARN de tópico do Amazon SNS.
1. Escolha **Modificar**.
1. Em **Modificar cluster** em **Tópico para notificação do SNS**, escolha o tópico SNS que você deseja adicionar ou escolha **Entrada manual de ARN** e insira o ARN do tópico do Amazon SNS.
1. Escolha **Modificar**.
### Adição de um tópico do Amazon SNS (CLI da AWS)
Para adicionar ou modificar um tópico do Amazon SNS a um cluster, use o comando da AWS CLI `update-cluster`.
O seguinte exemplo de código adiciona um ARN de tópico do Amazon SNS a *my-cluster*.
Para Linux, macOS ou Unix:
```
aws memorydb update-cluster \
--cluster-name my-cluster \
--sns-topic-arn arn:aws:sns:us-east-1:565419523791:memorydbNotifications
```
Para Windows:
```
aws memorydb update-cluster ^
--cluster-name my-cluster ^
--sns-topic-arn arn:aws:sns:us-east-1:565419523791:memorydbNotifications
```
Para obter mais informações, consulte [UpdateCluster](https://docs.aws.amazon.com/memorydb/latest/APIReference/API_UpdateCluster.html).
### Adição de um tópico do Amazon SNS (API do MemoryDB)
Para adicionar ou atualizar um tópico do Amazon SNS para um cluster, chame a ação `UpdateCluster` com os seguintes parâmetros:
+ `ClusterName``=my-cluster`
+ `SnsTopicArn``=arn%3Aaws%3Asns%3Aus-east-1%3A565419523791%3AmemorydbNotifications`
Para adicionar ou atualizar um tópico do Amazon SNS para um cluster, chame a ação `UpdateCluster`.
Para obter mais informações, consulte [UpdateCluster](https://docs.aws.amazon.com/memorydb/latest/APIReference/API_UpdateCluster.html).
## Habilitação e desabilitação de notificações do Amazon SNS
Você pode ativar ou desativar notificações para um cluster. Os procedimentos a seguir mostram como desativar notificações do Amazon SNS.
### Habilitação e desabilitação de notificações do Amazon SNS (console)
**Para desabilitar as notificações do Amazon SNS usando o Console de gerenciamento da AWS**
1. Faça login no Console de gerenciamento da AWS e abra o console do MemoryDB em [https://console.aws.amazon.com/memorydb/](https://console.aws.amazon.com/memorydb/).
1. Selecione o botão de opções à esquerda do cluster para o qual você deseja modificar a notificação.
1. Escolha **Modificar**.
1. Em **Modify Cluster**, em **Topic for SNS Notification**, escolha *Disable Notifications*.
1. Escolha **Modificar**.
### Habilitação e desabilitação de notificações do Amazon SNS (CLI da AWS)
Para desabilitar notificações do Amazon SNS, use o comando `update-cluster` com os seguintes parâmetros:
Para Linux, macOS ou Unix:
```
aws memorydb update-cluster \
--cluster-name my-cluster \
--sns-topic-status inactive
```
Para Windows:
```
aws memorydb update-cluster ^
--cluster-name my-cluster ^
--sns-topic-status inactive
```
### Habilitação e desabilitação de notificações do Amazon SNS (API do MemoryDB)
Para desabilitar notificações do Amazon SNS, chame a ação `UpdateCluster` com os seguintes parâmetros:
+ `ClusterName``=my-cluster`
+ `SnsTopicStatus``=inactive`
Essa chamada retorna uma saída semelhante à seguinte:
**Example**
```
1. https://memory-db.us-east-1.amazonaws.com/
2. ?Action=UpdateCluster
3. &ClusterName=my-cluster
4. &SnsTopicStatus=inactive
5. &Version=2021-01-01
6. &SignatureVersion=4
7. &SignatureMethod=HmacSHA256
8. &Timestamp=20210801T220302Z
9. &X-Amz-Algorithm=Amazon4-HMAC-SHA256
10. &X-Amz-Date=20210801T220302Z
11. &X-Amz-SignedHeaders=Host
12. &X-Amz-Expires=20210801T220302Z
13. &X-Amz-Credential=
14. &X-Amz-Signature=
```
# Visualizar eventos do MemoryDB
O MemoryDB faz o evento de logs relacionado aos seus clusters, grupos de segurança e grupos de parâmetros. Essas informações incluem a data e a hora do evento, o nome da origem e o tipo de origem do evento, bem como uma descrição do evento. É possível recuperar facilmente eventos do log usando o console do MemoryDB, o comando `describe-events` da AWS CLI ou a ação `DescribeEvents` da API do MemoryDB.
Os procedimentos a seguir mostram como visualizar todos os eventos do MemoryDB das últimas 24 horas (1440 minutos).
## Visualização de eventos do MemoryDB (console)
O procedimento a seguir exibe eventos usando o console do MemoryDB.
**Para visualizar eventos usando o console do MemoryDB**
1. Faça login no Console de gerenciamento da AWS e abra o console do MemoryDB em [https://console.aws.amazon.com/memorydb/](https://console.aws.amazon.com/memorydb/).
1. No painel de navegação esquerdo, escolha **Events**.
A tela *Eventos* exibe a listagem de todos os eventos disponíveis. Cada linha da lista representa um evento e exibe a origem do evento, o tipo de evento (como cluster, grupo de parâmetros, acl, grupo de segurança ou grupo de sub-rede), a hora GMT do evento e a descrição do evento.
Usando a opção **Filtro**, você pode especificar se deseja ver todos os eventos ou apenas eventos de um tipo específico na lista de eventos.
## Visualizando eventos do MemoryDB (CLI da AWS)
Para gerar uma lista de eventos do MemoryDB usando a AWS CLI, use o comando `describe-events`. Você pode usar parâmetros opcionais para controlar os tipos de eventos listados, o período de tempo dos eventos listados, o número máximo de eventos a serem listados e muito mais.
O código a seguir lista até 40 eventos de cluster.
```
aws memorydb describe-events --source-type cluster --max-results 40
```
O código a seguir lista todos os eventos nas últimas 24 horas (1440 minutos).
```
aws memorydb describe-events --duration 1440
```
A saída do comando `describe-events` é semelhante a esta.
```
{
"Events": [
{
"Date": "2021-03-29T22:17:37.781Z",
"Message": "Added node 0001 in Availability Zone us-east-1a",
"SourceName": "memorydb01",
"SourceType": "cluster"
},
{
"Date": "2021-03-29T22:17:37.769Z",
"Message": "cluster created",
"SourceName": "memorydb01",
"SourceType": "cluster"
}
]
}
```
Para obter mais informações, como os parâmetros disponíveis e os valores de parâmetros permitidos, consulte [https://docs.aws.amazon.com/cli/latest/reference/memorydb/describe-events.html](https://docs.aws.amazon.com/cli/latest/reference/memorydb/describe-events.html).
## Visualizando eventos do MemoryDB (API do MemoryDB)
Para gerar uma lista de eventos do MemoryDB usando a API do MemoryDB, use a ação `DescribeEvents`. Você pode usar parâmetros opcionais para controlar os tipos de eventos listados, o período de tempo dos eventos listados, o número máximo de eventos a serem listados e muito mais.
O código a seguir lista os 40 eventos de cluster mais recentes.
```
https://memory-db.us-east-1.amazonaws.com/
?Action=DescribeEvents
&MaxResults=40
&SignatureVersion=4
&SignatureMethod=HmacSHA256
&SourceType=cluster
&Timestamp=20210802T192317Z
&Version=2021-01-01
&X-Amz-Credential=
```
O código a seguir lista os eventos de cluster nas últimas 24 horas (1440 minutos).
```
https://memory-db.us-east-1.amazonaws.com/
?Action=DescribeEvents
&Duration=1440
&SignatureVersion=4
&SignatureMethod=HmacSHA256
&SourceType=cluster
&Timestamp=20210802T192317Z
&Version=2021-01-01
&X-Amz-Credential=
```
As ações acima devem produzir uma saída semelhante à seguinte.
```
cluster created
cluster
2021-08-02T18:22:18.202Z
my-memorydb-primary
(...output omitted...)
e21c81b4-b9cd-11e3-8a16-7978bb24ffdf
```
Para obter mais informações, como os parâmetros disponíveis e os valores de parâmetros permitidos, consulte [https://docs.aws.amazon.com/memorydb/latest/APIReference/API_DescribeEvents.html](https://docs.aws.amazon.com/memorydb/latest/APIReference/API_DescribeEvents.html).
# Notificações de eventos e o Amazon SNS
O MemoryDB pode publicar mensagens usando o Serviço de notificação simples da Amazon (Amazon Simple Notification Service (SNS)) quando houver eventos significativos em um cluster. Esse atributo pode ser usado para atualizar as listas de servidores em máquinas clientes conectadas a endpoints de nó individuais de um cluster.
**nota**
Para obter mais informações sobre o Amazon Simple Notification Service (SNS), incluindo informações sobre preços e links para a documentação do Amazon SNS, consulte a [página do produto Amazon SNS](https://aws.amazon.com/sns).
As notificações são publicadas em um *tópico* do Amazon SNS especificado. Os seguintes são requisitos para notificações:
+ Apenas um tópico pode ser configurado para notificações do MemoryDB.
+ A conta da AWS que possui o tópico do Amazon SNS deve ser a mesma conta que possui o cluster em que as notificações estão habilitadas.
## Eventos do MemoryDB
Os seguintes eventos do MemoryDB acionam notificações do Amazon SNS:
| Nome do evento | Mensagem | Descrição |
| --- | --- | --- |
| MemoryDB:AddNodeComplete | "Modified number of nodes from %d to %d" | Um nó foi adicionado ao cluster e está pronto para uso. |
| MemoryDB:AddNodeFailed devido a endereços IP livres insuficientes | "Failed to modify number of nodes from %d to %d due to insufficient free IP addresses" | Um nó não pôde ser adicionado porque não há endereços IP suficientes disponíveis. |
| MemoryDB:ClusterParametersChanged | "Updated parameter group for the cluster" Em caso de criar, envie também `"Updated to use a ParameterGroup %s"` | Um ou mais parâmetros de cluster foram alterados. |
| MemoryDB:ClusterProvisioningComplete | "Cluster created." | O provisionamento de um cluster está concluído, e os nós no cluster estão prontos para uso. |
| MemoryDB:ClusterProvisioningFailed devido a estado de rede incompatível | "Failed to create cluster due to incompatible network state. %s" | Foi feita uma tentativa de executar um novo cluster em uma nuvem privada virtual (VPC) inexistente. |
| MemoryDB:ClusterRestoreFailed | "Restore from %s failed for node %s. %s" | O MemoryDB não conseguiu preencher o cluster com os dados do snapshot. Isso pode ser devido a um arquivo de snapshot inexistente no Amazon S3 ou permissões incorretas nesse arquivo. Se você descrever o cluster, o status será `restore-failed`. Você precisará excluir o cluster e começar de novo. Para obter mais informações, consulte [Propagação de um novo cluster com um snapshot criado externamente](snapshots-seeding-redis.md). |
| MemoryDB:ClusterScalingComplete | `"Succeeded applying modification to node type to %s."` | Aumento vertical da escala para cluster concluído com sucesso. |
| MemoryDB:ClusterScalingFailed | `"Failed applying modification to node type to %s."` | A operação de aumentar a escala verticalmente no cluster falhou. |
| MemoryDB:NodeReplaceStarted | "Recovering node %s" | O MemoryDB detectou que o host que está executando um nó está degradado ou inacessível e iniciou a substituição do nó. A entrada de DNS para o nó substituído não é alterada. Na maioria dos casos, você não precisa atualizar a lista de servidores para seus clientes quando esse evento ocorre. No entanto, algumas bibliotecas de clientes podem parar de usar o nó mesmo após o MemoryDB ter substituído o nó. Neste caso, o aplicativo deve atualizar a lista de servidores quando esse evento ocorrer. |
| MemoryDB:NodeReplaceComplete | "Finished recovery for node %s" | O MemoryDB detectou que o host que executa um nó está degradado ou inacessível e concluiu a substituição do nó. A entrada de DNS para o nó substituído não é alterada. Na maioria dos casos, você não precisa atualizar a lista de servidores para seus clientes quando esse evento ocorre. No entanto, algumas bibliotecas de clientes podem parar de usar o nó mesmo após o MemoryDB ter substituído o nó. Neste caso, o aplicativo deve atualizar a lista de servidores quando esse evento ocorrer. |
| MemoryDB:CreateClusterComplete | "Cluster created" | O cluster foi criado com sucesso. |
| MemoryDB:CreateClusterFailed | "Failed to create cluster due to unsuccessful creation of its node(s)." e da "Deleting all nodes belonging to this cluster." | O cluster não foi criado. |
| MemoryDB:DeleteClusterComplete | "Cluster deleted." | A exclusão de um cluster e todos os nós associados foi concluída. |
| MemoryDB:FailoverComplete | `"Failover to replica node %s completed"` | O failover para um nó de réplica foi bem-sucedido. |
| MemoryDB:NodeReplacementCanceled | "The replacement of node %s which was scheduled during the maintenance window from start time: %s, end time: %s has been canceled" | Um nó no seu cluster que estava programado para substituição já não está programado para substituição. |
| MemoryDB:NodeReplacementRescheduled | "The replacement in maintenance window for node %s has been re-scheduled from previous start time: %s, previous end time: %s to new start time: %s, new end time: %s" | Um nó no seu cluster previamente programado para substituição foi reprogramado para substituição durante a nova janela descrita na notificação. Para obter informações sobre quais ações você pode realizar, consulte [Substituição de nós](nodes.nodereplacement.md). |
| MemoryDB:NodeReplacementScheduled | "The node %s is scheduled for replacement during the maintenance window from start time: %s to end time: %s" | Um nó no seu cluster está programado para substituição durante a janela descrita na notificação. Para obter informações sobre quais ações você pode realizar, consulte [Substituição de nós](nodes.nodereplacement.md). |
| MemoryDB:RemoveNodeComplete | "Removed node %s" | Um nó foi removido do cluster. |
| MemoryDB:SnapshotComplete | "Snapshot %s succeeded for node %s" | Um snapshot foi concluído com sucesso. |
| MemoryDB:SnapshotFailed | "Snapshot %s failed for node %s" | O snapshot falhou. Consulte os eventos do cluster para obter mais detalhes sobre a causa. Se você descrever o snapshot, consulte [DescribeSnapshots](https://docs.aws.amazon.com/memorydb/latest/APIReference/API_DescribeSnapshots.html), o status será `failed`. |