Hantera databevarande på en Log Analytics-arbetsyta

2025-09-09

En Log Analytics-arbetsyta behåller data i två tillstånd:

Kvarhållning av analys: I det här tillståndet är data tillgängliga för övervakning, felsökning och nästan realtidsanalys.
Långsiktig kvarhållning: I det här lågkostnadstillståndet är data inte tillgängliga för tabellplansfunktioner, men kan nås via sökjobb.

Den här artikeln beskriver hur Log Analytics-arbetsytor behåller data och hur du hanterar datakvarhållning av tabeller på din arbetsyta.

Analys, långsiktig och total kvarhållning

Som standard behåller alla tabeller i en Log Analytics-arbetsyta data i 30 dagar, förutom loggtabeller med standardkvarhållning på 90 dagar. Tabeller med analysplanen gör dina data tillgängliga för realtidsfrågor under den här kvarhållningsperioden för analys. Alla tabellplaner kan hämta lagrade data via frågor eller sökjobb, och data är tillgängliga för visualiseringar, aviseringar och andra funktioner och tjänster baserat på tabellplanen.

Du kan förlänga kvarhållningsperioden för analys av tabeller med Analytics-planen upp till två år. Grundplanstabeller har en fast period på 30 dagar för förfrågningar medan stödtplanstabeller kan frågas under hela kvarhållningsperioden. Både Basic- och Auxiliary-tabeller har dock ytterligare överväganden. Mer information finns i Fråga efter data i tabellerna Basic och Auxiliary.

Kommentar

Du kan minska kvarhållningsperioden för analystabeller till så lite som fyra dagar med hjälp av API:et eller CLI. Men eftersom 31 dagars kvarhållning av analys ingår i inmatningspriset minskar inte kostnaderna om kvarhållningsperioden under 31 dagar sänks.

Om du vill behålla data i samma tabell utöver standardkvarhållningsperioden utökar du tabellens totala kvarhållning till upp till 12 år. I slutet av kvarhållningsperioden för analys finns data kvar i tabellen under resten av den totala kvarhållningsperioden som du konfigurerar. Under den här perioden – den långsiktiga kvarhållningsperioden – kör du ett sökjobb för att hämta de specifika data du behöver från tabellen och göra dem tillgängliga för interaktiva frågor i en sökresultattabell.

Så här fungerar kvarhållningsändringar

När du förkortar en tabells totala kvarhållning väntar Azure Monitor-loggar 30 dagar innan du tar bort data, så att du kan återställa ändringen och undvika dataförlust om du gjorde ett fel i konfigurationen.

När du ökar den totala kvarhållningen gäller den nya kvarhållningsperioden för alla data som redan har matats in i tabellen och som ännu inte har tagits bort.

När du ändrar inställningarna för långsiktig kvarhållning för en tabell med befintliga data börjar ändringen gälla omedelbart.

Exempel:

Du har en befintlig Analytics-tabell med 180 dagars analysdataretention och ingen långtidsretention.
Du ändrar kvarhållningen av analys till 90 dagar utan att ändra den totala kvarhållningsperioden på 180 dagar.
Azure Monitor behandlar automatiskt de återstående 90 dagarna av total kvarhållning som låg kostnad och långsiktig kvarhållning, så att data som är 90–180 dagar gamla inte går förlorade.

Behörigheter som krävs

Åtgärd	Behörigheter som krävs
Konfigurera standardlagring av analys för Analytics-tabeller på en Log Analytics-arbetsyta	`Microsoft.OperationalInsights/workspaces/write` och `microsoft.operationalinsights/workspaces/tables/write` behörigheter till Log Analytics-arbetsytan, som tillhandahålls av Log Analytics Contributors inbyggda roll, till exempel
Hämta inställningen för kvarhållning för varje tabell i en Log Analytics-arbetsyta	`Microsoft.OperationalInsights/workspaces/tables/read` behörigheter till Log Analytics-arbetsytan, som tillhandahålls av den inbyggda rollen Log Analytics Reader, till exempel

Konfigurera standardkvarhållningsperioden för analystabeller

Standardkvarhållningsperioden för Analytics-tabeller på en Log Analytics-arbetsyta är 30 dagar. Du kan ändra standardanalysperioden för Analytics-tabeller upp till två år genom att ändra datalagringsinställningen på arbetsytanivå. Tabellerna Basic och Auxiliary har bara en total kvarhållningsperiod, vilket är 30 dagar som standard.

Om du ändrar standardinställningen för datakvarhållning på arbetsytan påverkas automatiskt alla Analytics-tabeller som standardinställningen fortfarande gäller för på din arbetsyta. Om du redan har ändrat analyskvarhållningen för en viss tabell påverkas inte tabellen när du ändrar standardinställningen för datakvarhållning för arbetsytan.

Viktigt!

Arbetsytor med kvarhållning på 30 dagar kan lagra data i 31 dagar. Om du bara behöver behålla data i 30 dagar för att följa en sekretesspolicy konfigurerar du standardkvarhållningen för arbetsytan till 30 dagar med hjälp av API:et och uppdaterar immediatePurgeDataOn30Days egenskapen för arbetsytan till true. Den här åtgärden stöds för närvarande endast med hjälp av API:et Workspaces – Update.

Så här anger du standardkvarhållningsperioden för analystabeller i en Log Analytics-arbetsyta:

På menyn Log Analytics-arbetsytor i Azure Portal väljer du din arbetsyta.
I avsnittet Inställningar väljer du Användning och uppskattade kostnader i den vänstra rutan.
Välj Datakvarhållning överst på sidan.
Flytta skjutreglaget för att öka eller minska antalet dagar och välj sedan OK.

Om du vill ange standardkvarhållningsperioden för analystabeller i en Log Analytics-arbetsyta anropar du API:et Workspaces – Create or Update:

PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/Microsoft.OperationalInsights/workspaces/{workspaceName}?api-version=2023-09-01

Begärandetext

Begärandetexten innehåller värdena i följande tabell.

Namn	Typ	Beskrivning
`properties.retentionInDays`	heltal	Antal dagar för lagring av data på arbetsytan. Tillåtna värden är per prisplan. Mer information finns i dokumentationen om prisnivåer.
`location`	sträng	Resursens geo-plats.
`immediatePurgeDataOn30Days`	booleskt	Flagga som anger om data tas bort omedelbart efter 30 dagar och inte kan återställas. Gäller endast när kvarhållning av arbetsytor är inställt på 30 dagar.

Exempel

Det här exemplet anger arbetsytans kvarhållning till arbetsytans standardvärde på 30 dagar och säkerställer att data tas bort omedelbart efter 30 dagar och inte kan återställas.

Förfrågan

PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/Microsoft.OperationalInsights/workspaces/{workspaceName}?api-version=2023-09-01

{
  "properties": {
    "retentionInDays": 30,
    "features": {"immediatePurgeDataOn30Days": true}
    },
"location": "australiasoutheast"
}

**Response**

Status code: 200

```http
{
  "properties": {
    ...
    "retentionInDays": 30,
    "features": {
      "legacy": 0,
      "searchVersion": 1,
      "immediatePurgeDataOn30Days": true,
      ...}
    },
    ...
}

Om du vill ange standardkvarhållningsperioden för analystabeller i en Log Analytics-arbetsyta kör du kommandot az monitor log-analytics workspace update och skickar parametern --retention-time .

I det här exemplet anges tabellens analysbevaring till 30 dagar.

az monitor log-analytics workspace update --resource-group myresourcegroup --retention-time 30 --workspace-name myworkspace

Använd cmdleten Set-AzOperationalInsightsWorkspace för att ange standardkvarhållningsperioden för analys i Analytics-tabeller på en Log Analytics-arbetsyta. I det här exemplet anges standardkvarhållningsperioden för analys till 30 dagar:

Set-AzOperationalInsightsWorkspace -ResourceGroupName "myResourceGroup" -Name "MyWorkspace" -RetentionInDays 30

Konfigurera kvarhållning på tabellnivå

Som standard ärver alla tabeller med analysdataplanen Log Analytics-arbetsytans standardinställning för kvarhållning och har ingen långsiktig kvarhållning. Du kan öka analyskvarhållningsperioden för Analytics-tabeller till upp till 730 dagar till en extra kostnad.

Om du vill lägga till långsiktig kvarhållning i en tabell med en dataplan anger du total kvarhållning till upp till 12 år (4 383 dagar).

Kommentar

För närvarande kan du ange total kvarhållning till upp till 12 år via Azure Portal och API. CLI och PowerShell är begränsade till sju år; supporten kommer att utökas till 12 år därefter.

Så här ändrar du kvarhållningsinställningen för en tabell i Azure Portal:

På menyn Log Analytics-arbetsytor väljer du Tabeller.

På skärmen Tabeller visas alla tabeller i arbetsytan.
Välj snabbmenyn för den tabell som du vill konfigurera och välj Hantera tabell.
Konfigurera inställningar för analyskvarhållning och total kvarhållning i avsnittet Inställningar för datakvarhållning på skärmen för tabellkonfiguration.

Om du vill ändra kvarhållningsinställningen för en tabell anropar du API:et Tabeller – Uppdatering:

PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/Microsoft.OperationalInsights/workspaces/{workspaceName}/tables/{tableName}?api-version=2022-10-01

Du kan använda PUT eller PATCH med följande skillnad:

PUT-API:et anger retentionInDays och totalRetentionInDays till standardvärdet om du inte anger icke-null-värden.
PATCH-API:et ändrar inte retentionInDays eller totalRetentionInDays-värdena om du inte anger dem.

Begärandetext

Begärandetexten innehåller värdena i följande tabell.

Namn	Typ	Beskrivning
egenskaper.retentionInDays	heltal	Tabellens datakvarhållning i dagar. Det här värdet kan vara mellan 4 och 730. Om du anger den här egenskapen till null tillämpas kvarhållningsperioden för arbetsytan. För tabellen Grundläggande och Tilläggsloggar är värdet alltid 30.
egenskaper.totalRetentionIDagar	heltal	Tabellens sammanlagda datalagring inklusive långsiktig lagring. Det här värdet kan vara mellan 4 och 730. eller 1095, 1460, 1826, 2191, 2556, 2922, 3288, 3653, 4018 eller 4383. Ange den här egenskapen till null om du inte vill ha långsiktig kvarhållning.

Exempel

I det här exemplet anges tabellens analyskvarhållning till arbetsytans standardvärde på 30 dagar och den totala kvarhållningen till två år, vilket innebär att den långsiktiga kvarhållningsperioden är 23 månader.

Förfrågan

PATCH https://management.azure.com/subscriptions/00000000-0000-0000-0000-00000000000/resourcegroups/testRG/providers/Microsoft.OperationalInsights/workspaces/testWS/tables/CustomLog_CL?api-version=2022-10-01

Begärandetext

{
    "properties": {
        "retentionInDays": null,
        "totalRetentionInDays": 730
    }
}

Svar

Statuskod: 200

{
    "properties": {
        "retentionInDays": 30,
        "totalRetentionInDays": 730,
        "archiveRetentionInDays": 700,
        ...        
    },
   ...
}

För att ändra kvarhållningsinställningarna för en tabell, kör kommandot az monitor log-analytics workspace table update och ange parametrarna --retention-time och --total-retention-time.

I det här exemplet anges tabellens analyskvarhållning till 30 dagar och den totala kvarhållningen till två år, vilket innebär att den långsiktiga kvarhållningsperioden är 23 månader:

az monitor log-analytics workspace table update --subscription ContosoSID --resource-group ContosoRG --workspace-name ContosoWorkspace --name AzureMetrics --retention-time 30 --total-retention-time 730

Om du vill tillämpa arbetsytans standardkvarhållningsvärde på tabellen igen och återställa den totala kvarhållningen till 0 kör du kommandot az monitor log-analytics workspace table update med parametrarna --retention-time och --total-retention-time inställda på -1.

Till exempel:

az monitor log-analytics workspace table update --subscription ContosoSID --resource-group ContosoRG --workspace-name ContosoWorkspace --name Syslog --retention-time -1 --total-retention-time -1

Använd cmdleten Update-AzOperationalInsightsTable för att ändra kvarhållningsinställningarna för en tabell. I det här exemplet anges tabellens analyskvarhållning till 30 dagar och den totala kvarhållningen till två år, vilket innebär att den långsiktiga kvarhållningsperioden är 23 månader:

Update-AzOperationalInsightsTable -ResourceGroupName ContosoRG -WorkspaceName ContosoWorkspace -TableName AzureMetrics -RetentionInDays 30 -TotalRetentionInDays 730

Om du vill tillämpa arbetsytans standardkvarhållningsvärde på tabellen igen och återställa den totala kvarhållningen till 0 kör du cmdleten Update-AzOperationalInsightsTable med -RetentionInDays parametrarna och -TotalRetentionInDays inställda på -1.

Till exempel:

Update-AzOperationalInsightsTable -ResourceGroupName ContosoRG -WorkspaceName ContosoWorkspace -TableName Syslog -RetentionInDays -1 -TotalRetentionInDays -1

Använd den här ARM-exempelmallen och parameterfilen för att uppdatera kvarhållningsperioden för en specifik tabell.

Mallfil

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "workspaceName": {
      "type": "string",
      "defaultValue": "sampleWorkspace",
      "metadata": {
        "description": "The number of days to retain the data."
      }
    },
    "tableName": {
      "type": "string",
      "defaultValue": "sampleTable",
      "metadata": {
        "description": "The name of the Log Analytics table to modify."
      }
    },
    "retentionInDays": {
      "type": "int",
      "defaultValue": 30,
      "metadata": {
        "description": "The number of days to retain the data."
      }
    }
  },
  "resources": [
    {
      "type": "Microsoft.OperationalInsights/workspaces",
      "apiVersion": "2025-02-01",
      "name": "[parameters('workspaceName')]",
      "location": "[resourceGroup().location]",
      "resources": [
        {
          "type": "Microsoft.OperationalInsights/workspaces/tables",
          "apiVersion": "2025-02-01",
          "name": "[concat(parameters('workspaceName'), '/', parameters('tableName'))]",
          "properties": {
            "retentionInDays": "[parameters('retentionInDays')]"
          },
          "dependsOn": [ "[resourceId('Microsoft.OperationalInsights/workspaces/', parameters('workspaceName'))]" ]
        }
      ]
    }
  ]
}

Parameterfil

{
  "$schema": "https://schema.management.azure.com/schemas/2019-08-01/deploymentParameters.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "workspaceName": {
      "value": "MyWorkspace"
    },
    "tableName": {
      "value": "AppRequests"
    },
    "retentionInDays": {
      "value": 120
    }
  }
}

Hämta kvarhållningsinställningar per tabell

Om du vill visa kvarhållningsinställningarna för en tabell i Azure Portal väljer du Tabeller på Log Analytics-arbetsytor-menyn.

Skärmen Tabeller visar analyskvarhållning och totala kvarhållningsperioder för alla tabeller på arbetsytan.

Om du vill hämta kvarhållningsinställningen för en viss tabell (i det här exemplet SecurityEvent) anropar du Api:et Tabeller – Hämta :

GET /subscriptions/00000000-0000-0000-0000-00000000000/resourceGroups/MyResourceGroupName/providers/Microsoft.OperationalInsights/workspaces/MyWorkspaceName/Tables/SecurityEvent?api-version=2022-10-01

För att få kvarhållningsinställningarna på tabellnivå i din arbetsyta, ange inte ett tabellnamn.

Till exempel:

GET /subscriptions/00000000-0000-0000-0000-00000000000/resourceGroups/MyResourceGroupName/providers/Microsoft.OperationalInsights/workspaces/MyWorkspaceName/Tables?api-version=2022-10-01

Om du vill hämta kvarhållningsinställningen för den angivna tabellen, kör kommandot az monitor log-analytics workspace table show.

Till exempel:

az monitor log-analytics workspace table show --subscription ContosoSID --resource-group ContosoRG --workspace-name ContosoWorkspace --name SecurityEvent

Om du vill hämta kvarhållningsinställningen för en viss tabell kör du cmdleten Get-AzOperationalInsightsTable .

Till exempel:

Get-AzOperationalInsightsTable -ResourceGroupName ContosoRG -WorkspaceName ContosoWorkspace -tableName SecurityEvent

Vad händer med data när du tar bort en tabell på en Log Analytics-arbetsyta?

En Log Analytics-arbetsyta kan innehålla flera typer av tabeller. Vad som händer när du tar bort tabellen är olika för varje:

Tabelltyp	Datakvarhållning	Rekommendationer	Återhämtning
Azure-tabell	En Azure-tabell innehåller loggar från en Azure-resurs eller lösning. När du slutar skicka data från din resurs eller lösning finns data kvar på arbetsytan till slutet av den kvarhållningsperiod som definierats för tabellen och debiteras därefter.	Om du vill minska avgifterna anger du kvarhållning på tabellnivå till fyra dagar, vilket är den minsta period som stöds. Om tabellen som tas bort är associerad med en lösning som ska tas bort (till exempel Sentinel) tar du bort lösningen efter att kvarhållningsperioden på fyra dagar har passerat.	Aktivera lösningen. Dataåterställning utsätts för kvarhållning av tabeller.
Anpassad loggtabell (`table_CL`)	Den anpassade loggtabellen innehåller loggar från API för logginmatning eller HTTP-datainsamlar-API (inaktuellt). När du tar bort en tabell förblir tabellnamnet reserverat i femton dagar. Om du tar bort en tabell i Analytics - eller Basic-planer tas inte data bort. Kvarhållning av tabeller är inställt på kvarhållning av arbetsytor efter femton dagar där kvarhållningsavgifterna följer kvarhållningen i tabellen. Om du tar bort en tabell i En extra plan tas data bort permanent efter femton dagar.	För att minimera avgifterna anger du kvarhållning på tabellnivå till fyra dagar och tar bort tabellen efter fyra dagar när data trimmas.	Analys- eller grundläggande planer: Skapa tabellen med samma namn och schema. Dataåterställning utsätts för kvarhållning av tabeller. Extraplan : Skapa tabellen med samma namn och schema under perioden för mjuk borttagning.
Sökresultattabell (`table_SRCH`)	Tar bort tabellen och data omedelbart och permanent.
Återställd tabell`(table_RST`)	Tar bort hotcache som har allokerats för återställningen, men källtabelldata tas inte bort.

Loggtabeller med standardkvarhållning på 90 dagar

Som standard behåller tabellerna Usage och AzureActivity data i minst 90 dagar utan kostnad. När du ökar lagringstiden för arbetsytan till mer än 90 dagar, ökar du också lagringstiden för dessa tabeller. Dessa tabeller är också kostnadsfria från datainmatningsavgifter.

Tabeller relaterade till Application Insights-resurser behåller även data i 90 dagar utan kostnad. Du kan justera kvarhållningen av var och en av dessa tabeller individuellt:

AppAvailabilityResults
AppBrowserTimings
AppDependencies
AppExceptions
AppEvents
AppMetrics
AppPageViews
AppPerformanceCounters
AppRequests
AppSystemEvents
AppTraces

Prismodell

Analys och långsiktig kvarhållning beräknas baserat på GB-datavolymen och antalet dagar som data behålls. Fakturering för datakvarhållning sker dagligen (baserat på dagar i UTC-tidszonen). Loggdata som har _IsBillable == false omfattas inte av inmatnings- eller kvarhållningsavgifter.

Mer information finns i följande artiklar:

Läs mer om:

Feedback

Var den här sidan till hjälp?

Dela via

Hantera databevarande på en Log Analytics-arbetsyta

Analys, långsiktig och total kvarhållning

Så här fungerar kvarhållningsändringar

Behörigheter som krävs

Konfigurera standardkvarhållningsperioden för analystabeller

Konfigurera kvarhållning på tabellnivå

Hämta kvarhållningsinställningar per tabell

Vad händer med data när du tar bort en tabell på en Log Analytics-arbetsyta?

Loggtabeller med standardkvarhållning på 90 dagar

Prismodell

Relaterat innehåll

Feedback

Ytterligare resurser