Konfigurasikan pencatatan untuk mencatat header permintaan dan parameter kueri - Object Storage Service

Object Storage Service (OSS) secara default mencatat sejumlah field standar dalam log akses untuk analitik dasar. Dalam skenario tertentu, Anda mungkin perlu mencatat field kustom guna mendukung pelacakan dan analisis perilaku pengguna yang lebih rinci atau menyesuaikan pemantauan informasi. Untuk kebutuhan ini, Anda dapat mengonfigurasi field log kustom untuk mencatat header permintaan dan parameter kueri yang ingin dipantau. Field log kustom diagregasikan dalam field user_defined_log_fields.

Informasi latar belakang

Permintaan HTTP umumnya dicirikan oleh header permintaan dan parameter kuerinya. Secara default, log akses OSS hanya mencatat sebagian dari karakteristik tersebut. Untuk informasi lebih lanjut tentang log akses OSS, lihat Log Akses.

Untuk memantau data spesifik yang relevan bagi Anda, Anda dapat mengonfigurasi OSS untuk mencatat header permintaan tambahan dan parameter kueri. Untuk detail lebih lanjut tentang header permintaan dan parameter kueri, lihat RFC 2616.

Skema

Analisis proxy: Log OSS standar tidak mencatat header x-forwarded-for. Jika Anda ingin memantau header ini untuk analisis perantara, Anda dapat mengonfigurasi field log kustom untuk mencatatnya.
Pengkategorian permintaan berdasarkan parameter kueri: Log OSS standar tidak mencatat parameter kueri dalam URL permintaan. Jika Anda ingin mencatat parameter kueri seperti rrr dan eee dalam URL http://bucketname.aliyuncs.com/hu.jpg?yyy=45&eee=88&rrr=huyanbin, Anda dapat mengonfigurasi field log kustom untuk mencatatnya.

Catatan Penggunaan

Setiap baris hanya boleh memuat satu header permintaan atau parameter kueri. Anda dapat menentukan maksimal enam header permintaan dan parameter kueri.
Informasi konfigurasi pencatatan dikodekan dan disimpan dalam field user_defined_log_fields. Nilai dari field user_defined_log_fields adalah data JSON yang dikodekan Base64. Data JSON mencakup field "truncated" yang menunjukkan apakah data dipotong, field "headers" yang berisi header permintaan yang ditentukan, dan field "querys" yang berisi parameter kueri yang ditentukan.
Kunci field kustom untuk header permintaan dapat berisi tanda hubung (-) tetapi tidak boleh berisi garis bawah (_). Kunci field kustom untuk parameter kueri dapat berisi garis bawah (_).
Kunci field kustom untuk header permintaan harus sesuai dengan protokol HTTP dan hanya dapat berisi karakter ASCII yang dapat dicetak (dari 33 hingga 126), kecuali garis bawah (_) dan titik dua (:).
Total panjang kunci dan nilai semua field kustom untuk header permintaan dan parameter kueri tidak boleh melebihi batas 1.024 byte. Data tambahan yang melampaui batas akan dipotong. Kunci field log kustom diubah menjadi huruf kecil dalam log. Tidak ada konversi huruf besar/kecil yang diterapkan pada nilai field log kustom. Nilai field log mewakili informasi yang dikirim dalam permintaan dan dipotong jika batas panjang dilampaui.

Prasyarat

Fitur kueri log waktu nyata harus diaktifkan untuk bucket. Untuk informasi lebih lanjut, lihat Kueri Log Waktu Nyata.
Permintaan yang dikirim ke bucket harus mencakup header permintaan atau parameter kueri terkait. Untuk informasi lebih lanjut, lihat Ajukan Permintaan.

Metode

Gunakan konsol OSS

Masuk ke Konsol OSS.
Di panel navigasi kiri, klik Buckets. Di halaman Buckets, temukan dan klik bucket yang diinginkan.
Di pohon navigasi kiri, pilih Logging > Real-time Log Query.
Di tab Real-time Log Query, klik Add di samping Request Headers or Query Parameters in Logs.
Di kotak dialog Configure Request Header or Query Parameter in Logs, klik Tambah di samping Specify Log Field.
Pilih Request Header atau Query Parameter, masukkan nilai, dan klik OK.
Catatan
Pengaturan field kustom Anda akan berlaku dalam 15 menit.

Gunakan ossutil

Anda dapat menggunakan ossutil untuk mengonfigurasi header permintaan dalam log. Untuk informasi tentang instalasinya, lihat Instal ossutil.

Jalankan perintah berikut untuk menambahkan header permintaan atau parameter kueri kustom, memodifikasi secara dinamis field user_defined_log_fields, dan memungkinkan analisis rinci permintaan terkait examplebucket.

ossutil api put-user-defined-log-fields-config --bucket examplebucket --user-defined-log-fields-configuration "{\"HeaderSet\":{\"header\":[\"header1\",\"header2\",\"header3\"]},\"ParamSet\":{\"parameter\":[\"param1\",\"param2\"]}}"

Operasi API Terkait

Metode yang dijelaskan di atas pada dasarnya diimplementasikan berdasarkan API RESTful, yang dapat Anda panggil langsung jika bisnis Anda memerlukan tingkat penyesuaian yang tinggi. Untuk memanggil API secara langsung, Anda harus menyertakan perhitungan tanda tangan dalam kode Anda. Untuk informasi lebih lanjut, lihat PutUserDefinedLogFieldsConfig.

Referensi

Analisis perantara berdasarkan field log kustom