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:

Los registros de Azure Monitor admiten actualmente el plan de tabla auxiliar en tablas personalizadas basadas en una regla de recopilación de datos (DCR) a las que se envían datos que se recopilan mediante un agente de Azure Monitor o la API de ingesta de registros.

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:

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).
La configuración de una tabla con el plan auxiliar solo se admite en nuevas tablas. Después de crear una tabla con un plan auxiliar, no se puede cambiar el plan de la tabla.

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

Portal
API

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

En el menú Áreas de trabajo de Log Analytics, seleccione Tablas.
Selecciona Crear.
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.
En Plan de tabla, seleccione Auxiliar/Lago.
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.

Para crear una tabla personalizada, llame a tables - Create API mediante este comando:

PUT https://management.azure.com/subscriptions/{subscription_id}/resourceGroups/{resource_group}/providers/Microsoft.OperationalInsights/workspaces/{workspace_name}/tables/{tablename_CL}?api-version={api-version}

Proporcione esta carga como cuerpo de la solicitud. Actualice el nombre de la tabla y ajuste las columnas en función del esquema de la tabla. En este ejemplo se enumeran todos los tipos de datos de columna admitidos.

 {
    "properties": {
        "schema": {
            "name": "table_name_CL",
            "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": "GuidProperty",
                 "type": "guid"},
                {"name": "DateTimeProperty",
                 "type": "datetime"}
            ]
        },
        "totalRetentionInDays": 365,
        "plan": "Auxiliary"
    }
}

Nota:

La TimeGenerated columna solo admite el formato ISO 8601 con 6 posiciones decimales para precisión (microsegundos). Para obtener más información, consulte formato de fecha y hora ISO 8601 admitido.
Las tablas con el plan auxiliar no admiten columnas con datos dinámicos.

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.

Crear una tabla personalizada con el plan auxiliar tal como se describe en este artículo.
Crear una aplicación de Microsoft Entra.

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.
tablename_CL es el nombre de la tabla.
columns incluye las mismas columnas que estableció en la creación de la tabla.

ARM (JSON)
Bíceps

{
    "$schema": "https://schema.management.azure.com/schemas/2019-08-01/deploymentTemplate.json#",
    "contentVersion": "1.0.0.0",
    "parameters": {
        "dataCollectionRuleName": {
            "type": "string",
            "metadata": {"description": "Specifies the name of the data collection rule to create."}
        },
        "location": {
            "type": "string",
            "metadata": {"description": "Specifies the region in which to create the data collection rule. The must be the same region as the destination Log Analytics workspace."}
        },
        "workspaceResourceId": {
            "type": "string",
            "metadata": {"description": "The Azure resource ID of the Log Analytics workspace in which you created a custom table with the Auxiliary plan."}
        }
    },
    "resources": [
        {
            "type": "Microsoft.Insights/dataCollectionRules",
            "name": "[parameters('dataCollectionRuleName')]",
            "location": "[parameters('location')]",
            "apiVersion": "2023-03-11",
            "kind": "Direct",
            "properties": {
                "streamDeclarations": {
                    "Custom-tablename": {
                        "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": "GuidProperty",
                                "type": "guid"},
                            {"name": "DateTimeProperty",
                                "type": "datetime"}]
                                }
                            },
                "destinations": {
                    "logAnalytics": [
                        {"workspaceResourceId": "[parameters('workspaceResourceId')]",
                            "name": "myworkspace"}]
                },
                "dataFlows": [
                    {
                        "streams": ["Custom-tablename"],
                        "transformKql": "source",
                        "destinations": ["myworkspace"],
                        "outputStream": "Custom-tablename_CL"
                    }]
            }
        }],
    "outputs": {
        "dataCollectionRuleId": {
            "type": "string",
            "value": "[resourceId('Microsoft.Insights/dataCollectionRules', parameters('dataCollectionRuleName'))]"
        }
    }
}

@description('Specifies the name of the data collection rule to create.')
param dataCollectionRuleName string

@description('Specifies the region in which to create the data collection rule. The must be the same region as the destination Log Analytics workspace.')
param location string

@description('The Azure resource ID of the Log Analytics workspace in which you created a custom table with the Auxiliary plan.')
param workspaceResourceId string

resource dataCollectionRule 'Microsoft.Insights/dataCollectionRules@2023-03-11' = {
name: dataCollectionRuleName
location: location
kind: 'Direct'
properties: {
    streamDeclarations: {
    'Custom-tablename': {
        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: 'GuidProperty'
            type: 'guid'
        }
        {
            name: 'DateTimeProperty'
            type: 'datetime'
        }
        ]
    }
    }
    destinations: {
    logAnalytics: [
        {
        workspaceResourceId: workspaceResourceId
        name: 'myworkspace'
        }
    ]
    }
    dataFlows: [
    {
        streams: [
        'Custom-tablename'
        ]
        transformKql: 'source'
        destinations: [
        'myworkspace'
        ]
        outputStream: 'Custom-tablename_CL'
    }
    ]
}
}

output dataCollectionRuleId string = dataCollectionRule.id

Conceder permiso de aplicación para usar el DCR.
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:

Comentarios

¿Le resultó útil esta página?

Last updated on 2026-03-13