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á. # Monitoramento de eventos do ElastiCache pelo Amazon SNS Quando ocorrem eventos significativos para um cluster, o ElastiCache 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** + [Gerenciando ElastiCache notificações do Amazon SNS](ECEvents.SNS.md) + [Visualizando ElastiCache eventos](ECEvents.Viewing.md) + [Notificações de eventos e o Amazon SNS](ElastiCacheSNS.md) # Gerenciando ElastiCache notificações do Amazon SNS Você pode configurar o ElastiCache envio de notificações para 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/). Por padrão, `API modify-replication-group` afeta todos os grupos em uma região e não apenas o grupo especificado atualmente. Se você quiser configurar um grupo específico em uma região de forma diferente dos outros grupos, você pode usar a opção `--notification-topic-arn` para criar um tópico separado para esse grupo. ## 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 AWS console AWS CLI, o ou a ElastiCache API. ### 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. Ao usar o Valkey ou o Redis OSS para adicionar um tópico do Amazon SNS para um grupo de replicação na etapa 2, em vez de escolher um cluster, escolha um grupo de replicação. Em seguida, siga as mesmas etapas restantes. **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 ElastiCache console em [ https://console.aws.amazon.com/elasticache/](https://console.aws.amazon.com/elasticache/). 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 (AWS CLI) Para adicionar ou modificar um tópico do Amazon SNS para um cluster, use o AWS CLI comando. `modify-cache-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 elasticache modify-cache-cluster \ --cache-cluster-id my-cluster \ --notification-topic-arn arn:aws:sns:us-west-2:123456789xxx:ElastiCacheNotifications ``` Para Windows: ``` aws elasticache modify-cache-cluster ^ --cache-cluster-id my-cluster ^ --notification-topic-arn arn:aws:sns:us-west-2:123456789xx:ElastiCacheNotifications ``` Para obter mais informações, consulte [modify-cache-cluster](https://docs.aws.amazon.com/cli/latest/reference/elasticache/modify-cache-cluster.html). ### Adicionar um tópico do Amazon SNS (API) ElastiCache Para adicionar ou modificar um tópico do Amazon SNS para um cluster, chame a ação `ModifyCacheCluster` com os seguintes parâmetros: + `CacheClusterId``=my-cluster` + `TopicArn``=arn%3Aaws%3Asns%3Aus-west-2%3A565419523791%3AElastiCacheNotifications` **Example** ``` 1. https://elasticache.amazon.com/ 2. ?Action=ModifyCacheCluster 3. &ApplyImmediately=false 4. &CacheClusterId=my-cluster 5. &NotificationTopicArn=arn%3Aaws%3Asns%3Aus-west-2%3A565419523791%3AElastiCacheNotifications 6. &Version=2014-12-01 7. &SignatureVersion=4 8. &SignatureMethod=HmacSHA256 9. &Timestamp=20141201T220302Z 10. &X-Amz-Algorithm=&AWS;4-HMAC-SHA256 11. &X-Amz-Date=20141201T220302Z 12. &X-Amz-SignedHeaders=Host 13. &X-Amz-Expires=20141201T220302Z 14. &X-Amz-Credential= 15. &X-Amz-Signature= ``` Para obter mais informações, consulte [ModifyCacheCluster](https://docs.aws.amazon.com/AmazonElastiCache/latest/APIReference/API_ModifyCacheCluster.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 desativar 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 ElastiCache console em [ https://console.aws.amazon.com/elasticache/](https://console.aws.amazon.com/elasticache/). 1. Para ver uma lista dos clusters que estão executando o Memcached, no painel de navegação, escolha **Memcached**. Para ver uma lista dos clusters que estão executando o Valkey ou o Redis OSS, no painel de navegação, selecione **Valkey** ou **Redis OSS**. 1. Escolha a caixa à esquerda do nome do cluster para o qual você deseja modificar notificações. 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 (AWS CLI) Para desabilitar notificações do Amazon SNS, use o comando `modify-cache-cluster` com os seguintes parâmetros: Para Linux, macOS ou Unix: ``` aws elasticache modify-cache-cluster \ --cache-cluster-id my-cluster \ --notification-topic-status inactive ``` Para Windows: ``` aws elasticache modify-cache-cluster ^ --cache-cluster-id my-cluster ^ --notification-topic-status inactive ``` **nota** Quando o cluster pertence a um grupo de replicação, você deve usar o comando `modify-replication-group` da CLI para habilitar ou desabilitar as notificações do SNS. ### Ativando e desativando as notificações ElastiCache do Amazon SNS (API) Para desabilitar notificações do Amazon SNS, chame a ação `ModifyCacheCluster` com os seguintes parâmetros: + `CacheClusterId``=my-cluster` + `NotificationTopicStatus``=inactive` Essa chamada retorna uma saída semelhante à seguinte: **Example** ``` 1. https://elasticache.us-west-2.amazonaws.com/ 2. ?Action=ModifyCacheCluster 3. &ApplyImmediately=false 4. &CacheClusterId=my-cluster 5. &NotificationTopicStatus=inactive 6. &Version=2014-12-01 7. &SignatureVersion=4 8. &SignatureMethod=HmacSHA256 9. &Timestamp=20141201T220302Z 10. &X-Amz-Algorithm=&AWS;4-HMAC-SHA256 11. &X-Amz-Date=20141201T220302Z 12. &X-Amz-SignedHeaders=Host 13. &X-Amz-Expires=20141201T220302Z 14. &X-Amz-Credential= 15. &X-Amz-Signature= ``` # Visualizando ElastiCache eventos ElastiCache registra eventos relacionados às suas instâncias de cluster, 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. Você pode recuperar facilmente os eventos do registro usando o ElastiCache console, o AWS CLI`describe-events` comando ou a ação `DescribeEvents` da ElastiCache API. Os procedimentos a seguir mostram como visualizar todos os ElastiCache eventos das últimas 24 horas (1440 minutos). ## Visualizando ElastiCache eventos (Console) O procedimento a seguir exibe eventos usando o ElastiCache console. **Para visualizar eventos usando o ElastiCache console** 1. Faça login no Console de gerenciamento da AWS e abra o ElastiCache console em [ https://console.aws.amazon.com/elasticache/](https://console.aws.amazon.com/elasticache/). 1. Para ver uma lista de todos os eventos disponíveis, no painel de navegação, escolha **Eventos**. Na tela *Eventos*, cada linha da lista representa um evento e exibe a origem do evento, o tipo de evento (cache-cluster, cache-parameter-group, cache-security-group, ou cache-subnet-group), a hora GMT do evento e uma 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 ElastiCache eventos (AWS CLI) Para gerar uma lista de ElastiCache eventos usando o 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 elasticache describe-events --source-type cache-cluster --max-items 40 ``` O código a seguir lista todos os eventos nas últimas 24 horas (1440 minutos). ``` aws elasticache describe-events --source-type cache-cluster --duration 1440 ``` A saída do comando `describe-events` é semelhante a esta. ``` aws elasticache describe-events --source-type cache-cluster --max-items 40 { "Events": [ { "SourceIdentifier": "my-mem-cluster", "SourceType": "cache-cluster", "Message": "Finished modifying number of nodes from 1 to 3", "Date": "2020-06-09T02:01:21.772Z" }, { "SourceIdentifier": "my-mem-cluster", "SourceType": "cache-cluster", "Message": "Added cache node 0002 in availability zone us-west-2a", "Date": "2020-06-09T02:01:21.716Z" }, { "SourceIdentifier": "my-mem-cluster", "SourceType": "cache-cluster", "Message": "Added cache node 0003 in availability zone us-west-2a", "Date": "2020-06-09T02:01:21.706Z" }, { "SourceIdentifier": "my-mem-cluster", "SourceType": "cache-cluster", "Message": "Increasing number of requested nodes", "Date": "2020-06-09T01:58:34.178Z" }, { "SourceIdentifier": "mycluster-0003-004", "SourceType": "cache-cluster", "Message": "Added cache node 0001 in availability zone us-west-2c", "Date": "2020-06-09T01:51:14.120Z" }, { "SourceIdentifier": "mycluster-0003-004", "SourceType": "cache-cluster", "Message": "This cluster does not support persistence (ex: 'appendonly'). Please use a different instance type to enable persistence.", "Date": "2020-06-09T01:51:14.095Z" }, { "SourceIdentifier": "mycluster-0003-004", "SourceType": "cache-cluster", "Message": "Cache cluster created", "Date": "2020-06-09T01:51:14.094Z" }, { "SourceIdentifier": "mycluster-0001-005", "SourceType": "cache-cluster", "Message": "Added cache node 0001 in availability zone us-west-2b", "Date": "2020-06-09T01:42:55.603Z" }, { "SourceIdentifier": "mycluster-0001-005", "SourceType": "cache-cluster", "Message": "This cluster does not support persistence (ex: 'appendonly'). Please use a different instance type to enable persistence.", "Date": "2020-06-09T01:42:55.576Z" }, { "SourceIdentifier": "mycluster-0001-005", "SourceType": "cache-cluster", "Message": "Cache cluster created", "Date": "2020-06-09T01:42:55.574Z" }, { "SourceIdentifier": "mycluster-0001-004", "SourceType": "cache-cluster", "Message": "Added cache node 0001 in availability zone us-west-2b", "Date": "2020-06-09T01:28:40.798Z" }, { "SourceIdentifier": "mycluster-0001-004", "SourceType": "cache-cluster", "Message": "This cluster does not support persistence (ex: 'appendonly'). Please use a different instance type to enable persistence.", "Date": "2020-06-09T01:28:40.775Z" }, { "SourceIdentifier": "mycluster-0001-004", "SourceType": "cache-cluster", "Message": "Cache cluster created", "Date": "2020-06-09T01:28:40.773Z" } ] } ``` 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/elasticache/describe-events.html](https://docs.aws.amazon.com/cli/latest/reference/elasticache/describe-events.html). ## Visualização de ElastiCache eventos (ElastiCache API) Para gerar uma lista de ElastiCache eventos usando a ElastiCache API, use a `DescribeEvents` ação. 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 de cache mais recentes. ``` https://elasticache.us-west-2.amazonaws.com/ ?Action=DescribeEvents &MaxRecords=40 &SignatureVersion=4 &SignatureMethod=HmacSHA256 &SourceType=cache-cluster &Timestamp=20150202T192317Z &Version=2015-02-02 &X-Amz-Credential= ``` O código a seguir lista os eventos de cluster de cache nas últimas 24 horas (1440 minutos). ``` https://elasticache.us-west-2.amazonaws.com/ ?Action=DescribeEvents &Duration=1440 &SignatureVersion=4 &SignatureMethod=HmacSHA256 &SourceType=cache-cluster &Timestamp=20150202T192317Z &Version=2015-02-02 &X-Amz-Credential= ``` As ações acima devem produzir uma saída semelhante à seguinte. ``` Cache cluster created cache-cluster 2015-02-02T18:22:18.202Z mem01 (...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/AmazonElastiCache/latest/APIReference/API_DescribeEvents.html](https://docs.aws.amazon.com/AmazonElastiCache/latest/APIReference/API_DescribeEvents.html). # Notificações de eventos e o Amazon SNS ElastiCache pode publicar mensagens usando o Amazon Simple Notification Service (SNS) quando eventos significativos acontecem em um cluster. Esse recurso pode ser usado para atualizar as listas de servidores em máquinas clientes conectadas a endpoints de nó de cache individuais de um cluster de cache. **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: + Somente um tópico pode ser configurado para ElastiCache notificações. + A AWS conta proprietária do tópico do Amazon SNS deve ser a mesma conta que possui o cluster no qual as notificações estão habilitadas. + O tópico do Amazon SNS no qual você está publicando não pode ser criptografado. **nota** É possível anexar um tópico criptografado (em repouso) do Amazon SNS ao cluster. No entanto, o status do tópico no ElastiCache console será exibido como inativo, o que efetivamente dissocia o tópico do cluster ao enviar mensagens para ElastiCache o tópico. + O tópico do Amazon SNS precisa estar na mesma região do cluster. ElastiCache ## ElastiCache Eventos Os ElastiCache eventos a seguir acionam as notificações do Amazon SNS. Para obter informações sobre detalhes de eventos, consulte [Visualizando ElastiCache eventos](ECEvents.Viewing.md). | Nome do evento | Mensagem | Description | | --- | --- | --- | | ElastiCache:AddCacheNodeComplete | ElastiCache:AddCacheNodeComplete : cache-cluster | Um nó de cache foi adicionado ao cluster e está pronto para uso. | | ElastiCache: AddCacheNodeFailed devido à insuficiência de endereços IP gratuitos | ElastiCache:AddCacheNodeFailed : cluster-name | Um nó de cache não pôde ser adicionado porque não há o endereços IP suficientes disponíveis. | | ElastiCache:CacheClusterParametersChanged | ElastiCache:CacheClusterParametersChanged : cluster-name | Um ou mais parâmetros de cluster foram alterados. | | ElastiCache:CacheClusterProvisioningComplete | ElastiCache:CacheClusterProvisioningComplete cluster-name-0001-005 | O provisionamento de um cluster está concluído, e os nós de cache no cluster de cache estão prontos para uso. | | ElastiCache: CacheClusterProvisioningFailed devido ao estado de rede incompatível | ElastiCache:CacheClusterProvisioningFailed : cluster-name | Foi feita uma tentativa de executar um novo cluster em uma nuvem privada virtual (VPC) inexistente. | | ElastiCache:CacheClusterScalingComplete | `CacheClusterScalingComplete : cluster-name` | Escalabilidade para cluster de cache concluída com êxito. | | ElastiCache:CacheClusterScalingFailed | ElastiCache:CacheClusterScalingFailed : *cluster-name* | A operação de expansão no cluster de cache falhou. | | ElastiCache:CacheClusterSecurityGroupModified | ElastiCache:CacheClusterSecurityGroupModified : cluster-name | Um dos seguintes eventos ocorreu: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/AmazonElastiCache/latest/dg/ElastiCacheSNS.html) | | ElastiCache:CacheNodeReplaceStarted | ElastiCache:CacheNodeReplaceStarted : cluster-name | ElastiCache detectou que o host que executa um nó de cache está degradado ou inacessível e começou a substituir o nó de cache. A entrada de DNS para o nó de cache 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 cliente de cache podem parar de usar o nó de cache mesmo após ElastiCache a substituição do nó de cache; nesse caso, o aplicativo deve atualizar a lista de servidores quando esse evento ocorrer. | | ElastiCache:CacheNodeReplaceComplete | ElastiCache:CacheNodeReplaceComplete : cluster-name | ElastiCache detectou que o host que executa um nó de cache está degradado ou inacessível e concluiu a substituição do nó de cache. A entrada de DNS para o nó de cache 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 cliente de cache podem parar de usar o nó de cache mesmo após ElastiCache a substituição do nó de cache; nesse caso, o aplicativo deve atualizar a lista de servidores quando esse evento ocorrer. | | ElastiCache:CacheNodesRebooted | ElastiCache:CacheNodesRebooted : cluster-name | Um ou mais nós de cache foram reinicializados. Mensagem (Memcached): `"Cache node %s shutdown"` Em seguida, uma segunda mensagem: `"Cache node %s restarted"` | | ElastiCache: CertificateRenewalComplete (Somente Valkey ou Redis OSS) | ElastiCache:CertificateRenewalComplete | O certificado CA da Amazon foi renovado com êxito. | | ElastiCache:CreateReplicationGroupComplete | ElastiCache:CreateReplicationGroupComplete : cluster-name | O grupo de replicação foi criado com sucesso. | | ElastiCache:DeleteCacheClusterComplete | ElastiCache:DeleteCacheClusterComplete : cluster-name | A exclusão de um cluster e todos os nós de cache associados foi concluída. | | ElastiCache: FailoverComplete (Somente Valkey ou Redis OSS) | `ElastiCache:FailoverComplete : mycluster` | O failover para um nó de réplica foi bem-sucedido. | | ElastiCache:ReplicationGroupIncreaseReplicaCountFinished | ElastiCache:ReplicationGroupIncreaseReplicaCountFinished : cluster-name-0001-005 | O número de réplicas no cluster foi aumentado. | | ElastiCache:ReplicationGroupIncreaseReplicaCountStarted | ElastiCache:ReplicationGroupIncreaseReplicaCountStarted : cluster-name-0003-004 | O processo de adição de réplicas ao cluster começou. | | ElastiCache:NodeReplacementCanceled | ElastiCache:NodeReplacementCanceled : cluster-name | Um nó no seu cluster que estava programado para substituição já não está programado para substituição. | | ElastiCache:NodeReplacementRescheduled | ElastiCache:NodeReplacementRescheduled : cluster-name | 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 (Valkey e Redis OSS)](CacheNodes.NodeReplacement.md). | | ElastiCache:NodeReplacementScheduled | ElastiCache:NodeReplacementScheduled : cluster-name | 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 (Valkey e Redis OSS)](CacheNodes.NodeReplacement.md). | | ElastiCache:RemoveCacheNodeComplete | ElastiCache:RemoveCacheNodeComplete : cluster-name | Um nó de cache foi removido do cluster. | | ElastiCache:ReplicationGroupScalingComplete | `ElastiCache:ReplicationGroupScalingComplete : cluster-name` | A operação de expansão no grupo de replicação foi concluída com sucesso. | | ElastiCache:ReplicationGroupScalingFailed | `"Failed applying modification to cache node type to %s."` | A operação de expansão no grupo de replicação falhou. | | ElastiCache:ServiceUpdateAvailableForNode | `"Service update is available for cache node %s."` | Uma atualização de autoatendimento está disponível para o nó. | | ElastiCache: SnapshotComplete (Somente Valkey ou Redis OSS) | ElastiCache:SnapshotComplete : cluster-name | Um snapshot de cache foi concluído com sucesso. | | ElastiCache: SnapshotFailed (Somente Valkey ou Redis OSS) | SnapshotFailed : cluster-name | Um snapshot de cache falhou. Consulte os eventos de cache do cluster para mais uma causa detalhada. Se você descrever o snapshot, consulte [https://docs.aws.amazon.com/AmazonElastiCache/latest/APIReference/API_DescribeSnapshots.html](https://docs.aws.amazon.com/AmazonElastiCache/latest/APIReference/API_DescribeSnapshots.html), o status será `failed`. | ## Tópicos relacionados + [Visualizando ElastiCache eventos](ECEvents.Viewing.md)