Dela via

Konfigurera en tabell med hjälpplanen på din Log Analytics-arbetsyta

Med tabellplanen Auxiliary kan du mata in och behålla data på Log Analytics-arbetsytan till en låg kostnad.

Här är en video som förklarar några av användningsområdena och fördelarna med Auxiliary-tabellplanen:

Azure Monitor-loggar stöder för närvarande den extra tabellplanen för datainsamlingsregel (DCR)-baserade anpassade tabeller som du skickar data som du samlar in med hjälp av Azure Monitor-agenten eller API för logginmatning.

Den här artikeln beskriver hur du skapar en ny anpassad tabell med hjälpplanen på Log Analytics-arbetsytan och konfigurerar en datainsamlingsregel som skickar data till den här tabellen. Mer information om hjälpplansbegrepp finns i Tabellplaner för Azure Monitor-loggar.

Förutsättningar

Om du vill skapa en anpassad tabell och samla in loggdata behöver du:

  • En Log Analytics-arbetsyta där du har minst deltagarbehörighet.
  • En datainsamlingsslutpunkt (DCE).
  • Det går bara att konfigurera en tabell med hjälpplanen i nya tabeller. När du har skapat en tabell med en extraplan kan du inte byta tabellens plan.

Anmärkning

Tilläggsloggar är allmänt tillgängliga (GA) för alla offentliga molnregioner förutom Qatar Central och är inte tillgängliga för Azure Government- eller Kina-moln.

Skapa en anpassad tabell med tilläggsplanen

Om du vill skapa en anpassad tabell anropar du Tables – Create API med hjälp av det här kommandot:

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

Anmärkning

Endast API-versionen 2023-01-01-preview låter dig ange hjälptabellplanen.

Ange denna payload som innehållet i din begäran. Uppdatera tabellnamnet och justera kolumnerna baserat på tabellschemat. I det här exemplet visas alla kolumndatatyper som stöds.

 {
    "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"
    }
}

Anmärkning

  • Kolumnen TimeGenerated stöder endast ISO 8601-formatet med 6 decimaler för precision (nanosekunder). Mer information finns i ISO 8601 datetime-format som stöds.
  • Tabeller med hjälpplanen stöder inte kolumner med dynamiska data.

Skicka data till en tabell med hjälpplanen

Det finns för närvarande två sätt att mata in data till en anpassad tabell med hjälpplanen.

  • Använda Azure Monitor Agent (AMA)
  • Använda logginmatnings-API:et

Använd AMA:et

Om du använder den här metoden får din anpassade tabell bara ha två kolumner – TimeGenerated (typ datetime) och RawData (av typen string). Datainsamlingsregeln skickar hela varje loggpost som du samlar in till RawData kolumnen, och Azure Monitor-loggar fyller TimeGenerated automatiskt i kolumnen med den tid då loggen matas in.

Mer information om hur du använder AMA finns i följande artiklar:

Använda logginmatnings-API:et

Den här metoden följer noga de steg som beskrivs i Självstudie: Skicka data till Azure Monitor med hjälp av API för logginmatning.

  1. Skapa en anpassad tabell med hjälpplanen enligt beskrivningen i den här artikeln.
  2. Skapa ett Microsoft Entra-program.
  3. Skapa en regel för datainsamling. Här är en ARM-exempelmall för kind: Direct. Den här typen av DCR kräver ingen DCE eftersom den innehåller en logsIngestion slutpunkt.

    • myworkspace är namnet på din Log Analytics-arbetsyta.

    • tablename_CL är namnet på tabellen.

    • columns innehåller samma kolumner som du angav när tabellen skapades.

      {
    "$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_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"}]
                                }
                            },
                "destinations": {
                    "logAnalytics": [
                        {"workspaceResourceId": "[parameters('workspaceResourceId')]",
                         "name": "myworkspace"}]
                },
                "dataFlows": [
                    {
                        "streams": ["Custom-table_name"],
                        "transformKql": "source",
                        "destinations": ["myworkspace"],
                        "outputStream": "Custom-tablename-CL"
                    }]
            }
        }],
    "outputs": {
        "dataCollectionRuleId": {
            "type": "string",
            "value": "[resourceId('Microsoft.Insights/dataCollectionRules', parameters('dataCollectionRuleName'))]"
        }
    }
}
  4. Ge ditt program behörighet att använda din DCR.
  5. Skicka data med hjälp av exempelkod.

Varning

När du importerar loggar på hjälpnivån i Azure Monitor bör du undvika att skicka in en enda nyttolast som innehåller TimeGenerated-tidsstämplar som sträcker sig över mer än 30 minuter i ett API-anrop. Det här API-anropet kan leda till följande inmatningsfelkod RecordsTimeRangeIsMoreThan30Minutes. Det här är en känd begränsning som tas bort.

Den här begränsningen gäller inte för hjälploggar som använder transformeringar.

Relaterat innehåll