Procesadores de transformación - Amazon CloudWatch
Procesador add_entriesProcesador copy_valuesProcesador delete_entriesProcesador move_keysProcesador flatten

Procesadores de transformación

Los procesadores de transformación modifican la estructura de los eventos del registro mediante la adición, la copia, el desplazamiento o la eliminación de campos.

Procesador add_entries

Agrega pares clave-valor estáticos a eventos de registro. Se puede agregar un máximo de 1 procesador add_entries a una canalización.

Configuración

Configure el procesador add_entries con los siguientes parámetros:

processor:
  - add_entries:
      entries:
        - key: "environment"
          value: "production"
          overwrite_if_key_exists: false
Parameters
entries (obligatorio)

Matriz de pares clave-valor que se agregarán a cada evento de registro.

entries[].key (obligatorio)

Nombre del campo que se agregará al evento de registro. Admite campos anidados mediante notación de puntos.

entries[].value (obligatorio)

Valor estático que se asignará a la clave.

entries[].overwrite_if_key_exists (opcional)

Indicador booleano que determina el comportamiento cuando la clave ya existe. El valor predeterminado es falso.

Procesador copy_values

Copia valores de un campo a otro. Se puede agregar un máximo de 1 procesador copy_values a una canalización.

Configuración

Configure el procesador copy_values con los siguientes parámetros:

processor:
  - copy_values:
      entries:
        - from_key: "user_id"
          to_key: "backup_user"
          overwrite_if_to_key_exists: false
Parameters
entries (obligatorio)

Matriz de operaciones de copia que se llevarán a cabo en cada evento de registro.

entries[].from_key (obligatorio)

Nombre del campo desde el que se copiará el valor. Utiliza la notación de puntos para campos anidados.

entries[].to_key (obligatorio)

Nombre del campo al que se copiará el valor. Creará estructuras anidadas si se utiliza la notación de puntos.

entries[].overwrite_if_to_key_exists (opcional)

Indicador booleano que controla el comportamiento cuando el campo de destino ya existe. El valor predeterminado es falso.

Procesador delete_entries

Elimina los campos especificados de los eventos de registro.

Configuración

Configure el procesador delete_entries con los siguientes parámetros:

processor:
  - delete_entries:
      with_keys: ["temp_field", "debug_info"]
Parameters
with_keys (obligatorio)

Matriz de nombres de campos que se eliminarán de cada evento de registro. Admite la eliminación de campos anidados mediante la notación de puntos.

Procesador move_keys

Desplaza campos de una ubicación a otra.

Configuración

Configure el procesador move_keys con los siguientes parámetros:

processor:
  - move_keys:
      entries:
        - from_key: "old_field"
          to_key: "new_field"
          overwrite_if_to_key_exists: true
Parameters
entries (obligatorio)

Matriz de operaciones de desplazamiento. Número máximo de entradas: 5.

entries[].from_key (obligatorio)

Nombre del campo de origen. 128 caracteres como máximo.

entries[].to_key (obligatorio)

Nombre del campo de destino. 128 caracteres como máximo.

entries[].overwrite_if_to_key_exists (opcional)

Si se debe sobrescribir el campo de destino existente.

Procesador flatten

Aplana estructuras de objetos anidados.

Configuración

Configure el procesador flatten con los siguientes parámetros:

processor:
  - flatten:
      source: "metadata"
      target: "flattened"
      remove_processed_fields: true
      exclude_keys: ["sensitive_data"]
Parameters
source (obligatorio)

Campo que contiene el objeto anidado que aplanará.

target (obligatorio)

Prefijo del campo de destino para claves aplanadas.

remove_processed_fields (opcional)

Si se debe eliminar el campo anidado original después del aplanamiento.

exclude_keys (opcional)

Matriz de claves que se excluirán del aplanamiento. Máximo de 20 claves, cada una de hasta 128 caracteres.