Správa uchovávání dat v pracovním prostoru služby Log Analytics

Pracovní prostor služby Log Analytics uchovává data ve dvou stavech:

• Interaktivní uchovávání: V tomto stavu jsou data dostupná pro monitorování, řešení potíží a analýzy téměř v reálném čase.
• Dlouhodobé uchovávání: V tomto nízkém stavu nejsou data dostupná pro funkce plánu tabulky, ale dají se k němu přistupovat prostřednictvím úloh vyhledávání.

Tento článek vysvětluje, jak pracovní prostory služby Log Analytics uchovávají data a jak spravovat uchovávání dat v pracovním prostoru.

Interaktivní, dlouhodobé a celkové uchovávání

Ve výchozím nastavení všechny tabulky v pracovním prostoru služby Log Analytics uchovávají data po dobu 30 dnů s výjimkou tabulek protokolů s výchozím uchováváním 90 dnů. Během tohoto období – interaktivní doba uchovávání – můžete načíst data z tabulky prostřednictvím dotazů a data jsou k dispozici pro vizualizace, výstrahy a další funkce a služby na základě plánu tabulky.

Interaktivní dobu uchovávání tabulek můžete rozšířit plánem Analýzy až na dva roky. Plány Basic a Auxiliary mají pevnou interaktivní dobu uchovávání 30 dnů.

Poznámka:

Interaktivní dobu uchovávání tabulek Analytics můžete snížit až na čtyři dny pomocí rozhraní API nebo rozhraní příkazového řádku. Vzhledem k tomu, že 31 dnů interaktivního uchovávání jsou zahrnuté v ceně příjmu dat, snížení doby uchovávání pod 31 dnů nezmenšuje náklady.

Pokud chcete uchovávat data ve stejné tabulce nad rámec doby interaktivního uchovávání, prodlužte celkovou dobu uchování tabulky až na 12 let. Na konci interaktivní doby uchovávání zůstanou data v tabulce po zbytek doby uchovávání, kterou nakonfigurujete. Během tohoto období – doba dlouhodobého uchovávání – spusťte úlohu vyhledávání, která načte z tabulky konkrétní data, která potřebujete, a zpřístupnit je interaktivním dotazům v tabulce výsledků hledání.

Jak fungují změny uchovávání informací

Když zkrátíte celkovou dobu uchování tabulky, protokoly služby Azure Monitor počká 30 dní před odebráním dat, takže můžete změnu vrátit a vyhnout se ztrátě dat, pokud jste v konfiguraci udělali chybu.

Když zvýšíte celkovou dobu uchovávání, nová doba uchovávání se vztahuje na všechna data, která byla do tabulky už ingestována a ještě nebyla odebrána.

Když změníte nastavení dlouhodobého uchovávání tabulky s existujícími daty, změny se projeví okamžitě.

Příklad:

• Máte existující tabulku Analytics s 180 dny interaktivního uchovávání a bez dlouhodobého uchovávání.
• Interaktivní uchovávání změníte na 90 dnů, aniž byste změnili celkovou dobu uchovávání 180 dnů.
• Azure Monitor automaticky zachází se zbývajícími 90 dny celkového uchovávání jako s nízkými náklady, dlouhodobým uchováváním, aby se neztratila data, která mají 90 až 180 dnů.

Požadována oprávnění

Akce	Požadována oprávnění
Konfigurace výchozího interaktivního uchovávání pro tabulky Analytics v pracovním prostoru služby Log Analytics	Microsoft.OperationalInsights/workspaces/write a microsoft.operationalinsights/workspaces/tables/write oprávnění k pracovnímu prostoru služby Log Analytics, jak poskytuje předdefinovaná role přispěvatele Log Analytics, například
Získání nastavení uchovávání informací podle tabulky pro pracovní prostor služby Log Analytics	Microsoft.OperationalInsights/workspaces/tables/read oprávnění k pracovnímu prostoru služby Log Analytics, jak poskytuje integrovaná role Čtenář Log Analytics, například

Konfigurace výchozího interaktivního období uchovávání tabulek Analytics

Výchozí interaktivní doba uchovávání všech tabulek v pracovním prostoru služby Log Analytics je 30 dnů. Výchozí interaktivní období tabulek Analytics můžete změnit až na dva roky úpravou nastavení uchovávání dat na úrovni pracovního prostoru. Základní a pomocné tabulky mají pevnou interaktivní dobu uchovávání 30 dnů.

Změna výchozího nastavení uchovávání dat na úrovni pracovního prostoru automaticky ovlivní všechny tabulky Analytics, na které se výchozí nastavení stále vztahuje ve vašem pracovním prostoru. Pokud jste už změnili interaktivní uchovávání konkrétní tabulky, nebude to mít vliv na změnu výchozího nastavení uchovávání dat pracovního prostoru.

Důležité

Pracovní prostory s 30denním uchováváním můžou uchovávat data po dobu 31 dnů. Pokud potřebujete uchovávat data pouze po dobu 30 dnů, abyste vyhověli zásadám ochrany osobních údajů, nakonfigurujte výchozí uchovávání pracovních prostorů na 30 dnů pomocí rozhraní API a aktualizujte immediatePurgeDataOn30Days vlastnost pracovního prostoru na true. Tato operace se v současné době podporuje jenom pomocí rozhraní Workspaces – Update API.

Azure Portal

Nastavení výchozího interaktivního období uchovávání tabulek Analytics v pracovním prostoru služby Log Analytics:

1. V nabídce pracovních prostorů služby Log Analytics na webu Azure Portal vyberte svůj pracovní prostor.

2. V levém podokně vyberte Využití a odhadované náklady .

3. V horní části stránky vyberte Uchovávání dat.

   

4. Posuňte posuvník, aby se zvýšil nebo snížil počet dní, a pak vyberte OK.

Rozhraní API

Pokud chcete nastavit výchozí interaktivní dobu uchovávání tabulek Analytics v pracovním prostoru služby Log Analytics, zavolejte pracovní prostory – Vytvoření nebo aktualizace rozhraní API:

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

Text požadavku

Text požadavku obsahuje hodnoty v následující tabulce.

Name	Typ	Popis
properties.retentionInDays	integer	Uchovávání dat pracovního prostoru ve dnech. Povolené hodnoty jsou pro každý cenový plán. Podrobnosti najdete v dokumentaci k cenám.
location	string	Geografické umístění prostředku.
immediatePurgeDataOn30Days	boolean	Příznak, který označuje, jestli se data okamžitě odeberou po 30 dnech a nejsou použitelná. Platí pouze v případě, že je uchovávání pracovních prostorů nastavené na 30 dnů.

Příklad

Tento příklad nastaví uchovávání pracovního prostoru na výchozí hodnotu 30 dnů a zajistí, že se data okamžitě odeberou po 30 dnech a nepůjdou obnovit.

Požádat

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,
      ...
    },
    ...

Rozhraní příkazového řádku

Pokud chcete nastavit výchozí interaktivní dobu uchovávání tabulek Analytics v pracovním prostoru služby Log Analytics, spusťte příkaz az monitor log-analytics workspace update a předejte --retention-time parametr.

Tento příklad nastaví interaktivní uchovávání tabulky na 30 dnů:

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

PowerShell

Pomocí rutiny Set-AzOperationalInsightsWorkspace nastavte výchozí interaktivní dobu uchovávání tabulek Analytics v pracovním prostoru služby Log Analytics. Tento příklad nastaví výchozí interaktivní dobu uchovávání na 30 dnů:

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

Konfigurace uchovávání na úrovni tabulky

Ve výchozím nastavení všechny tabulky s datovým plánem Analytics dědí výchozí nastavení interaktivního uchovávání informací pracovního prostoru služby Log Analytics a nemají dlouhodobé uchovávání. Interaktivní dobu uchovávání tabulek Analytics můžete zvýšit až na 730 dnů za příplatek.

Pokud chcete do tabulky s jakýmkoli datovým plánem přidat dlouhodobé uchovávání, nastavte celkové uchovávání až na 12 let (4 383 dní). Pomocný plán tabulky je aktuálně ve verzi Public Preview, během které je celková doba uchovávání plánu pevná na 365 dnů.

Poznámka:

V současné době můžete nastavit celkové uchovávání až na 12 let prostřednictvím webu Azure Portal a rozhraní API. Rozhraní příkazového řádku a PowerShellu jsou omezené na sedm let; podpora po dobu 12 let bude následovat.

Azure Portal

Úprava nastavení uchovávání pro tabulku na webu Azure Portal:

1. V nabídce Pracovních prostorů služby Log Analytics vyberte Tabulky.

   Na obrazovce Tabulky jsou uvedeny všechny tabulky v pracovním prostoru.

2. Vyberte místní nabídku tabulky, kterou chcete nakonfigurovat, a vyberte Spravovat tabulku.

   

3. V části Nastavení uchovávání dat na obrazovce konfigurace tabulky nakonfigurujte nastavení interaktivního uchovávání a celkového uchovávání dat.

   

Rozhraní API

Pokud chcete upravit nastavení uchovávání pro tabulku, zavolejte rozhraní Tables – Update API:

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

Můžete použít PUT nebo PATCH s následujícím rozdílem:

• Rozhraní PUT API nastaví retentionInDays výchozí hodnotu, totalRetentionInDays pokud nenastavíte hodnoty, které nemají hodnotu null.
• Rozhraní PATCH API nezmění retentionInDays hodnoty ani totalRetentionInDays hodnoty, pokud nezadáte hodnoty.

Text požadavku

Text požadavku obsahuje hodnoty v následující tabulce.

Name	Typ	Popis
properties.retentionInDays	integer	Uchovávání dat v tabulce ve dnech. Tato hodnota může být mezi 4 a 730. Nastavení této vlastnosti na hodnotu null použije dobu uchování pracovního prostoru. V tabulce Základní protokoly je hodnota vždy 8.
properties.totalRetentionInDays	integer	Celková doba uchovávání dat v tabulce včetně dlouhodobého uchovávání. Tato hodnota může být mezi 4 a 730; nebo 1095, 1460, 1826, 2191, 2556, 2922, 3288, 3653, 4018 nebo 4383. Pokud nechcete dlouhodobé uchovávání, nastavte tuto vlastnost na hodnotu null.

Příklad

Tento příklad nastaví interaktivní uchovávání tabulky na výchozí pracovní prostor 30 dnů a celkové uchovávání na dva roky, což znamená, že doba dlouhodobého uchovávání je 23 měsíců.

Požádat

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

Text požadavku

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

Response

Stavový kód: 200

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

Rozhraní příkazového řádku

Pokud chcete upravit nastavení uchovávání informací v tabulce, spusťte příkaz az monitor log-analytics workspace table update a předejte parametry--retention-time.--total-retention-time

Tento příklad nastaví interaktivní uchovávání tabulky na 30 dnů a celkové uchovávání na dva roky, což znamená, že doba dlouhodobého uchovávání je 23 měsíců:

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

Pokud chcete znovu použít výchozí hodnotu interaktivního uchovávání informací pracovního prostoru pro tabulku a obnovit její celkovou dobu uchování na 0, spusťte příkaz az monitor log-analytics workspace update s parametry nastavenými --total-retention-time --retention-time na -1.

Příklad:

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

PowerShell

K úpravě nastavení uchovávání tabulky použijte rutinu Update-AzOperationalInsightsTable . Tento příklad nastaví interaktivní uchovávání tabulky na 30 dnů a celkové uchovávání na dva roky, což znamená, že doba dlouhodobého uchovávání je 23 měsíců:

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

Pokud chcete znovu použít výchozí hodnotu interaktivního uchovávání informací pracovního prostoru pro tabulku a obnovit její celkovou dobu uchování na hodnotu 0, spusťte rutinu Update-AzOperationalInsightsTable s parametry nastavenými -RetentionInDays -TotalRetentionInDays na -1.

Příklad:

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

Získání nastavení uchovávání informací podle tabulky

Azure Portal

Pokud chcete zobrazit nastavení uchovávání informací v tabulce na webu Azure Portal, vyberte v nabídce Pracovních prostorů služby Log Analytics možnost Tabulky.

Na obrazovce Tabulky se zobrazuje interaktivní doba uchovávání a celková doba uchovávání pro všechny tabulky v pracovním prostoru.

Rozhraní API

Pokud chcete získat nastavení uchovávání konkrétní tabulky (v tomto příkladu SecurityEvent), zavolejte tabulky – Získat rozhraní API:

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

Pokud chcete získat všechna nastavení uchovávání na úrovni tabulky v pracovním prostoru, nenastavujte název tabulky.

Příklad:

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

Rozhraní příkazového řádku

Pokud chcete získat nastavení uchovávání konkrétní tabulky, spusťte příkaz az monitor log-analytics workspace table show .

Příklad:

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

PowerShell

Pokud chcete získat nastavení uchovávání konkrétní tabulky, spusťte rutinu Get-AzOperationalInsightsTable .

Příklad:

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

Co se stane s daty při odstranění tabulky v pracovním prostoru služby Log Analytics?

Pracovní prostor služby Log Analytics může obsahovat několik typů tabulek. Co se stane, když odstraníte tabulku, se pro každou z nich liší:

Typ tabulky	Uchovávání dat	Doporučení
Tabulka Azure	Tabulka Azure obsahuje protokoly z prostředku Azure nebo dat požadovaných službou Nebo řešením Azure a není možné je odstranit. Když zastavíte streamování dat z prostředku, služby nebo řešení, zůstanou data v pracovním prostoru až do konce doby uchovávání definované pro tabulku.	Pokud chcete minimalizovat poplatky, nastavte uchovávání na úrovni tabulky na čtyři dny před zastavením protokolů streamování do tabulky.
Vlastní tabulka protokolů (table_CL)	Soft deletes the table until the end of the table-level retention or default workspace retention period. Během období obnovitelného odstranění budete dál platit za uchovávání dat a můžete znovu vytvořit tabulku a získat přístup k datům nastavením tabulky se stejným názvem a schématem. Čtrnáct dní po odstranění vlastní tabulky azure Monitor odebere konfiguraci uchovávání na úrovni tabulky a použije výchozí uchovávání pracovních prostorů.	Pokud chcete minimalizovat poplatky, nastavte uchovávání na úrovni tabulky na čtyři dny před odstraněním tabulky.
Tabulka výsledků hledání (table_SRCH)	Odstraní tabulku a data okamžitě a trvale.
Obnovená tabulka (table_RST)	Odstraní horkou mezipaměť zřízenou pro obnovení, ale zdrojová data tabulky se neodstraní.

Protokolování tabulek s 90denním výchozím uchováváním

Ve výchozím nastavení Usage data a AzureActivity tabulky udržují data nejméně po dobu 90 dnů bez poplatku. Když zvýšíte uchovávání pracovních prostorů na více než 90 dnů, zvýšíte také uchovávání těchto tabulek. Tyto tabulky jsou také bezplatné z poplatků za příjem dat.

Tabulky související s prostředky Application Insights také udržují data po dobu 90 dnů bez poplatků. Uchování každé z těchto tabulek můžete upravit jednotlivě:

• AppAvailabilityResults
• AppBrowserTimings
• AppDependencies
• AppExceptions
• AppEvents
• AppMetrics
• AppPageViews
• AppPerformanceCounters
• AppRequests
• AppSystemEvents
• AppTraces

Cenový model

Poplatek za přidání interaktivního uchovávání a dlouhodobého uchovávání se vypočítá na základě objemu uchovávaných dat v GB a počtu nebo dnů, po které data uchováváte. Data protokolu, která _IsBillable == false nejsou předmětem příjmu dat ani poplatků za uchovávání.

Další informace najdete v tématu o cenách služby Azure Monitor.

Další kroky

Přečtěte si další informace:

• Správa osobních údajů v protokolech služby Azure Monitor
• Vytvoření úlohy vyhledávání pro načtení pomocných dat odpovídajících konkrétním kritériím
• Obnovení dat z pomocné úrovně pro určitý časový rozsah