Procesador Edit Fields

Este producto no es compatible con el sitio Datadog seleccionado. ().
Disponible para:

Registros

Descripción general

El procesador Edit Fields puede agregar, eliminar o cambiar el nombre de campos dentro de sus datos de registro. Use este procesador para enriquecer sus registros con contexto adicional, eliminar campos de bajo valor para reducir el volumen y estandarizar los nombres en atributos importantes. Seleccione add field, drop field o rename field en el menú desplegable para comenzar.

Consulte la guía Remap Reserved Attributes sobre cómo usar el procesador Edit Fields para reasignar atributos.

Configuración

Agregar campo

Use add field para añadir un nuevo campo de clave-valor a su registro.

Para configurar el procesador de adición de campos:

  1. Defina un filter query. Solo se procesan los registros que coinciden con la consulta de filtro especificada. Todos los registros, independientemente de si coinciden o no con la consulta de filtro, se envían al siguiente paso de la canalización. Consulte Sintaxis de búsqueda para obtener más información.
  2. Ingrese el campo y el valor que desea agregar. Para especificar un campo anidado para su clave, use la notación de ruta: <OUTER_FIELD>.<INNER_FIELD>. Todos los valores se almacenan como cadenas. Nota: Si el campo que desea agregar ya existe, el Worker registra un error en el registro y el campo existente permanece sin cambios.

Eliminar campo

Use drop field para eliminar un campo de los datos de registro que coincidan con el filtro que especifique a continuación. Puede eliminar objetos, por lo que puede usar el procesador para eliminar claves anidadas.

Para configurar el procesador de eliminación de campos:

  1. Defina un filter query. Solo se procesan los registros que coinciden con la consulta de filtro especificada. Todos los registros, independientemente de si coinciden o no con la consulta de filtro, se envían al siguiente paso de la canalización. Consulte Sintaxis de búsqueda para obtener más información.
  2. Ingrese la clave del campo que desea eliminar. Para especificar un campo anidado para la clave especificada, use la notación de ruta: <OUTER_FIELD>.<INNER_FIELD>. Nota: Si la clave especificada no existe, su registro no se verá afectado.

Renombrar campo

Utilice rename field para renombrar un campo dentro de su registro.

Para configurar el procesador de renombrado de campos:

  1. Defina un filter query. Solo se procesan los registros que coinciden con la consulta de filtro especificada. Todos los registros, independientemente de si coinciden o no con la consulta de filtro, se envían al siguiente paso de la canalización. Consulte Sintaxis de búsqueda para obtener más información.
  2. Ingrese el nombre del campo que desea renombrar en el Source field. Para especificar un campo anidado para su clave, utilice la notación de ruta: <OUTER_FIELD>.<INNER_FIELD>. Después de renombrarlo, su campo original se elimina a menos que habilite la casilla de verificación Preserve source tag descrita a continuación.
    Nota: Si la clave de fuente que especifica no existe, se aplica un valor null predeterminado a su destino.
  3. En el Target field, ingrese el nombre al que desea que se renombre el campo de fuente. Para especificar un campo anidado para su clave especificada, utilice la notación de ruta: <OUTER_FIELD>.<INNER_FIELD>.
    Nota: Si el campo de destino que especifica ya existe, el Worker registra un error en el registro y no sobrescribe el campo de destino existente.
  4. Opcionalmente, marque la casilla Preserve source tag si desea conservar el campo de fuente original y duplicar la información de su clave de fuente en la clave de destino especificada. Si esta casilla no está marcada, la clave de fuente se elimina después de ser renombrada.

Ejemplo de notación de ruta

For this log structure example:

{
    "outer_key": {
        "inner_key": "inner_value",
        "a": {
            "double_inner_key": "double_inner_value",
            "b": "b value"
        },
        "c": "c value"
    },
    "d": "d value"
}

Follow these reference rules:

  • Use outer_key.inner_key to reference the key with the value inner_value.
  • Use outer_key.a.double_inner_key to reference the key with the value double_inner_value.

To specify a nested field with a literal . in the attribute key, wrap the key in escaped quotes in the search query. For example, the search query "service.status":disabled matches the event {"service.status": "disabled"}.

Métricas de salud

Para métricas de componentes y métricas de búfer de procesador emitidas por todos los procesadores, consulte la documentación sobre métricas de uso de Pipelines. Para filtrar o agrupar por métricas del procesador Edit Fields, utilice la etiqueta component_type:add_fields, component_type:remove_fields o component_type:rename_fields, dependiendo de la acción configurada.

Lecturas adicionales

Documentación, enlaces y artículos útiles adicionales:

Reasignar atributos reservadosDOCUMENTACIÓN more more