Compartir a través de

Adición o eliminación de tablas y columnas en los registros de Azure Monitor

Las reglas de recopilación de datos permiten filtrar y transformar los datos de registro antes de enviarlos a una tabla de Azure o a una tabla personalizada. En este artículo se explica cómo crear tablas personalizadas y agregar columnas personalizadas a las tablas del área de trabajo de Log Analytics.

Importante

Siempre que actualice un esquema de tabla, asegúrese de actualizar las reglas de recopilación de datos que envíen datos a la tabla. El esquema de tabla que defina en la regla de recopilación de datos determina cómo Azure Monitor transmite datos a la tabla de destino. Azure Monitor no actualiza las reglas de recopilación de datos automáticamente cuando se realizan cambios en el esquema de tabla.

Requisitos previos

Acción Permiso necesario
Administración de una tabla Permiso Microsoft.OperationalInsights/workspaces/* en el ámbito del área de trabajo de Log Analytics o superior.
Por ejemplo, como lo proporciona el rol integrado privilegiado, colaborador de Log Analytics.

Para ingerir datos en la tabla, es posible que necesite lo siguiente:

  • Punto final de recopilación de datos (DCE). Para obtener más información, consulte DCE.

  • Ejemplo de al menos un registro de los datos de origen en un archivo JSON. Se usa para crear tablas personalizadas en el portal, como lo que se requiere para recopilar orígenes de datos JSON y texto de máquinas virtuales.

    [
  {
    "TimeGenerated": "supported_datetime_format",
    "<column_name_1>": "<column_name_1_value>",
    "<column_name_2>": "<column_name_2_value>"
  },
  {
    "TimeGenerated": "supported_datetime_format",
    "<column_name_1>": "<column_name_1_value>",
    "<column_name_2>": "<column_name_2_value>"
  },
  {
    "TimeGenerated": "supported_datetime_format",
    "<column_name_1>": "<column_name_1_value>",
    "<column_name_2>": "<column_name_2_value>"
  }
]

  • Todas las tablas de un área de trabajo de Log Analytics deben tener una TimeGenerated columna, que se usa para identificar el tiempo de ingesta del registro. Si falta la columna, se agrega a la transformación en el DCR de la tabla. Para obtener información, consulte formatos de fecha y hora admitidos.

Creación de una tabla personalizada

Las tablas de Azure tienen esquemas predefinidos. Para almacenar datos de registro en un esquema diferente, use reglas de recopilación de datos para definir cómo recopilar, transformar y enviar los datos a una tabla personalizada en el área de trabajo de Log Analytics. Para crear una tabla personalizada con el plan auxiliar, consulte Configuración de una tabla con el plan auxiliar.

Importante

Las tablas personalizadas tienen un sufijo de _CL; por ejemplo, tablename_CL. Azure Portal agrega automáticamente el sufijo _CL al nombre de la tabla. Al crear una tabla personalizada mediante un método diferente, debe agregar el sufijo _CL usted mismo. El tablename_CL en las propiedades de flujos de datos debe coincidir con el nombre de tablename_CL en el área de trabajo de Log Analytics.

Advertencia

Los nombres de tabla se usan con fines de facturación, por lo que no deben contener información confidencial.

Para crear una tabla personalizada mediante Azure Portal:

  1. En el menú Áreas de trabajo de Log Analytics, seleccione Tablas.

    Captura de pantalla que muestra la pantalla Tablas de un área de trabajo de Log Analytics.

  2. Seleccione Crear y, a continuación, Nuevo registro personalizado (basado en DCR).

    Captura de pantalla que muestra el nuevo registro personalizado basado en DCR.

  3. Especifique un nombre y, opcionalmente, una descripción para la tabla. No es necesario agregar el sufijo _CL al nombre de la tabla personalizada; esto se agrega automáticamente al nombre que especifique en el portal.

  4. Seleccione una regla de recopilación de datos existente en la lista desplegable Regla de recopilación de datos o seleccione Crear una nueva regla de recopilación de datos y especifique la Suscripción, el Grupo de recursos y el Nombre de la nueva regla de recopilación de datos.

    Captura de pantalla que muestra la nueva regla de recopilación de datos.

  5. Seleccione un punto de conexión de recopilación de datos y seleccione Siguiente.

    Captura de pantalla que muestra el nombre de la tabla del registro personalizado.

  6. Seleccione Buscar archivos y busque el archivo JSON con los datos de ejemplo de la nueva tabla.

    Captura de pantalla que muestra la búsqueda de archivos en el registro personalizado.

    Si los datos de ejemplo no incluyen una TimeGenerated columna, recibirá un mensaje que indica que se crea una transformación con esta columna.

  7. Si quiere transformar los datos de registro antes de la ingesta en la tabla:

    1. Seleccione el Editor de transformación.

      El editor de transformación permite crear una transformación para el flujo de datos entrante. Se trata de una consulta KQL que se ejecuta en cada registro entrante. Los registros de Azure Monitor almacenan los resultados de la consulta en la tabla de destino.

      Captura de pantalla que muestra la vista previa de datos del registro personalizado.

    2. Seleccione Ejecutar para ver los resultados.

      Captura de pantalla que muestra la consulta inicial de datos del registro personalizado.

  8. Seleccione Aplicar para guardar la transformación y ver el esquema de la tabla que está a punto de crearse. Seleccione Siguiente para continuar.

    Captura de pantalla que muestra el esquema final del registro personalizado.

  9. Compruebe los detalles finales y seleccione Crear para guardar el registro personalizado.

    Captura de pantalla que muestra la creación del registro personalizado.

Eliminar una tabla

Puede eliminar cualquier tabla que no sea una tabla de Azure, pero cómo se eliminan los datos depende del tipo de tabla.

Para obtener más información, consulte ¿Qué ocurre con los datos al eliminar una tabla en un área de trabajo de Log Analytics?.

Para eliminar una tabla de Azure Portal:

  1. En el menú Área de trabajo de Log Analytics, seleccione Tablas.

  2. Busque las tablas que desea eliminar por nombre, o bien seleccione Resultados de búsqueda en el campo Tipo.

    Captura de pantalla que muestra la pantalla Tablas de un área de trabajo de Log Analytics con los campos Filtrar por nombre y Tipo resaltados.

  3. Seleccione la tabla que quiere eliminar, seleccione los puntos suspensivos (...) situados a la derecha de la tabla, seleccione Eliminar y confirme la eliminación escribiendo sí.

    Captura de pantalla que muestra la pantalla Eliminar tabla de una tabla en un área de trabajo de Log Analytics.

Adición o eliminación de una columna personalizada

Las tablas personalizadas permiten modificar el esquema agregando o eliminando columnas después de la creación de la tabla. Las tablas de Azure solo permiten agregar y eliminar columnas personalizadas.

Use estas reglas al definir nombres de columna para tablas personalizadas:

  • Los nombres de columna deben comenzar con una letra (A-Z o a-z).

  • Después del primer carácter, use solo letras, dígitos o caracteres de subrayado.

  • No use espacios, puntos, guiones u otros signos de puntuación en los nombres de columna.

  • Las letras no ASCII (por ejemplo, Æ, É, Ö) no se admiten en nombres de columna.

  • Los nombres de columna solo distinguen mayúsculas de minúsculas para las tablas de Analytics y Básico. La ingesta de tablas de registro auxiliares quita los datos a nombres de columna duplicados cuando la única diferencia es mayúsculas y minúsculas.

  • Los nombres de columna deben tener entre 2 y 45 caracteres.

  • Los nombres de columna personalizados de las tablas de Azure deben terminar en _CF

  • No use nombres que entren en conflicto con las columnas reservadas o del sistema, incluidas id, , BilledSizeIsBillableInvalidTimeGeneratedTenantIdTitleTypeUniqueId_ItemId_ResourceGroup_ResourceId_SubscriptionId_TimeReceived.

Importante

Las reglas de esquema de las tablas personalizadas son más estrictas que las reglas generales de identificador de Kusto. Kusto puede hacer referencia a nombres de propiedad inusuales con comillas en consultas, pero el esquema de tabla personalizado solo acepta letras, dígitos y guiones bajos para los nombres de columna.

Para agregar una columna personalizada a una tabla en el área de trabajo de Log Analytics o eliminar una columna:

  1. En el menú Áreas de trabajo de Log Analytics, seleccione Tablas.

  2. Seleccione los puntos suspensivos (...) situados a la derecha de la tabla que quiere editar y seleccione Editar esquema.

    Se abrirá la pantalla Editor de esquemas.

  3. Desplácese hacia abajo hasta la sección Columnas personalizadas de la pantalla Editor de esquemas.

    Captura de pantalla que muestra la pantalla Editor de esquemas con los botones Agregar una columna y Eliminar resaltados.

  4. Para agregar una columna nueva:

    1. Seleccione Agregar una columna.
    2. Establezca el nombre y la descripción de la columna (opcional) y seleccione el tipo de valor esperado en la lista desplegable Tipo.
    3. Seleccione Guardar para guardar la columna nueva.

  5. Para eliminar una columna, seleccione el icono Eliminar situado a la izquierda de la columna que quiere eliminar.

Contenido relacionado

  • Last updated on