Tablas de referencia

Información general

Las tablas de referencia te permiten combinar metadatos personalizados con información ya existente en Datadog. Puedes definir nuevas entidades como detalles de clientes, nombres e información de servicios o direcciones IP cargando un archivo CSV que contenga una tabla de información. Las entidades están representadas por una clave primaria en una tabla de referencia y los metadatos asociados.

Tabla de referencia con datos rellenados en las columnas de id de organización, nombre de organización, organización principal, propietario de cuenta y csm

Reglas de validación

Los nombres de las tablas de referencia y los encabezados de las columnas se validan utilizando las siguientes convenciones de nomenclatura y, si es necesario, se actualizan o normalizan automáticamente.

Regla	Normalización
Los nombres y los encabezados no pueden duplicarse.	Los nombres duplicados se enumeran. Por ejemplo, si `fileid` se utiliza dos veces como nombre, la primera instancia se convierte en `fileid1` y la segunda instancia en `fileid2`. Si se enumera un nombre o encabezado y supera los 56 caracteres, se rechaza y es necesario cambiar su nombre.
Los nombres y encabezados no pueden contener letras mayúsculas.	Los nombres con letras mayúsculas se convierten a minúsculas. Esta conversión puede dar lugar a nombres duplicados, que luego se enumeran. Por ejemplo, `Fileid` y `FileID` se convierten en `fileid` y se enumeran en `fileid1` y `fileid2` respectivamente.
Los nombres y los encabezados no pueden contener espacios.	Los espacios que no sean iniciales ni finales se sustituyen por caracteres de subrayado `_`. Se eliminan los espacios iniciales y finales. Por ejemplo, `customer names` se sustituye por `customer_names`.
Los nombres y los encabezados deben empezar por minúscula.	Los caracteres en mayúsculas se convierten a minúsculas. Se eliminan los caracteres iniciales que no sean letras. Por ejemplo, `23Two_three` se convierte en `two_three`.
Los nombres y los encabezados sólo admiten letras minúsculas, números y el carácter `_`.	Los caracteres no admitidos se sustituyen por el carácter de subrayado `_`, a menos que incumpla alguna de las reglas anteriores. En ese caso, los caracteres no admitidos se normalizan mediante la regla correspondiente.
Los nombres y los encabezados deben tener 56 caracteres o menos.	No se realiza ninguna normalización. Los nombres y los encabezados que tienen más de 56 caracteres se rechazan y es necesario cambiar sus nombres.

Crear una tabla de referencia

Haz clic en New Reference Table + (Nueva tabla de referencia +) y luego carga un archivo CSV. Asigna un nombre a las columnas correspondientes y define la clave principal para las búsquedas.

Sección Definir elesquema que muestra una tabla con org_id marcado como clave primaria y las columnas con datos de id de organización, nombre de organización, organización principal, propietario de cuenta y csm

Nota: El método de carga manual de CSV admite archivos de hasta 4 MB.

Las tablas de referencia pueden extraer automáticamente un archivo CSV de un bucket de Amazon S3 para mantener los datos actualizados. La integración busca cambios en el archivo CSV en S3 y, cuando el archivo se actualiza, sustituye la tabla de referencia con los nuevos datos. Esto también permite la actualización de la API con la API de S3, una vez configurada la tabla de referencia inicial. Nota: Las tablas de referencia no se sustituyen si el contenido del archivo CSV no se modifica.

Para actualizar las tablas de referencia desde S3, Datadog utiliza el rol IAM de tu cuenta AWS que configuraste para la integración AWS. Si aún no has creado ese rol, sigue estos pasos para hacerlo. Para permitir que ese rol actualice tus tablas de referencia, agregue la siguiente declaración de permiso a tus políticas IAM. Asegúrate de editar los nombres de los buckets para que coincidan con tu entorno.

Nota: Si utilizas el cifrado del lado del servidor, puedes cargar tablas de referencia cifradas con claves gestionadas por Amazon S3 (SSE-S3) o claves del servicio AWS Key Management (SSE-KMS).

{
    "Statement": [
        {
            "Sid": "EnrichmentTablesS3",
            "Effect": "Allow",
            "Action": [
                "s3:GetObject",
                // Grant KMS decrypt permissions if uploading KMS-encrypted object
                // "kms:Decrypt",
                "s3:ListBucket"
            ],
            "Resource": [
                "arn:aws:s3:::<MY_BUCKET_NAME_1/*>",
                "arn:aws:s3:::<MY_BUCKET_NAME_2>"
            ]
        }
    ],
    "Version": "2012-10-17"
}

Definir la tabla

Haz clic en New Reference Table + (Nueva tabla de referencia +), selecciona Amazon S3, rellena todos los campos, haz clic para importar y define la clave principal para las búsquedas.

Sección Cargar tus datos con el cuadro Amazon S3 seleccionado y los datos de cuenta, bucket y ruta de AWS rellenados

Nota: El método de carga desde un bucket S3 admite archivos de hasta 200 MB.

Si aún no lo has hecho, configura la integración Azure dentro de la suscripción que contiene la cuenta de almacenamiento desde la que quieres importar tu tabla de referencia. Esto implica la creación de un registro de aplicación con el que Datadog pueda integrarse.
En el portal Azure, selecciona la cuenta de almacenamiento que almacena los archivos de tu tabla de referencia.
Dentro de tu cuenta de almacenamiento, ve a Control de acceso (IAM) y selecciona Añadir > Añadir asignación de roles.
Introduce y selecciona el rol Lector de datos blob de almacenamiento. El rol de lector de datos blob de almacenamiento permite a Datadog leer y listar contenedores y blobs de almacenamiento.
En la pestaña Miembros, haz clic en + Select members (+ Seleccionar miembros). Selecciona el registro de la aplicación que creaste en el paso 1.

Después de revisar y asignar el rol, puedes importar a las tablas de referencia desde Azure. La actualización de la configuración de Azure en Datadog puede tardar unos minutos.

Cuadro de Azure Storage en la sección Cargar o importar datos del flujo de trabajo de una nueva tabla de referencia

Para obtener más información, consulta la documentación de la integración Azure.

Nota: La carga desde el almacenamiento de objetos en la nube admite archivos de hasta 200 MB.

Si no has configurado la integración Google Cloud con Datadog o si estás utilizando archivos de ID de proyectos Google legacy (los proyectos legacy se indican en el cuadro de tu integración GCP), sigue las instrucciones para configurar la integración Google Cloud Platform. Esto implica la creación de una cuenta de servicio Google Cloud.
Desde la consola de Google Cloud, ve a la página Cloud Storage.
Busca el bucket al que quieres conceder acceso y haz clic en él.
Haz clic en la pestaña Permisos. En “Ver por elementos principales”, haz clic en el botón Grant Access (Conceder acceso).
En la ventana que aparece, en el campo “Nuevos elementos principales”, introduce el correo electrónico de la cuenta de servicio que creaste y añadiste al cuadro de GCP en el paso 1. En “Asignar roles”, selecciona el rol Visor de objetos de almacenamiento y haz clic en Save (Guardar).

Consola de Google Cloud que muestra la configuración para conceder acceso

Después de revisar y asignar el rol, puedes importar a las tablas de referencia desde Google Cloud La actualización de la configuración en Datadog puede tardar unos minutos.

Seleccionar Almacenamiento GCP en Cargar o importar datos al crear una nueva tabla de referencia

Nota: La carga desde el almacenamiento de objetos en la nube admite archivos de hasta 200 MB.

Esta tabla de referencia puede utilizarse para añadir atributos adicionales a logs con el Procesador de búsquedas.

Modificar una tabla de referencia

Para modificar una tabla de referencia existente con nuevos datos, selecciona una tabla y haz clic en Update Config (Actualizar configuración) en la esquina superior derecha. El CSV seleccionado se inserta en la tabla, lo que significa que:

Se actualizan todas las filas existentes con la misma clave primaria
Se añaden todas las filas nuevas
Se eliminan todas las filas antiguas que no están en el nuevo archivo

Una vez guardada la tabla, las filas insertadas se procesan de forma asíncrona y se actualizan en la vista previa. La actualización puede tardar hasta 10 minutos en completarse.

Eliminar una tabla de referencia

Para eliminar una tabla de referencia, selecciona una tabla, haz clic en el icono del engranaje en la esquina superior derecha y luego haz clic en Delete Table (Eliminar tabla). Se eliminará la tabla junto a todas las filas asociadas.

Si hay un Procesador de búsquedas que utiliza una tabla de referencia para el enriquecimiento de los logs, el enriquecimiento se detiene. El enriquecimiento puede tardar hasta 10 minutos en detenerse.

Monitorizar la actividad de una tabla de referencia

Puedes monitorizar la actividad de una tabla de referencia con Audit Trail o Change Events. Para ver el registro de auditoría y los eventos de cambios de una tabla de referencia específica, selecciona la tabla y haz clic en el icono Configuración junto a Update Config (Actualizar configuración). Para ver el registro de auditoría, necesitas permisos de gestión de la organización.

Audit Trail

Utiliza el registro de auditoría de las tablas de referencia para realizar un seguimiento de las acciones activadas por el usuario. Los eventos de Audit Trail se envían cuando un usuario carga o importa inicialmente un archivo CSV o cuando un usuario crea, modifica o elimina una tabla de referencia.

El tipo de recurso reference_table_file muestra eventos de importación/carga y el tipo de recurso reference_table muestra eventos de la tabla de referencia. El registro de auditoría permite observar el contenido de una tabla de referencia.

Eventos de cambios

Utiliza los eventos de cambios de tablas de referencia para realizar un seguimiento de las acciones automatizadas o activadas por el usuario. Se envían cuando se importa un archivo de nube desde un usuario o una actualización automática. Si bien los eventos pueden realizar un seguimiento de las acciones activadas por el usuario, se utilizan principalmente para realizar un seguimiento de las importaciones activadas cuando una tabla de referencia extrae automáticamente un nuevo archivo CSV.

Los eventos contienen información sobre el estado de éxito, la ruta y el nombre de la tabla de la importación. Si se produce un error, se proporciona información sobre el tipo de error.

Alertas

Para recibir alertas sobre los errores encontrados durante las importaciones, utiliza monitores de eventos para eventos de cambios de la tabla de referencia. Los eventos de cambios de la tabla de referencia se envían desde la fuente reference_tables.

Puedes crear monitores a partir de la pestaña Monitores o hacer clic en el icono de configuración situado junto a New Reference Table + (Nueva tabla de referencia +) para generar un monitor ya rellenado.

Límites de la tabla de referencia

Una tabla de referencia puede tener hasta 50 columnas
El tamaño de un archivo de tabla de referencia cargado a través de la interfaz de usuario puede ser de hasta 4 MB
El tamaño de un archivo de tabla de referencia cargado a través de un archivo de bucket de nube puede ser de hasta 200 MB
El tamaño de un archivo de tabla de referencia cargado a través de una integración puede ser de hasta 200 MB
Puedes tener hasta 100 tablas de referencia por organización

Si tienes un caso de uso que supera estos límites, ponte en contacto con el servicio de asistencia.