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 automáticamente las reglas de recopilación de datos al realizar cambios en el esquema de tabla.

Requisitos previos

Para crear una tabla personalizada, necesita lo siguiente:

• Un área de trabajo de Log Analytics en la que tenga al menos derechos de colaborador.

• Un punto de conexión de recopilación de datos (DCE).

• Un archivo JSON con al menos un registro de ejemplo para la tabla personalizada. Esto tendrá un aspecto similar al siguiente:

  [
    {
      "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 columna denominada TimeGenerated. Si los datos de ejemplo tienen una columna denominada TimeGenerated, este valor se usará para identificar el tiempo de ingesta del registro. Si no es así, se agregará una columna TimeGenerated a la transformación en el DCR de la tabla. Para obtener más información sobre el formato TimeGenerated, consulte formatos dateTime 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.

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.

Nota:

Para obtener información sobre cómo crear una tabla personalizada para los registros que ingiere con el agente de Log Analytics en desuso, también conocido como MMA o OMS, consulte Recopilación de registros de texto con el agente de Log Analytics.

Portal

Para crear una tabla personalizada en Azure Portal:

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

   

2. Seleccione Crear y, a continuación, 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.

   

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

   

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

   

   Si los datos de ejemplo no incluyen una columna TimeGenerated, recibirá un mensaje que indica que se va a crear 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.

      

   2. Seleccione Ejecutar para ver los resultados.

      

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.

   

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

   

API

Para crear una tabla personalizada, llame a la API Tables - Create Or Update.

CLI

Para crear una tabla personalizada, ejecute el comando az monitor log-analytics workspace table create.

PowerShell

Use Tables - Update PATCH API para crear la tabla personalizada con el código de PowerShell siguiente. Este código crea una tabla denominada MyTable_CL con dos columnas. Modifique este esquema para recopilar una tabla diferente.

1. Seleccione el botón de Cloud Shell en Azure Portal y asegúrese de que el entorno esté establecido en PowerShell.

   

2. Copie el siguiente código de PowerShell y reemplace el parámetro Path por los valores adecuados del área de trabajo en el comando Invoke-AzRestMethod. Péguelo en el símbolo del sistema de Cloud Shell para ejecutarlo.

   $tableParams = @'
   {
       "properties": {
           "schema": {
               "name": "MyTable_CL",
               "columns": [
                   {
                       "name": "TimeGenerated",
                       "type": "DateTime"
                   }, 
                   {
                       "name": "RawData",
                       "type": "String"
                   }
               ]
           }
       }
   }
   '@
   
   Invoke-AzRestMethod -Path "/subscriptions/{subscription}/resourcegroups/{resourcegroup}/providers/microsoft.operationalinsights/workspaces/{workspace}/tables/MyTable_CL?api-version=2021-12-01-preview" -Method PUT -payload $tableParams
   

Eliminar una tabla

Hay varios tipos de tablas en los registros de Azure Monitor. Puede eliminar cualquier tabla que no sea una tabla de Azure, pero lo que sucede con los datos al eliminar la tabla es diferente para cada 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?.

Portal

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.

   

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í.

   

API

Para eliminar una tabla, llame a la API Tables - Delete.

CLI

Para eliminar una tabla, ejecute el comando az monitor log-analytics workspace table delete.

PowerShell

Para eliminar una tabla mediante PowerShell:

1. Seleccione el botón de Cloud Shell en Azure Portal y asegúrese de que el entorno esté establecido en PowerShell.

   

2. Copie el siguiente código de PowerShell y reemplace el parámetro Path por los valores adecuados del área de trabajo en el comando Invoke-AzRestMethod. Péguelo en el símbolo del sistema de Cloud Shell para ejecutarlo.

   Invoke-AzRestMethod -Path "/subscriptions/{subscription}/resourcegroups/{resourcegroup}/providers/microsoft.operationalinsights/workspaces/{workspace}/tables/NewCustom_CL?api-version=2021-12-01-preview" -Method DELETE
   

Adición o eliminación de una columna personalizada

Puede modificar el esquema de las tablas personalizadas y agregar columnas personalizadas a una tabla estándar o eliminar columnas de esta.

Nota:

Los nombres de columna deben comenzar con una letra y pueden constar de hasta 45 caracteres alfanuméricos y guiones bajos (_). _ResourceId, id, _ResourceId, _SubscriptionId, TenantId, Type, UniqueId y Title son nombres de columna reservados.

Portal

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.

   

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.

API

Para agregar o eliminar una columna personalizada, llame a la API Tables - Create Or Update.

CLI

Para agregar o eliminar una columna personalizada, ejecute el comando az monitor log-analytics workspace table update.

PowerShell

Para agregar una nueva columna a una tabla personalizada o de Azure, ejecute:

$tableParams = @'
{
    "properties": {
        "schema": {
            "name": "<TableName>",
            "columns": [
                {
                    "name": ""<ColumnName>",
                    "description": "First custom column",
                    "type": "string",
                    "isDefaultDisplay": true,
                    "isHidden": false
                }
            ]
        }
    }
}
'@

Invoke-AzRestMethod -Path "/subscriptions/{subscription}/resourcegroups/{resourcegroup}/providers/microsoft.operationalinsights/workspaces/{workspace}/tables/<TableName>?api-version=2021-12-01-preview" -Method PUT -payload $tableParams

La llamada PUT devuelve las propiedades de la tabla actualizadas, que deben incluir la columna recién agregada.

Ejemplo

Ejecute este comando para agregar una columna personalizada, denominada Custom1_CF, a la tabla Heartbeat de Azure:

$tableParams = @'
{
    "properties": {
        "schema": {
            "name": "Heartbeat",
            "columns": [
                {
                    "name": "Custom1_CF",
                    "description": "The second custom column",
                    "type": "datetime",
                    "isDefaultDisplay": true,
                    "isHidden": false
                }
            ]
        }
    }
}
'@

Invoke-AzRestMethod -Path "/subscriptions/{subscription}/resourcegroups/{resourcegroup}/providers/microsoft.operationalinsights/workspaces/{workspace}/tables/Heartbeat?api-version=2021-12-01-preview" -Method PUT -payload $tableParams

Ahora, para eliminar la columna recién agregada y agregar otra en su lugar, ejecute:

$tableParams = @'
{
    "properties": {
        "schema": {
            "name": "Heartbeat",
            "columns": [
                {
                    "name": "Custom2_CF",
                    "description": "The second custom column",
                    "type": "datetime",
                    "isDefaultDisplay": true,
                    "isHidden": false
                }
            ]
        }
    }
}
'@

Invoke-AzRestMethod -Path "/subscriptions/{subscription}/resourcegroups/{resourcegroup}/providers/microsoft.operationalinsights/workspaces/{workspace}/tables/Heartbeat?api-version=2021-12-01-preview" -Method PUT -payload $tableParams

Para eliminar todas las columnas personalizadas de la tabla, ejecute:

$tableParams = @'
{
    "properties": {
        "schema": {
            "name": "Heartbeat",
            "columns": [
            ]
        }
    }
}
'@

Invoke-AzRestMethod -Path "/subscriptions/{subscription}/resourcegroups/{resourcegroup}/providers/microsoft.operationalinsights/workspaces/{workspace}/tables/Heartbeat?api-version=2021-12-01-preview" -Method PUT -payload $tableParams

Pasos siguientes

Más información sobre:

• Recopilación de registros con la API de ingesta de registros
• Recopilación de registros con el agente de Azure Monitor
• Reglas de recopilación de datos