Configuración de una tabla con el plan auxiliar en el área de trabajo de Log Analytics

El plan de tabla auxiliar le permite ingerir y conservar datos en el área de trabajo de Log Analytics a un bajo coste.

Este es un vídeo que explica algunos de los usos y ventajas del plan de tabla auxiliar:

Azure Monitor Logs admite el plan de tabla auxiliar para las tablas personalizadas basadas en reglas de recopilación de datos (DCR) a las que se envían los datos que se recopilan mediante Azure Monitor Agent o la API de ingesta de Logs.

En este artículo se explica cómo crear una nueva tabla personalizada con el plan auxiliar en el área de trabajo de Log Analytics y configurar una regla de recopilación de datos que envía datos a esta tabla. Para más información sobre los conceptos del Plan Auxiliar, consulte los Planes de tablas de registros de Azure Monitor.

Requisitos previos

Para crear una tabla personalizada y recopilar datos de registro, necesita:

Nota:

Los registros auxiliares están disponibles con carácter general (GA) para todas las regiones de nube pública, excepto el Centro de Qatar, y no están disponibles para las nubes de Azure Government o China.

Crear una tabla personalizada con el plan auxiliar

Para crear una tabla personalizada con el plan auxiliar en Azure Portal:

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

  2. Selecciona Crear.

  3. En la pestaña Aspectos básicos , especifique un nombre y, opcionalmente, una descripción para la tabla. El portal agrega automáticamente el sufijo _CL al nombre de la tabla.

  4. En Plan de tabla, seleccione Auxiliar/Lago.

  5. Seleccione Siguiente y complete los pasos restantes para configurar el esquema y la recopilación de datos. Para obtener instrucciones detalladas sobre los pasos restantes, consulte Incorporación o eliminación de tablas y columnas en registros de Azure Monitor.

Variable Valor de ejemplo Purpose
host management.azure.com Punto de conexión de ARM implícito
subscriptionId aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e Entrada de usuario
resourceGroupName myResourceGroup Entrada de usuario
workspaceName myWorkspace Entrada de usuario
tableName_CL myTable_CL Entrada de usuario
apiVersion 2025-07-01 Referencia

Enviar datos a una tabla con el plan auxiliar

Hay varias maneras de ingerir datos en una tabla personalizada con el plan auxiliar:

  • Agente de Azure Monitor (AMA)
  • API de ingesta de registros
  • Transformación del área de trabajo

"Utilice el AMA"

Si usa este método, la tabla personalizada solo debe tener dos columnas TimeGenerated : (tipo datetime) y RawData (de tipo string). La regla de recopilación de datos envía la totalidad de cada entrada de registro que recopila a la columna RawData y los registros de Azure Monitor rellenan automáticamente la columna TimeGenerated con la hora en que se ingiere el registro.

Para obtener más información sobre cómo usar AMA, consulte los siguientes artículos:

Uso de la API de ingesta de registros

Este método sigue detenidamente los pasos descritos en Tutorial: Envío de datos a Azure Monitor mediante la API de ingesta de registros.

  1. Crear una tabla personalizada con el plan auxiliar tal como se describe en este artículo.

  2. Crear una aplicación de Microsoft Entra.

  3. Cree una regla de recopilación de datos. Esta es una plantilla de ARM de ejemplo para kind: Direct. Este tipo de DCR no requiere un DCE, ya que incluye un logsIngestion punto de conexión.

    • myWorkspace es el nombre del área de trabajo de Log Analytics.
    • myTable_CL es el nombre de la tabla.
    • columns incluye las mismas columnas que estableció en la creación de la tabla.

    En el siguiente ejemplo de CLI de Azure se usa el comando az monitor data-collection rule create.

    subscriptionId="aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e"
    resourceGroupName="myResourceGroup"
    dataCollectionRuleName="myDataCollectionRule"
    ruleFile="./my-dcr.json"
    
    az account set --subscription "$subscriptionId"
    az extension add --name monitor-control-service
    
    az monitor data-collection rule create \
      --resource-group "$resourceGroupName" \
      --name "$dataCollectionRuleName" \
      --rule-file "$ruleFile"
    

    Nota:

    CLI de Azure comandos usan el punto de conexión de Azure Resource Manager desde el contexto actual de la CLI, por lo que no es necesario especificar management.azure.com en la sintaxis del comando.


    Expanda para ver el archivo my-dcr.json.
    {
      "location": "eastus",
      "kind": "Direct",
      "properties": {
        "streamDeclarations": {
          "Custom-myTable": {
            "columns": [
              {
                "name": "TimeGenerated",
                "type": "dateTime"
              },
              {
                "name": "StringProperty",
                "type": "string"
              },
              {
                "name": "IntProperty",
                "type": "int"
              },
              {
                "name": "LongProperty",
                "type": "long"
              },
              {
                "name": "RealProperty",
                "type": "real"
              },
              {
                "name": "BooleanProperty",
                "type": "boolean"
              },
              {
                "name": "DateTimeProperty",
                "type": "dateTime"
              }
            ]
          }
        },
        "destinations": {
          "logAnalytics": [
            {
              "workspaceResourceId": "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/myResourceGroup/providers/Microsoft.OperationalInsights/workspaces/myWorkspace",
              "name": "myWorkspace"
            }
          ]
        },
        "dataFlows": [
          {
            "streams": [
              "Custom-myTable"
            ],
            "transformKql": "source",
            "destinations": [
              "myWorkspace"
            ],
            "outputStream": "Custom-myTable_CL"
          }
        ]
      }
    }
    
    Variable Valor de ejemplo Purpose
    host management.azure.com Punto de conexión de ARM implícito
    subscriptionId aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e Entrada de usuario
    resourceGroupName myResourceGroup Entrada de usuario
    dataCollectionRuleName myDataCollectionRule Entrada de usuario
    location eastus Entrada de usuario
    Custom-tableName Custom-myTable Entrada de usuario
    Custom-tableName_CL Custom-myTable_CL Entrada de usuario
    apiVersion 2025-07-01 Referencia
  4. Conceder permiso de aplicación para usar el DCR.

  5. Enviar datos mediante código de ejemplo.

Advertencia

Al ingerir registros en el nivel Auxiliar de Azure Monitor, evite enviar una sola carga que contenga marcas de tiempo TimeGenerated que abarquen más de 30 minutos en una llamada API. Esta llamada API podría provocar el siguiente código de error de ingesta RecordsTimeRangeIsMoreThan30Minutes. Se trata de una limitación conocida que se quita.

Esta restricción no se aplica a los registros auxiliares que usan transformaciones.

Utiliza una transformación de área de trabajo

Para obtener más información, consulte los artículos siguientes: