Mengelola retensi data di ruang kerja Analitik Log

Ruang kerja Analitik Log menyimpan data dalam dua status:

• Retensi analitik: Dalam status ini, data tersedia untuk pemantauan, pemecahan masalah, dan analitik mendekati real-time.
• Retensi jangka panjang: Dalam kondisi biaya rendah ini, data tidak tersedia untuk fitur paket tabel, tetapi dapat diakses melalui tugas pencarian.

Artikel ini menjelaskan cara ruang kerja Analitik Log menyimpan data dan cara mengelola retensi data tabel di ruang kerja Anda.

Analitik, jangka panjang, dan retensi total

Secara default, semua tabel di ruang kerja Analitik Log menyimpan data selama 30 hari, kecuali untuk tabel log dengan retensi default 90 hari. Tabel dengan paket Analytics menjadikan data Anda tersedia untuk kueri langsung selama periode retensi Analytics ini. Semua paket tabel dapat mengambil data yang disimpan melalui kueri atau pekerjaan pencarian, dan data tersedia untuk visualisasi, pemberitahuan, dan fitur dan layanan lainnya, berdasarkan paket tabel.

Anda dapat memperpanjang periode retensi analitik tabel dengan paket Analytics hingga dua tahun. Tabel rencana dasar memiliki periode tetap selama 30 hari untuk kueri, sementara tabel rencana tambahan dapat dikueri untuk seluruh periode retensi. Tabel Dasar dan Tabel Pendukung sama-sama memiliki pertimbangan tambahan. Untuk informasi selengkapnya, lihat Data kueri dalam tabel Dasar dan Tambahan.

Catatan

Anda dapat mengurangi periode retensi analitik tabel Analytics menjadi sesedikit empat hari menggunakan API atau CLI. Namun, karena retensi analitik selama 31 hari disertakan dalam harga penyerapan, menurunkan periode retensi di bawah 31 hari tidak mengurangi biaya.

Untuk menyimpan data dalam tabel yang sama di luar periode retensi default, perpanjang retensi total tabel hingga 12 tahun. Di akhir periode retensi analitik, data tetap berada dalam tabel selama sisa periode retensi total yang Anda konfigurasikan. Selama periode ini - periode retensi jangka panjang - jalankan pekerjaan pencarian untuk mengambil data tertentu yang Anda butuhkan dari tabel dan membuatnya tersedia untuk kueri interaktif dalam tabel hasil pencarian.

Cara kerja modifikasi retensi

Saat Anda mempersingkat total retensi tabel, Log Azure Monitor menunggu 30 hari sebelum menghapus data, sehingga Anda dapat mengembalikan perubahan dan menghindari kehilangan data jika Anda membuat kesalahan dalam konfigurasi.

Saat Anda meningkatkan total retensi, periode retensi baru berlaku untuk semua data yang sudah diserap ke dalam tabel dan belum dihapus.

Saat Anda mengubah pengaturan retensi jangka panjang tabel dengan data yang ada, perubahan akan segera berlaku.

Example:

• Anda memiliki tabel Analytics yang sudah ada dengan retensi analitik 180 hari dan tidak ada retensi jangka panjang.
• Anda mengubah retensi analitik menjadi 90 hari tanpa mengubah periode retensi total 180 hari.
• Azure Monitor secara otomatis memperlakukan sisa 90 hari dari total retensi sebagai retensi bernilai rendah dan jangka panjang, sehingga data yang berusia 90-180 hari tidak hilang.

Izin yang diperlukan

Perbuatan	Izin yang diperlukan
Mengonfigurasi retensi analitik default untuk tabel Analitik di ruang kerja Analitik Log	Microsoft.OperationalInsights/workspaces/write dan microsoft.operationalinsights/workspaces/tables/write izin ke ruang kerja Log Analytics, sebagaimana disediakan oleh peran bawaan Kontributor Log Analytics, misalnya
Dapatkan pengaturan retensi menurut tabel untuk ruang kerja Log Analitik	Microsoft.OperationalInsights/workspaces/tables/read izin untuk ruang kerja Analitik Log seperti yang diberikan oleh peran bawaan Pembaca Analitik Log, misalnya

Mengonfigurasi periode retensi analitik default untuk tabel Analitik

Periode retensi default tabel Analitik di ruang kerja Analitik Log adalah 30 hari. Anda dapat mengubah periode analitik default tabel Analytics hingga dua tahun dengan memodifikasi pengaturan retensi data tingkat ruang kerja. Tabel Dasar dan Tambahan hanya memiliki periode retensi total, yaitu 30 hari secara default.

Mengubah pengaturan retensi data tingkat ruang kerja default secara otomatis memengaruhi semua tabel Analitik tempat pengaturan default masih berlaku di ruang kerja Anda. Jika Anda telah mengubah retensi analitik tabel tertentu, tabel tersebut tidak terpengaruh saat Anda mengubah pengaturan retensi data default ruang kerja.

Penting

Ruang kerja dengan retensi 30 hari mungkin menyimpan data selama 31 hari. Jika Anda perlu menyimpan data selama 30 hari hanya untuk mematuhi kebijakan privasi, konfigurasikan retensi ruang kerja default menjadi 30 hari menggunakan API dan perbarui immediatePurgeDataOn30Days properti ruang kerja ke true. Operasi ini saat ini hanya didukung menggunakan Workspaces - Update API.

Portal

Untuk mengatur periode retensi default tabel Analitik di dalam workspace Log Analytics:

1. Dari menu Ruang Kerja Log Analytics di portal Azure, pilih ruang kerja Anda.

2. Di bagian Pengaturan , pilih Penggunaan dan perkiraan biaya di panel kiri.

3. Pilih Retensi Data di bagian atas halaman.

   

4. Gerakkan penggeser untuk menambah atau mengurangi jumlah hari, lalu pilih Oke.

API

Untuk mengatur periode retensi default tabel Analytics dalam ruang kerja Log Analytics, panggil API Workspaces - Create Or Update:

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

Badan permintaan

Badan permintaan menyertakan nilai dalam tabel berikut.

Nama	Tipe	Deskripsi
properties.retentionInDays	Integer	Retensi data ruang kerja dalam hitungan hari. Nilai yang diizinkan ditentukan oleh rencana harga. Lihat dokumentasi tingkat harga untuk detailnya.
location	string	Lokasi geografis sumber daya.
immediatePurgeDataOn30Days	Boolean	Bendera yang menunjukkan apakah data segera dihapus setelah 30 hari dan tidak dapat dipulihkan. Hanya berlaku saat retensi ruang kerja diatur ke 30 hari.

Contoh

Contoh ini mengatur retensi ruang kerja ke default ruang kerja 30 hari dan memastikan bahwa data segera dihapus setelah 30 hari dan tidak dapat dipulihkan.

Permintaan

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

CLI

Untuk mengatur default periode retensi analitik tabel Analitik di dalam Log Analytics workspace, jalankan perintah az monitor log-analytics workspace update dan sertakan parameter --retention-time.

Contoh ini mengatur retensi analitik tabel menjadi 30 hari:

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

PowerShell

Gunakan cmdlet Set-AzOperationalInsightsWorkspace untuk mengatur periode retensi analitik default tabel Analitik dalam ruang kerja Analitik Log. Contoh ini menetapkan periode retensi analitik default menjadi 30 hari:

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

Mengonfigurasi retensi tingkat tabel

Secara default, semua tabel dengan paket data Analytics mewarisi pengaturan retensi default ruang kerja Analitik Log dan tidak memiliki retensi jangka panjang. Anda dapat meningkatkan periode retensi analitik tabel Analytics hingga 730 hari dengan biaya tambahan.

Untuk menambahkan retensi jangka panjang ke tabel dengan paket data apa pun, atur retensi total hingga 12 tahun (4.383 hari).

Catatan

Saat ini, Anda dapat mengatur retensi total hingga 12 tahun melalui portal Azure dan API. CLI dan PowerShell dibatasi hingga tujuh tahun; dukungan selama 12 tahun akan mengikuti.

Portal

Untuk mengubah pengaturan retensi untuk tabel di portal Azure:

1. Dari menu ruang kerja Analitik Log, pilih Tabel.

   Layar Tabel mencantumkan semua tabel di ruang kerja.

2. Pilih menu konteks untuk tabel yang ingin Anda konfigurasi dan pilih Kelola tabel.

   

3. Konfigurasikan retensi analitik dan pengaturan retensi total di bagian Pengaturan retensi data di layar konfigurasi tabel.

   

API

Untuk mengubah pengaturan retensi untuk tabel, panggil Tables - Update API:

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

Anda dapat menggunakan PUT atau PATCH, dengan perbedaan berikut:

• PUT API menetapkan retentionInDays dan totalRetentionInDays ke nilai default jika Anda tidak memberikan nilai non-null.
• PATCH API tidak mengubah retentionInDays nilai atau totalRetentionInDays jika Anda tidak menentukan nilai.

Badan permintaan

Badan permintaan menyertakan nilai dalam tabel berikut.

Nama	Tipe	Deskripsi
properti.retensiDalamHari	Integer	Retensi data tabel dalam satuan hari. Nilainya bisa antara 4 dan 730. Mengatur properti ini ke nol akan menerapkan periode retensi ruang kerja. Untuk tabel Log Dasar dan Tambahan, nilainya selalu 30.
properties.retensiTotalDalamHari	Integer	Total retensi data tabel termasuk retensi jangka panjang. Nilai ini bisa antara 4 dan 730; atau 1095, 1460, 1826, 2191, 2556, 2922, 3288, 3653, 4018, atau 4383. Atur properti ini ke null jika Anda tidak ingin retensi jangka panjang.

Contoh

Contoh ini mengatur retensi analitik tabel ke default ruang kerja 30 hari, dan retensi total menjadi dua tahun, yang berarti bahwa periode retensi jangka panjang adalah 23 bulan.

Permintaan

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

Badan permintaan

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

Respons

Kode Status: 200

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

CLI

Untuk mengubah pengaturan retensi tabel, jalankan perintah az monitor log-analytics workspace table update dan masukkan parameter --retention-time dan --total-retention-time.

Contoh ini menetapkan retensi analitik tabel menjadi 30 hari, dan retensi total menjadi dua tahun, yang berarti bahwa periode retensi jangka panjang adalah 23 bulan:

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

Untuk menerapkan kembali nilai retensi default ruang kerja ke tabel dan mengatur ulang retensi totalnya ke 0, jalankan perintah az monitor log-analytics workspace table update dengan --retention-time parameter dan --total-retention-time diatur ke -1.

Contohnya:

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

Gunakan cmdlet Update-AzOperationalInsightsTable untuk mengubah pengaturan retensi tabel. Contoh ini menetapkan retensi analitik tabel menjadi 30 hari, dan retensi total menjadi dua tahun, yang berarti bahwa periode retensi jangka panjang adalah 23 bulan:

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

Untuk menerapkan kembali nilai retensi default ruang kerja ke tabel dan mengatur ulang retensi totalnya ke 0, jalankan cmdlet Update-AzOperationalInsightsTable dengan -RetentionInDays parameter dan -TotalRetentionInDays diatur ke -1.

Contohnya:

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

ARM (JSON)

Gunakan contoh file templat dan parameter ARM (JSON) ini untuk memperbarui periode retensi untuk tabel tertentu.

File templat

{
    "$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'))]" ]
                }
            ]
        }
    ]
}

File parameter

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

Bisep

Gunakan contoh templat Bicep dan file parameter ini untuk memperbarui periode retensi untuk tabel tertentu.

File templat

@description('The number of days to retain the data.')
param workspaceName string = 'sampleWorkspace'

@description('The name of the Log Analytics table to modify.')
param tableName string = 'sampleTable'

@description('The number of days to retain the data.')
param retentionInDays int = 30

resource workspace 'Microsoft.OperationalInsights/workspaces@2025-02-01' = {
    name: workspaceName
    location: resourceGroup().location
}

resource workspaceName_table 'Microsoft.OperationalInsights/workspaces/tables@2025-02-01' = {
    parent: workspace
    name: '${tableName}'
    properties: {
        retentionInDays: retentionInDays
    }
}

File parameter

using './<template-name>.bicep'

param workspaceName string = 'MyWorkspace'
param tableName string = 'AppRequests'
param retentionInDays int = 120

Mendapatkan pengaturan retensi menurut tabel

Portal

Untuk melihat pengaturan retensi tabel di portal Azure, dari menu ruang kerja Analitik Log, pilih Tabel.

Layar Tabel memperlihatkan retensi analitik dan periode retensi total untuk semua tabel di ruang kerja.

API

Untuk mendapatkan pengaturan retensi tabel tertentu (dalam contoh ini, SecurityEvent), panggil Tables - Get API:

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

Untuk mendapatkan semua pengaturan retensi tingkat tabel di ruang kerja Anda, jangan atur nama tabel.

Contohnya:

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

CLI

Untuk mendapatkan pengaturan retensi tabel tertentu, jalankan perintah az monitor log-analytics workspace table show.

Contohnya:

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

PowerShell

Untuk mendapatkan pengaturan retensi tabel tertentu, jalankan cmdlet Get-AzOperationalInsightsTable .

Contohnya:

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

Apa yang terjadi pada data saat Anda menghapus tabel di ruang kerja Analitik Log?

Ruang kerja Analitik Log dapat berisi beberapa jenis tabel. Apa yang terjadi saat Anda menghapus tabel berbeda untuk masing-masing:

Jenis tabel	Retensi data	Rekomendasi	Pemulihan
Tabel Azure	Tabel Azure menyimpan log dari sumber daya Azure, atau solusi. Saat Anda berhenti mengirim data dari sumber daya, atau solusi, data tetap berada di ruang kerja hingga akhir periode retensi yang ditentukan untuk tabel, dan dikenakan biaya yang sesuai.	Untuk mengurangi biaya, atur retensi data tingkat tabel menjadi empat hari, yang merupakan periode minimum yang dapat didukung. Jika tabel yang dihapus dikaitkan dengan solusi yang harus dihapus (misalnya, Sentinel), hapus solusi setelah periode retensi empat hari berlalu.	Aktifkan solusi. Pemulihan data dibatasi oleh retensi tabel.
Tabel log khusus (table_CL)	Tabel log kustom menyimpan log dari API penyerapan log, atau API pengumpul data HTTP (tidak digunakan lagi). Saat Anda menghapus tabel, nama tabel tetap dicadangkan selama lima belas hari. Menghapus tabel di Paket Analitik atau Dasar tidak menghapus data. Retensi tabel diatur sesuai dengan retensi ruang kerja setelah lima belas hari, di mana biaya retensi mengikuti pengaturan retensi dalam tabel. Menghapus tabel dalam rencana Auxiliary akan menyebabkan data terhapus secara permanen setelah lima belas hari.	Untuk meminimalkan biaya, atur retensi tingkat tabel menjadi empat hari, dan hapus tabel setelah empat hari saat data dipangkas.	Analitik atau Dasar: Buat tabel dengan nama dan skema yang sama. Pemulihan data dibatasi oleh retensi tabel. Rencana tambahan : Buat tabel dengan nama dan skema yang sama selama periode penghapusan sementara.
Tabel hasil pencarian (table_SRCH)	Menghapus tabel dan data segera dan secara permanen.
Tabel yang dipulihkan(table_RST)	Menghapus cache panas yang dialokasikan untuk pemulihan, tetapi data tabel sumber tidak dihapus.

Tabel log dengan retensi default 90 hari

Secara default, Usage tabel dan AzureActivity menyimpan data setidaknya selama 90 hari tanpa biaya. Saat Anda meningkatkan retensi ruang kerja menjadi lebih dari 90 hari, Anda juga meningkatkan retensi tabel ini. Tabel ini juga bebas dari biaya penyerapan data.

Tabel yang terkait dengan sumber daya Application Insights juga menyimpan data selama 90 hari tanpa biaya. Anda dapat menyesuaikan retensi masing-masing tabel ini satu per satu:

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

Rencana harga

Analitik dan retensi jangka panjang dihitung berdasarkan volume data GB dan jumlah hari data dipertahankan. Penagihan untuk retensi data terjadi setiap hari (berdasarkan hari di zona waktu UTC). Data log yang memiliki _IsBillable == false tidak dikenakan biaya penyerapan atau retensi.

Untuk informasi lebih lanjut, baca artikel berikut:

• Penagihan retensi.
• Harga retensi Azure Monitor.

Konten terkait

Pelajari lebih lanjut tentang:

• Mengelola data pribadi di Log Azure Monitor
• Membuat pekerjaan pencarian untuk mengambil data yang sesuai dengan kriteria tertentu
• Memulihkan data untuk rentang waktu tertentu