Mengelola retensi data di ruang kerja Analitik Log

Ruang kerja Analitik Log menyimpan data dalam dua status:

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

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

Retensi interaktif, jangka panjang, dan total

Secara default, semua tabel di ruang kerja Analitik Log menyimpan data selama 30 hari, kecuali untuk tabel log dengan retensi default 90 hari. Selama periode ini - periode retensi interaktif - Anda dapat mengambil data dari tabel melalui kueri, dan data tersedia untuk visualisasi, pemberitahuan, dan fitur dan layanan lainnya, berdasarkan paket tabel.

Anda dapat memperpanjang periode retensi interaktif tabel dengan paket Analytics hingga dua tahun. Paket Dasar dan Tambahan memiliki periode retensi interaktif tetap 30 hari.

Catatan

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

Untuk menyimpan data dalam tabel yang sama di luar periode retensi interaktif, perpanjang retensi total tabel hingga 12 tahun. Pada akhir periode retensi interaktif, 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.

Contoh:

• Anda memiliki tabel Analytics yang sudah ada dengan retensi interaktif selama 180 hari dan tidak ada retensi jangka panjang.
• Anda mengubah retensi interaktif 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 interaktif default untuk tabel Analitik di ruang kerja Analitik Log	Microsoft.OperationalInsights/workspaces/write dan microsoft.operationalinsights/workspaces/tables/write izin ke ruang kerja Analitik Log, sebagaimana disediakan oleh peran bawaan Kontributor Analitik Log, misalnya
Mendapatkan pengaturan retensi menurut tabel untuk ruang kerja Analitik Log	Microsoft.OperationalInsights/workspaces/tables/read izin ke ruang kerja Analitik Log, seperti yang disediakan oleh peran bawaan Pembaca Analitik Log, misalnya

Mengonfigurasi periode retensi interaktif default tabel Analytics

Periode retensi interaktif default dari semua tabel di ruang kerja Analitik Log adalah 30 hari. Anda dapat mengubah periode interaktif default tabel Analytics hingga dua tahun dengan memodifikasi pengaturan retensi data tingkat ruang kerja. Tabel Dasar dan Tambahan memiliki periode retensi interaktif tetap 30 hari.

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 interaktif 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 interaktif default tabel Analitik dalam ruang kerja Analitik Log:

1. Dari menu ruang kerja Analitik Log di portal Azure, pilih ruang kerja Anda.

2. 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 interaktif default tabel Analitik dalam ruang kerja Analitik Log, 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 beberapa hari. Nilai yang diizinkan adalah per paket 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 periode retensi interaktif default tabel Analitik dalam ruang kerja Analitik Log, jalankan perintah az monitor log-analytics workspace update dan berikan --retention-time parameter .

Contoh ini mengatur retensi interaktif 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 interaktif default tabel Analytics dalam ruang kerja Analitik Log. Contoh ini menetapkan periode retensi interaktif 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 interaktif default ruang kerja Analitik Log dan tidak memiliki retensi jangka panjang. Anda dapat meningkatkan periode retensi interaktif 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). Paket tabel Tambahan saat ini dalam pratinjau publik, di mana total retensi paket diperbaiki pada 365 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 pengaturan retensi interaktif dan 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 diatur retentionInDays dan totalRetentionInDays ke nilai default jika Anda tidak mengatur 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
properties.retentionInDays	Integer	Retensi data tabel dalam beberapa hari. Nilainya bisa antara 4 dan 730. Mengatur properti ini ke null menerapkan periode retensi ruang kerja. Untuk tabel Log Dasar, nilainya selalu 8.
properties.totalRetentionInDays	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 interaktif tabel ke default ruang kerja 30 hari, dan total retensi 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 teruskan --retention-time parameter dan --total-retention-time .

Contoh ini mengatur retensi interaktif 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 interaktif default ruang kerja ke tabel dan mengatur ulang total retensinya menjadi 0, jalankan perintah az monitor log-analytics workspace table update dengan parameter --retention-time dan --total-retention-time yang 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 mengatur retensi interaktif 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 interaktif default ruang kerja ke tabel dan mengatur ulang retensi totalnya menjadi 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

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 interaktif 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 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
Tabel Azure	Tabel Azure menyimpan log dari sumber daya atau data Azure yang diperlukan oleh layanan atau solusi Azure dan tidak dapat dihapus. Saat Anda menghentikan data streaming dari sumber daya, layanan, atau solusi, data tetap berada di ruang kerja hingga akhir periode retensi yang ditentukan untuk tabel.	Untuk meminimalkan biaya, atur retensi tingkat tabel ke empat hari sebelum Anda menghentikan log streaming ke tabel.
Tabel log kustom (table_CL)	Sementara menghapus tabel hingga akhir retensi tingkat tabel atau periode retensi ruang kerja default. Selama periode penghapusan sementara, Anda terus membayar retensi data dan dapat membuat ulang tabel dan mengakses data dengan menyiapkan tabel dengan nama dan skema yang sama. Empat belas hari setelah Anda menghapus tabel kustom, Azure Monitor menghapus konfigurasi retensi tingkat tabel dan menerapkan retensi ruang kerja default.	Untuk meminimalkan biaya, atur retensi tingkat tabel ke empat hari sebelum Anda menghapus tabel.
Tabel hasil pencarian (table_SRCH)	Menghapus tabel dan data segera dan secara permanen.
Tabel yang dipulihkan (table_RST)	Menghapus singgahan panas yang disediakan 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

Biaya untuk menambahkan retensi interaktif dan retensi jangka panjang dihitung berdasarkan volume data yang Anda simpan, dalam GB, dan jumlah atau hari tempat Anda menyimpan data. Data log yang memiliki _IsBillable == false tidak dikenakan biaya penyerapan atau retensi.

Untuk informasi selengkapnya, lihat Harga Azure Monitor.

Langkah berikutnya

Pelajari lebih lanjut tentang:

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