View a markdown version of this page

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.

when (opcional)

Expresión condicional de procesador. Si se especifica, se omite todo el procesador si la expresión se evalúa como falsa. La longitud máxima es de 256 caracteres. Consulte Sintaxis de expresiones para el procesamiento condicional.

entries[].when (opcional)

Expresión condicional de entrada. Si se especifica, solo se omite esta entrada si la expresión se evalúa como falsa. La longitud máxima es de 256 caracteres. Consulte Sintaxis de expresiones para el procesamiento condicional.

entries[].when_else (opcional)

Entrada alternativa que se pone en marcha solo cuando ninguna de las otras condiciones when del mismo procesador se cumplió. El valor de la expresión identifica qué condiciones when se deben tener en cuenta. La longitud máxima es de 256 caracteres. Consulte Sintaxis de expresiones para el procesamiento condicional.

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.

when (opcional)

Expresión condicional de procesador. Si se especifica, se omite todo el procesador si la expresión se evalúa como falsa. La longitud máxima es de 256 caracteres. Consulte Sintaxis de expresiones para el procesamiento condicional.

entries[].when (opcional)

Expresión condicional de entrada. Si se especifica, solo se omite esta entrada si la expresión se evalúa como falsa. La longitud máxima es de 256 caracteres. Consulte Sintaxis de expresiones para el procesamiento condicional.

entries[].when_else (opcional)

Entrada alternativa que se pone en marcha solo cuando ninguna de las otras condiciones when del mismo procesador se cumplió. El valor de la expresión identifica qué condiciones when se deben tener en cuenta. La longitud máxima es de 256 caracteres. Consulte Sintaxis de expresiones para el procesamiento condicional.

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.

when (opcional)

Expresión condicional que determina si este procesador se pone en marcha. La longitud máxima es de 256 caracteres. Consulte Sintaxis de expresiones para el procesamiento condicional.

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.

when (opcional)

Expresión condicional de procesador. Si se especifica, se omite todo el procesador si la expresión se evalúa como falsa. La longitud máxima es de 256 caracteres. Consulte Sintaxis de expresiones para el procesamiento condicional.

entries[].when (opcional)

Expresión condicional de entrada. Si se especifica, solo se omite esta entrada si la expresión se evalúa como falsa. La longitud máxima es de 256 caracteres. Consulte Sintaxis de expresiones para el procesamiento condicional.

entries[].when_else (opcional)

Entrada alternativa que se pone en marcha solo cuando ninguna de las otras condiciones when del mismo procesador se cumplió. El valor de la expresión identifica qué condiciones when se deben tener en cuenta. La longitud máxima es de 256 caracteres. Consulte Sintaxis de expresiones para el procesamiento condicional.

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.

when (opcional)

Expresión condicional que determina si este procesador se pone en marcha. La longitud máxima es de 256 caracteres. Consulte Sintaxis de expresiones para el procesamiento condicional.