Processadores de transformação - Amazon CloudWatch
Processador add_entriesProcessador copy_valuesProcessador delete_entriesProcessador move_keysProcessador flatten

Processadores de transformação

Os processadores de transformação modificam a estrutura dos eventos de log adicionando, copiando, movendo ou removendo campos.

Processador add_entries

Adiciona pares estáticos de chave-valor aos eventos de logs. No máximo 1 processador add_entries pode ser adicionado a um pipeline.

Configuração

Configure o processador add_entries com os seguintes parâmetros:

processor:
  - add_entries:
      entries:
        - key: "environment"
          value: "production"
          overwrite_if_key_exists: false
Parâmetros
entries (obrigatório)

Uma matriz de pares de chave-valor a serem adicionados a cada evento de log.

entries[].key (obrigatório)

O nome do campo a ser adicionado ao evento de log. Permite campos aninhados usando a notação de pontos.

entries[].value (obrigatório)

O valor estático a ser atribuído à chave.

entries[].overwrite_if_key_exists (opcional)

Sinalizador booleano que determina o comportamento quando a chave já existe. O padrão é falso.

Processador copy_values

Copia valores de um campo para outro. No máximo 1 processador copy_values pode ser adicionado a um pipeline.

Configuração

Configure o processador copy_values com os seguintes parâmetros:

processor:
  - copy_values:
      entries:
        - from_key: "user_id"
          to_key: "backup_user"
          overwrite_if_to_key_exists: false
Parâmetros
entries (obrigatório)

Matriz de operações de cópia a serem executadas em cada evento de log.

entries[].from_key (obrigatório)

O nome do campo do qual o valor será copiado. Usa notação de pontos para campos aninhados.

entries[].to_key (obrigatório)

O nome do campo para o qual o valor será copiado. Criará estruturas aninhadas se a notação de pontos for usada.

entries[].overwrite_if_to_key_exists (opcional)

Sinalizador booleano que controla o comportamento quando o campo de destino já existe. O padrão é falso.

Processador delete_entries

Remove campos especificados dos eventos de logs.

Configuração

Configure o processador de delete_entries com os seguintes parâmetros:

processor:
  - delete_entries:
      with_keys: ["temp_field", "debug_info"]
Parâmetros
with_keys (obrigatório)

Matriz de nomes de campo a serem removidos de cada evento de log. Permite a exclusão de campos aninhados usando notação de pontos.

Processador move_keys

Move campos de um local para outro.

Configuração

Configure o processador move_keys com os seguintes parâmetros:

processor:
  - move_keys:
      entries:
        - from_key: "old_field"
          to_key: "new_field"
          overwrite_if_to_key_exists: true
Parâmetros
entries (obrigatório)

Matriz de operações de movimentação. Máximo de 5 entradas.

entries[].from_key (obrigatório)

Nome do campo de origem. Máximo de 128 caracteres.

entries[].to_key (obrigatório)

Nome de campo de destino. Máximo de 128 caracteres.

entries[].overwrite_if_to_key_exists (opcional)

Se o campo de destino existente deve ou não ser substituído.

Processador flatten

Nivela estruturas de objetos aninhados.

Configuração

Configure o processador flatten com os seguintes parâmetros:

processor:
  - flatten:
      source: "metadata"
      target: "flattened"
      remove_processed_fields: true
      exclude_keys: ["sensitive_data"]
Parâmetros
source (obrigatório)

Campo contendo objeto aninhado a ser nivelado.

target (obrigatório)

Prefixo do campo de destino para chaves niveladas.

remove_processed_fields (opcional)

Se o campo aninhado original deve ou não ser removido após o nivelamento.

exclude_keys (opcional)

Matriz de chaves a serem excluídas do nivelamento. Máximo de 20 chaves, cada uma com até 128 caracteres.