Lägga till eller ta bort tabeller och kolumner i Azure Monitor-loggar

2025-10-09

Med regler för datainsamling kan du filtrera och transformera loggdata innan du skickar data till en Azure-tabell eller en anpassad tabell. Den här artikeln beskriver hur du skapar anpassade tabeller och lägger till anpassade kolumner i tabeller på Din Log Analytics-arbetsyta.

Viktigt!

När du uppdaterar ett tabellschema bör du uppdatera alla datainsamlingsregler som skickar data till tabellen. Tabellschemat som du definierar i datainsamlingsregeln avgör hur Azure Monitor strömmar data till måltabellen. Azure Monitor uppdaterar inte datainsamlingsregler automatiskt när du gör ändringar i tabellschemat.

Förutsättningar

Åtgärd	Behörighet krävs
Hantera en tabell	`Microsoft.OperationalInsights/workspaces/*` behörighet på Log Analytics-arbetsytans nivå eller högre. Till exempel, som tillhandahålls av den privilegierade inbyggda rollen, Log Analytics-bidragsgivare.

Om du vill mata in data i tabellen kan du behöva följande:

Datainsamlingsslutpunkt (DCE). Mer information finns i DCE.

Ett exempel på minst en post med källdata i en JSON-fil. Detta används för att skapa anpassade tabeller i portalen, till exempel vad som krävs för att samla in text och JSON-datakällor från virtuella datorer

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

Alla tabeller på en Log Analytics-arbetsyta måste ha en TimeGenerated kolumn som används för att identifiera postens inmatningstid. Om kolumnen saknas läggs den automatiskt till i transformeringen i din DCR för tabellen. Mer information finns i datetime-format som stöds.

Skapa en anpassad tabell

Azure-tabeller har fördefinierade scheman. Om du vill lagra loggdata i ett annat schema använder du datainsamlingsregler för att definiera hur du samlar in, transformerar och skickar data till en anpassad tabell på Log Analytics-arbetsytan. Information om hur du skapar en anpassad tabell med hjälpplanen finns i Konfigurera en tabell med hjälpplanen.

Viktigt!

Anpassade tabeller har suffixet _CL; till exempel tablename_CL. Azure-portalen lägger automatiskt till _CL-suffixet i tabellnamnet. När du skapar en anpassad tabell med en annan metod måste du lägga till _CL-suffixet själv. Tablename_CL i egenskaperna för DataFlows Streams i dina datainsamlingsregler måste matcha tablename_CL namnet i Log Analytics-arbetsytan.

Varning

Tabellnamn används i faktureringssyfte så att de inte ska innehålla känslig information.

Så här skapar du en anpassad tabell med hjälp av Azure Portal:

På menyn Log Analytics-arbetsytor väljer du Tabeller.
Välj Skapa och sedan Ny anpassad logg (DCR-baserad).
Ange ett namn och, om du vill, en beskrivning för tabellen. Du behöver inte lägga till _CL-suffixet i den anpassade tabellens namn . Detta läggs automatiskt till i det namn som du anger i portalen.
Välj en befintlig datainsamlingsregel i listrutan Datainsamlingsregel eller välj Skapa en ny datainsamlingsregel och ange regeln Prenumeration, Resursgrupp och Namn för den nya datainsamlingsregeln.
Välj en datainsamlingsslutpunkt och välj Nästa.
Välj Bläddra efter filer och leta upp JSON-filen med exempeldata för den nya tabellen.

Om exempeldata inte innehåller en TimeGenerated kolumn får du ett meddelande om att en transformering skapas med den här kolumnen.
Om du vill transformera loggdata före inmatning till tabellen:
1. Välj Transformeringsredigeraren.
  
  Med transformeringsredigeraren kan du skapa en transformering för inkommande dataström. Det här är en KQL-fråga som körs mot varje inkommande post. Azure Monitor-loggar lagrar resultatet av frågan i måltabellen.
2. Välj Kör för att visa resultatet.
Välj Använd för att spara omvandlingen och visa schemat för tabellen som ska skapas. Välj Nästa för att fortsätta.
Kontrollera den slutliga informationen och välj Skapa för att spara den anpassade loggen.

Använd API:et Tables – Update PATCH för att skapa en anpassad tabell med följande PowerShell-kod. Den här koden skapar en tabell med namnet MyTable_CL med två kolumner. Ändra det här schemat för att samla in en annan tabell.

Välj knappen Cloud Shell i Azure-portalen och se till att miljön är inställd på PowerShell.

Kopiera följande PowerShell-kod och ersätt parametern Path med lämpliga värden för din arbetsyta i Invoke-AzRestMethod kommandot . Klistra in den i Cloud Shell-prompten för att köra den.

$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

Ta bort en tabell

Du kan ta bort en tabell som inte är en Azure-tabell, men hur data tas bort beror på tabelltypen.

Mer information finns i Vad händer med data när du tar bort en tabell på en Log Analytics-arbetsyta.

Så här tar du bort en tabell från Azure Portal:

På log analytics-arbetsytans meny väljer du Tabeller.
Sök efter de tabeller som du vill ta bort med namn eller genom att välja Sökresultat i fältet Typ .
Välj den tabell som du vill ta bort, välj ellipsen ( ... ) till höger om tabellen, välj Ta bort och bekräfta borttagningen genom att skriva ja.

Så här tar du bort en tabell med Hjälp av PowerShell:

Välj knappen Cloud Shell i Azure-portalen och se till att miljön är inställd på PowerShell.

Kopiera följande PowerShell-kod och ersätt parametern Path med lämpliga värden för din arbetsyta i Invoke-AzRestMethod kommandot . Klistra in den i Cloud Shell-prompten för att köra den.

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

Lägga till eller ta bort en anpassad kolumn

Anpassade tabeller tillåter ändring av schemat genom att lägga till eller ta bort kolumner när tabellen har skapats. Azure-tabeller tillåter endast att anpassade kolumner läggs till och tas bort.

Använd dessa regler när du definierar kolumnnamn för anpassade tabeller:

Kolumnnamn måste börja med en bokstav (A-Z eller a-z).
Använd bara bokstäver, siffror eller understreck efter det första tecknet.
Använd inte blanksteg, punkter, bindestreck eller andra skiljetecken i kolumnnamn.
Icke-ASCII-bokstäver (till exempel Æ, É, Ö) stöds inte i kolumnnamn.
Kolumnnamn är endast skiftlägeskänsliga för Analys- och Basic-tabeller. Extra loggtabellinmatning släpper data till duplicerade kolumnnamn när den enda skillnaden är skiftläge.
Kolumnnamnen måste vara mellan 2 och 45 tecken långa.
Anpassade kolumnnamn i Azure-tabeller måste sluta i _CF
Använd inte namn som är i konflikt med system eller reserverade kolumner, inklusive id, BilledSize, IsBillable, InvalidTimeGenerated, TenantId, Title, Type, UniqueId, _ItemId_ResourceGroup, _ResourceId, , _SubscriptionId. _TimeReceived

Viktigt!

Schemareglerna för anpassade tabeller är striktare än allmänna Kusto-identifierarregler. Kusto kan referera till ovanliga egenskapsnamn med citattecken i frågor, men det anpassade tabellschemat accepterar endast bokstäver, siffror och understreck för kolumnnamn.

Så här lägger du till en anpassad kolumn i en tabell på Log Analytics-arbetsytan eller tar bort en kolumn:

På menyn Log Analytics-arbetsytor väljer du Tabeller.
Välj ellipsen ( ... ) till höger om tabellen som du vill redigera och välj Redigera schema.

Då öppnas skärmen Schemaredigerare .
Rulla ned till avsnittet Anpassade kolumner på skärmen Schemaredigeraren .
Så här lägger du till en ny kolumn:
1. Välj Lägg till en kolumn.
2. Ange kolumnnamnet och beskrivningen (valfritt) och välj den förväntade värdetypen i listrutan Typ .
3. Välj Spara för att spara den nya kolumnen.
Om du vill ta bort en kolumn väljer du ikonen Ta bort till vänster om den kolumn som du vill ta bort.

Om du vill lägga till en ny kolumn i en Azure- eller anpassad tabell kör du:

$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

Anropet PUT returnerar de uppdaterade tabellegenskaperna, som ska innehålla den nyligen tillagda kolumnen.

Exempel

Kör det här kommandot för att lägga till en anpassad kolumn med namnet Custom1_CF, i Azure-tabellen Heartbeat :

$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

Om du vill ta bort den nyligen tillagda kolumnen och lägga till en till i stället kör du:

$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

Om du vill ta bort alla anpassade kolumner i tabellen kör du:

$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

Feedback

Var den här sidan till hjälp?

Dela via

Lägga till eller ta bort tabeller och kolumner i Azure Monitor-loggar

Förutsättningar

Skapa en anpassad tabell

Ta bort en tabell

Lägga till eller ta bort en anpassad kolumn

Relaterat innehåll

Feedback

Ytterligare resurser