Aktifkan dan kelola log Analitik Microsoft Azure Storage (klasik)

Analitik Microsoft Azure Storage menyediakan log untuk blob, antrean, dan tabel. Anda dapat menggunakan portal Microsoft Azure untuk mengonfigurasi log yang direkam untuk akun Anda. Artikel ini memperlihatkan kepada Anda cara mengaktifkan dan mengelola metrik. Untuk mempelajari cara mengaktifkan log, lihat Mengaktifkan dan mengelola log Analitik Microsoft Azure Storage (klasik). Ada biaya yang terkait dengan memeriksa data pemantauan di portal Microsoft Azure. Untuk informasi lebih lanjut, lihat Storage Analytics.

Catatan

Kami menyarankan agar Anda menggunakan log Azure Storage di Azure Monitor alih-alih log Storage Analytics. Lihat salah satu artikel berikut ini:

• Memantau Azure Blob Storage
• Memantau Azure Files
• Memantau Azure Queue Storage
• Memantau penyimpanan Azure Table

Aktifkan log

Anda dapat menginstruksikan Microsoft Azure Storage untuk menyimpan log diagnostik untuk membaca, menulis, dan menghapus permintaan untuk layanan blob, tabel, dan antrean. Kebijakan retensi data yang Anda tetapkan juga berlaku untuk log ini.

Catatan

Azure Files saat ini mendukung metrik Analitik Penyimpanan, tetapi tidak mendukung pembuatan log Analitik Penyimpanan.

Portal

1. Di portal Microsoft Azure, pilih Akun penyimpanan, lalu pilih nama akun penyimpanan untuk membuka bilah akun penyimpanan.

2. Pilih Pengaturan diagnostik (klasik) di bagian Pemantauan (klasik) pada bilah menu.

   

3. Pastikan Status diatur ke Aktif, dan pilih layanan yang ingin Anda aktifkan untuk pembuatan log.

   

4. Untuk menyimpan log, pastikan bahwa kotak centang Hapus data dipilih. Lalu, atur jumlah hari yang Anda inginkan untuk data log dipertahankan dengan memindahkan kontrol penggeser di bawah kotak centang, atau dengan langsung memodifikasi nilai yang muncul di kotak teks di samping kontrol penggeser. Default untuk akun penyimpanan baru adalah tujuh hari. Jika Anda tidak ingin mengatur kebijakan penyimpanan, biarkan kotak centang Hapus data tidak dicentang. Jika tidak ada kebijakan retensi, Anda bebas menghapus data log.

   Peringatan

   Log disimpan sebagai data di akun Anda. Data log dapat terakumulasi di akun Anda seiring waktu yang dapat menambah biaya penyimpanan. Jika Anda memerlukan data log hanya untuk jangka waktu yang sedikit, Anda dapat mengurangi biaya dengan mengubah kebijakan retensi data. Data log kedaluwarsa (data yang lebih lama dari kebijakan retensi Anda) dihapus oleh sistem. Sebaiknya tetapkan kebijakan penyimpanan berdasarkan berapa lama Anda ingin menyimpan data log untuk akun Anda. Lihat Penagihan pada metrik penyimpanan untuk informasi selengkapnya.

5. Klik Simpan.

   Log diagnostik disimpan dalam wadah blob bernama $logs di akun penyimpanan Anda. Anda bisa menampilkan data log menggunakan penjelajah penyimpanan seperti Microsoft Azure Storage Explorer, atau secara terprogram menggunakan pustaka klien penyimpanan atau PowerShell.

   Untuk informasi tentang mengakses kontainer $logs, lihat Pembuatan log analitik penyimpanan.

   Catatan

   Untuk akun penyimpanan klasik, kontainer $logs hanya muncul di Azure Storage Explorer. Kontainer $logs tidak terlihat dari browser penyimpanan atau tampilan kontainer yang tersedia di portal Azure.

PowerShell

1. Buka jendela perintah Windows PowerShell.

2. Masuk ke langganan Azure Anda dengan perintah Connect-AzAccount dan ikuti petunjuk pada layar.

   Connect-AzAccount
   

3. Jika identitas Anda dikaitkan dengan lebih dari satu langganan, maka tetapkan langganan aktif Anda.

   $context = Get-AzSubscription -SubscriptionId <subscription-id>
   Set-AzContext $context
   

   Ganti nilai placeholder <subscription-id> dengan ID langganan Anda.

4. Dapatkan konteks akun penyimpanan yang menentukan akun penyimpanan yang akan digunakan.

   $storageAccount = Get-AzStorageAccount -ResourceGroupName "<resource-group-name>" -AccountName "<storage-account-name>"
   $ctx = $storageAccount.Context
   

   • Ganti nilai placeholder <resource-group-name> dengan nama grup sumber daya.

   • Ganti nilai tempat penampung <storage-account-name> dengan nama akun penyimpanan Anda.

5. Gunakan Set-AzStorageServiceLoggingProperty untuk mengubah pengaturan log saat ini. Cmdlet yang mengontrol Pembuatan Log Penyimpanan menggunakan parameter LoggingOperations yang merupakan untai yang berisi daftar tipe permintaan yang dipisahkan koma untuk log. Tiga jenis permintaan yang mungkin baca, tulis, dan hapus. Untuk menonaktifkan pembuatan log, gunakan nilai tidak ada untuk parameter LoggingOperations.

   Perintah berikut ini mengaktifkan pembuatan log untuk permintaan baca, tulis, dan hapus di layanan Antrean di akun penyimpanan default Anda dengan retensi diatur ke lima hari:

   Set-AzStorageServiceLoggingProperty -ServiceType Queue -LoggingOperations read,write,delete -RetentionDays 5 -Context $ctx
   

   Peringatan

   Log disimpan sebagai data di akun Anda. Data log dapat terakumulasi di akun Anda seiring waktu yang dapat menambah biaya penyimpanan. Jika Anda memerlukan data log hanya untuk jangka waktu yang sedikit, Anda dapat mengurangi biaya dengan mengubah kebijakan retensi data. Data log kedaluwarsa (data yang lebih lama dari kebijakan retensi Anda) dihapus oleh sistem. Sebaiknya tetapkan kebijakan penyimpanan berdasarkan berapa lama Anda ingin menyimpan data log untuk akun Anda. Lihat Penagihan pada metrik penyimpanan untuk informasi selengkapnya.

   Perintah berikut ini menonaktifkan pembuatan log untuk layanan tabel di akun penyimpanan default Anda:

   Set-AzStorageServiceLoggingProperty -ServiceType Table -LoggingOperations none -Context $ctx 
   

   Untuk informasi tentang cara mengonfigurasi cmdlet Azure PowerShell agar berfungsi dengan langganan Azure Anda dan cara memilih akun penyimpanan default untuk digunakan, lihat Cara menginstal dan mengonfigurasi Microsoft Azure PowerShell.

.NET

QueueServiceClient queueServiceClient = new QueueServiceClient(connectionString);

QueueServiceProperties serviceProperties = queueServiceClient.GetProperties().Value;

serviceProperties.Logging.Delete = true;

QueueRetentionPolicy retentionPolicy = new QueueRetentionPolicy();
retentionPolicy.Enabled = true;
retentionPolicy.Days = 2;
serviceProperties.Logging.RetentionPolicy = retentionPolicy;

serviceProperties.HourMetrics = null;
serviceProperties.MinuteMetrics = null;
serviceProperties.Cors = null;

queueServiceClient.SetProperties(serviceProperties);

Mengubah periode retensi data log

Data log dapat terakumulasi di akun Anda seiring waktu yang dapat menambah biaya penyimpanan. Jika Anda memerlukan data log hanya untuk jangka waktu yang sedikit, Anda dapat mengurangi biaya dengan mengubah kebijakan retensi data. Misalnya, jika Anda memerlukan log hanya selama tiga hari, atur periode retensi data log Anda ke nilai 3. Dengan begitu log akan dihapus secara otomatis dari akun Anda setelah 3 hari. Bagian ini memperlihatkan kepada Anda cara menampilkan periode retensi data log Anda saat ini, lalu memperbarui periode tersebut jika itu yang ingin Anda lakukan.

Portal

1. Di portal Microsoft Azure, pilih Akun penyimpanan, lalu pilih nama akun penyimpanan untuk membuka bilah akun penyimpanan.

2. Pilih Pengaturan diagnostik (klasik) di bagian Pemantauan (klasik) pada bilah menu.

   

3. Pastikan bahwa kotak centang Hapus data dipilih. Lalu, atur jumlah hari yang Anda inginkan untuk data log dipertahankan dengan memindahkan kontrol penggeser di bawah kotak centang, atau dengan langsung memodifikasi nilai yang muncul di kotak teks di samping kontrol penggeser.

   

   Jumlah hari default untuk akun penyimpanan baru adalah tujuh hari. Jika Anda tidak ingin mengatur kebijakan penyimpanan, biarkan kotak centang Hapus data tidak dicentang. Jika tidak ada kebijakan retensi, Anda bebas menghapus data pemantauan.

4. Klik Simpan.

   Log diagnostik disimpan dalam wadah blob bernama $logs di akun penyimpanan Anda. Anda bisa menampilkan data log menggunakan penjelajah penyimpanan seperti Microsoft Azure Storage Explorer, atau secara terprogram menggunakan pustaka klien penyimpanan atau PowerShell.

   Untuk informasi tentang mengakses kontainer $logs, lihat Pembuatan log analitik penyimpanan.

PowerShell

1. Buka jendela perintah Windows PowerShell.

2. Masuk ke langganan Azure Anda dengan perintah Connect-AzAccount dan ikuti petunjuk pada layar.

   Connect-AzAccount
   

3. Jika identitas Anda dikaitkan dengan lebih dari satu langganan, maka tetapkan langganan aktif Anda.

   $context = Get-AzSubscription -SubscriptionId <subscription-id>
   Set-AzContext $context
   

   Ganti <subscription-id> nilai tempat penampung dengan ID langganan Anda.

4. Dapatkan konteks akun penyimpanan yang menentukan akun penyimpanan yang akan digunakan.

   $storageAccount = Get-AzStorageAccount -ResourceGroupName "<resource-group-name>" -AccountName "<storage-account-name>"
   $ctx = $storageAccount.Context
   

   • Ganti nilai <resource-group-name> tempat penampung dengan nama grup sumber daya.

   • Ganti nilai tempat penampung <storage-account-name> dengan nama akun penyimpanan Anda.

5. Gunakan Get-AzStorageServiceLoggingProperty untuk melihat kebijakan penyimpanan log saat ini. Contoh berikut mencetak ke konsol periode retensi untuk layanan penyimpanan blob dan antrean.

   Get-AzStorageServiceLoggingProperty -ServiceType Blob, Queue -Context $ctx
   

   Di output konsol, periode retensi muncul di bawah judul kolom RetentionDays.

   

6. Gunakan Set-AzStorageServiceLoggingProperty untuk mengubah pengaturan log saat ini. Contoh berikut mengubah periode retensi menjadi 4 hari.

   Set-AzStorageServiceLoggingProperty -ServiceType Blob, Queue -RetentionDays 4 -Context $ctx
   

   Untuk informasi tentang cara mengonfigurasi cmdlet Azure PowerShell agar berfungsi dengan langganan Azure Anda dan cara memilih akun penyimpanan default untuk digunakan, lihat Cara menginstal dan mengonfigurasi Microsoft Azure PowerShell.

.NET

Contoh berikut mencetak ke konsol periode retensi untuk layanan penyimpanan blob dan antrean.

BlobServiceClient blobServiceClient = new BlobServiceClient(connectionString);
QueueServiceClient queueServiceClient = new QueueServiceClient(connectionString);

BlobServiceProperties blobServiceProperties = blobServiceClient.GetProperties().Value;
QueueServiceProperties queueServiceProperties = queueServiceClient.GetProperties().Value;

Console.WriteLine("Retention period for logs from the blob service is: " +
    blobServiceProperties.Logging.RetentionPolicy.Days.ToString());

Console.WriteLine("Retention period for logs from the queue service is: " +
    queueServiceProperties.Logging.RetentionPolicy.Days.ToString());

Contoh berikut mengubah periode retensi menjadi 4 hari.

BlobRetentionPolicy blobRetentionPolicy = new BlobRetentionPolicy();

blobRetentionPolicy.Enabled = true;
blobRetentionPolicy.Days = 4;

QueueRetentionPolicy queueRetentionPolicy = new QueueRetentionPolicy();

queueRetentionPolicy.Enabled = true;
queueRetentionPolicy.Days = 4;

blobServiceProperties.Logging.RetentionPolicy = blobRetentionPolicy;
blobServiceProperties.Cors = null;

queueServiceProperties.Logging.RetentionPolicy = queueRetentionPolicy;
queueServiceProperties.Cors = null;

blobServiceClient.SetProperties(blobServiceProperties);
queueServiceClient.SetProperties(queueServiceProperties);

Console.WriteLine("Retention policy for blobs and queues is updated");

Memverifikasi bahwa data log sedang dihapus

Anda dapat memverifikasi bahwa log sedang dihapus dengan melihat isi kontainer $logs akun penyimpanan Anda. Gambar berikut menunjukkan isi folder dalam kontainer $logs. Folder ini sesuai dengan Januari 2021 dan setiap folder berisi log selama satu hari. Jika hari ini adalah 29 Januari 2021, dan kebijakan penyimpanan Anda diatur ke hanya satu hari, maka folder ini harus berisi log hanya untuk satu hari.

Menampilkan data log

Untuk menampilkan dan menganalisis data log Anda, Anda harus mengunduh blob yang berisi data log yang Anda minati ke mesin lokal. Banyak alat penjelajahan penyimpanan memungkinkan Anda mengunduh blob dari akun penyimpanan Anda; Anda juga dapat menggunakan tim Microsoft Azure Storage menyediakan Azure Copy Tool AzCopy baris perintah untuk mengunduh data log Anda.

Catatan

Kontainer $logs tidak terintegrasi dengan Event Grid, sehingga Anda tidak akan menerima notifikasi saat file log ditulis.

Untuk memastikan Anda mengunduh data log yang Anda minati dan untuk menghindari mengunduh data log yang sama lebih dari sekali:

• Gunakan konvensi penamaan tanggal dan waktu untuk blob yang berisi data log untuk melacak blob mana yang telah Anda unduh untuk analisis guna menghindari mengunduh ulang data yang sama lebih dari sekali.

• Gunakan metadata pada blob yang berisi data log untuk mengidentifikasi periode tertentu di mana blob menyimpan data log untuk mengidentifikasi blob yang tepat untuk Anda unduh.

Untuk mulai menggunakan AzCopy, lihat Mulai menggunakan AzCopy

Contoh berikut menunjukkan bagaimana Anda dapat mengunduh data log untuk layanan antrean untuk jam mulai pukul 09.00, 10.00, dan 11.00 pada 20 Mei 2014.

azcopy copy 'https://mystorageaccount.blob.core.windows.net/$logs/queue' 'C:\Logs\Storage' --include-path '2014/05/20/09;2014/05/20/10;2014/05/20/11' --recursive

Untuk mempelajari selengkapnya tentang cara mengunduh file tertentu, lihat Mengunduh blob dari penyimpanan Azure Blob dengan menggunakan AzCopy v10.

Ketika Anda telah mengunduh data log, Anda bisa melihat entri log dalam file. File log ini menggunakan format teks yang dibatasi yang dapat diurai oleh banyak alat baca log (untuk informasi selengkapnya, lihat panduan Pemantauan, Diagnosis, dan Pemecahan Masalah Microsoft Azure Storage). Alat yang berbeda memiliki fasilitas berbeda untuk memformat, memfilter, mengurutkan, mencari konten file log Anda. Untuk informasi selengkapnya tentang format dan konten file log Pembuatan Log Penyimpanan, lihat Format Log Analitik Penyimpanan dan Operasi Pencatat Analitik Penyimpanan dan Pesan Status.

Langkah berikutnya

• Untuk mempelajari lebih lanjut tentang Analitik Penyimpanan, lihat Analitik Penyimpanan untuk Analitik Penyimpanan.
• Untuk informasi selengkapnya tentang menggunakan bahasa .NET dalam konfigurasi metrik penyimpanan, lihat Pustaka Klien Azure Storage untuk .NET.
• Untuk informasi umum tentang konfigurasi metrik penyimpanan menggunakan REST API, lihat Mengaktifkan dan mengonfigurasi Analitik Penyimpanan.
• Pelajari selengkapnya tentang format log Analitik Penyimpanan. Lihat Format Log Analitik Penyimpanan.