View a markdown version of this page

Entrega de logs - Amazônia ElastiCache
Conteúdo de uma entrada de log lentoConteúdo de uma entrada de log do mecanismoPermissões para configurar os logsEspecificações de tipo de log e formato de log

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á.

Entrega de logs

nota

O envio de logs não é compatível com caches com tecnologia sem servidor.

O log lento é compatível com o Valkey 7.x e versões posteriores, e clusters e grupos de replicação do Redis OSS que usam o mecanismo versão 6.0 em diante.

O log do mecanismo é compatível com clusters e grupos de replicação do Valkey 7.x e superiores e do Redis OSS que usam o mecanismo versão 6.2 em diante.

A entrega de logs permite que você transmita SLOWLOG ou log do mecanismo para um de dois destinos:

  • Amazon Data Firehose

  • CloudWatch Registros da Amazon

Você ativa e configura a entrega de registros ao criar ou modificar um cluster usando ElastiCache APIs. Cada entrada de log será entregue ao destino especificado em um dos dois formatos: JSON ou TEXT.

Um número fixo de entradas de log lento são recuperados periodicamente do mecanismo. Dependendo do valor especificado para o parâmetro do mecanismo slowlog-max-len, é possível que entradas de log lentas adicionais não sejam entregues no destino.

Você pode optar por alterar as configurações de entrega ou desativar a entrega de registros a qualquer momento usando o AWS console ou uma das APIs de modificação, modificy-cache-cluster ou https://docs.aws.amazon.com/cli/latest/reference/elasticache/modify-cache-cluster.html modify-replication-group. https://docs.aws.amazon.com/cli/latest/reference/elasticache/modify-replication-group.html

Você deve definir o parâmetro apply-immediately para todas as modificações de entrega de log.

nota

As cobranças do Amazon CloudWatch Logs são aplicadas quando a entrega de registros está habilitada, mesmo quando os registros são entregues diretamente ao Amazon Data Firehose. Para obter mais informações, consulte a seção Vended Logs em CloudWatch Preços https://aws.amazon.com/cloudwatch/pricing/ da Amazon.

Conteúdo de uma entrada de log lento

O log lento contém as seguintes informações:

  • CacheClusterId— O ID do cluster

  • CacheNodeId— O ID do nó de cache

  • Id: um identificador progressivo exclusivo para cada entrada de log lento

  • Timestamp: O timestamp do Unix no qual o comando registrado foi processado

  • Duration (Duração): a quantidade de tempo necessário para sua execução, em microssegundos

  • Command (Comando: o comando usado pelo cliente. Por exemplo, set foo bar onde foo está a chave e bar é o valor. ElastiCache substitui o nome e o valor reais da chave por (2 more arguments) para evitar a exposição de dados confidenciais.

  • ClientAddress— Endereço IP e porta do cliente

  • ClientName— Nome do cliente, se definido por meio do CLIENT SETNAME comando

Conteúdo de uma entrada de log do mecanismo

ElastiCache fornece um subconjunto selecionado de eventos de registro do mecanismo, não o conjunto completo de todos os registros internos do mecanismo. Somente eventos operacionais significativos, como replicação, snapshots, integridade do cluster e scripts, estão incluídos nos registros entregues.

Os registros do mecanismo são projetados para excluir dados confidenciais. Informações privadas, como endereços IP, IDs de processos, caminhos de arquivos e corpos de scripts, são editadas antes da entrega. Nenhum dado de usuário, senha, token de autenticação, nome de chave ou valor aparece em nenhuma entrada de registro emitida.

O ElastiCache Engine Log contém as seguintes informações:

  • CacheClusterId— O ID do cluster

  • CacheNodeId— O ID do nó de cache

  • Nível de registro — LogLevel pode ser um dos seguintes:VERBOSE("-"),NOTICE("*"),WARNING("#").

  • Time (Hora) - O horário UTC da mensagem registrada. A hora está no seguinte formato: "DD MMM YYYY hh:mm:ss.ms UTC"

  • Role (Função) - Função do nó de onde o log é emitido. Pode ser uma das seguintes opções: “M” para Primária, “S” para réplica, “C” para escrever um processo infantil em que está trabalhando RDB/AOF ou “X” para sentinela.

  • Mensagem: mensagem de log do mecanismo.

Permissões para configurar os logs

Você precisa incluir as seguintes permissões do IAM em sua user/role política do IAM:

  • logs:CreateLogDelivery

  • logs:UpdateLogDelivery

  • logs:DeleteLogDelivery

  • logs:GetLogDelivery

  • logs:ListLogDeliveries

Para obter mais informações, consulte Visão geral do gerenciamento de acesso: permissões e políticas.

Especificações de tipo de log e formato de log

Log lento

O log lento suporta JSON e TEXT

O exemplo a seguir mostra um exemplo de formato JSON.

{
  "CacheClusterId": "logslowxxxxmsxj", 
  "CacheNodeId": "0001", 
  "Id": 296, 
  "Timestamp": 1605631822, 
  "Duration (us)": 0, 
  "Command": "GET ... (1 more arguments)", 
  "ClientAddress": "192.168.12.104:55452", 
  "ClientName": "logslowxxxxmsxj##" 
}

O exemplo a seguir mostra um exemplo de formato TEXT.

logslowxxxxmsxj,0001,1605631822,30,GET ... (1 more arguments),192.168.12.104:55452,logslowxxxxmsxj##

Log do mecanismo

O log do mecanismo é compatível com JSON e TEXT

O exemplo a seguir mostra um exemplo de formato JSON.

{ 
  "CacheClusterId": "xxxxxxxxxzy-engine-log-test", 
  "CacheNodeId": "0001", 
  "LogLevel": "VERBOSE", 
  "Role": "M", 
  "Time": "12 Nov 2020 01:28:57.994 UTC", 
  "Message": "Replica is waiting for next BGSAVE before synchronizing with the primary. Check back later" 
}

O exemplo a seguir mostra um exemplo de formato TEXT.

xxxxxxxxxxxzy-engine-log-test/0001:M 29 Oct 2020 20:12:20.499 UTC * A slow-running Lua script detected that is still in execution after 1000 microseconds.