Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
Menghasilkan AWS Elemental MediaTailor log debug
Gunakan log debug untuk memecahkan masalah sesi pemutaran penyisipan MediaTailor iklan. Untuk menghasilkan log debug, atur mode log untuk debug dalam permintaan pemain ke. MediaTailor Untuk pelaporan sisi server, atur mode log dalam permintaan pemutaran. Untuk pelaporan sisi klien, atur mode log dalam permintaan inisialisasi sesi.
Saat mode log diatur ke debug, MediaTailor tulis semua jenis peristiwa log ke CloudWatch Log. Log memberikan informasi tentang peristiwa berikut. Untuk daftar lengkap data yang dihasilkan di log debug, lihat Bidang log debug.
-
Interaksi asal — Detail tentang MediaTailor interaksi dengan server asal. Misalnya, respons manifes asal, tipe manifes, dan URL asal.
-
Manifes yang dihasilkan - Detail tentang respons sesi pemutaran dari MediaTailor. Misalnya, manifes yang MediaTailor menghasilkan.
-
Sesi diinisialisasi — Rincian inisialisasi sesi, seperti ID sesi.
Untuk menyesuaikan jenis peristiwa log yang Anda terima per sesi, lihat. Memfilter log dan acara
Prasyarat
Untuk mengatur mode log ke debug, pertama-tama Anda harus memberikan MediaTailor izin untuk mengirim log ke CloudWatch, jika Anda belum melakukannya. Setelah Anda memberikan izin MediaTailor untuk mengakses CloudWatch, maka Anda siap untuk mengaktifkan mode log debug. Untuk informasi tentang cara memberikan MediaTailor izin untuk mengakses, CloudWatch lihat Menyiapkan Izin untuk Amazon CloudWatch.
Cara mengatur mode log ke debug
Bagian ini menjelaskan cara mengatur mode log ke debug untuk pelaporan sisi server dan pelaporan sisi klien.
Pelaporan sisi server
Untuk pelaporan sisi server, sertakan parameter ?aws.logMode=DEBUG kueri dan nilai dalam permintaan GET HTTP pemutaran pemain Anda ke titik akhir HLS atau DASH. MediaTailor Untuk informasi umum tentang pelaporan sisi server, lihat Pelaporan sisi server.
penting
Nilai DEBUG ini bersifat peka huruf besar-kecil.
Permintaan pemutaran yang menyertakan ?aws.logMode=DEBUG terlihat seperti berikut:
contoh Permintaan pemutaran ke titik akhir HLS
GET <mediatailorURL>/v1/master/<hashed-account-id>/<origin-id>/<asset-id>?aws.logMode=DEBUGSetelah Anda mengatur mode log ke debug, kami sarankan Anda memverifikasi bahwa sesi logging debug aktif. Untuk memverifikasi bahwa sesi debug aktif, periksa untuk melihat apakah ada CloudWatch log untuk ID sesi. ID sesi disertakan dalam titik akhir pemutaran yang MediaTailor menyediakan. Untuk informasi selengkapnya, lihat Verify that the debug log mode is active for your playback session.
Pelaporan sisi klien
Untuk pelaporan sisi klien, sertakan logMode kunci dan DEBUG nilai dalam badan permintaan inisialisasi POST HTTP sesi klien Anda ke titik akhir /v1/session. MediaTailor Untuk informasi umum tentang pelaporan sisi klien, lihat Pelaporan Sisi Klien.
penting
Nilai DEBUG ini bersifat peka huruf besar-kecil.
Setelah Anda mengatur mode log ke debug, kami sarankan Anda memverifikasi bahwa sesi debug aktif. Untuk memverifikasi bahwa sesi debug aktif, konfirmasikan bahwa ada SESSION_INITIALIZED peristiwa yang terkait dengan ID sesi di CloudWatch log. ID sesi disertakan dalam titik akhir pemutaran yang MediaTailor menyediakan. Untuk informasi selengkapnya, lihat Verify that the debug log mode is active for your playback session.
Sesi debug aktif maksimum
Anda dapat memiliki maksimal 10 sesi log debug aktif. Ketika pemain Anda mengirim inisialisasi sesi atau permintaan pemutaran ke MediaTailor, MediaTailor periksa untuk melihat apakah batas telah tercapai. Jika sudah, MediaTailor periksa untuk melihat apakah ada sesi basi. Sesi sudah basi jika belum diakses dalam jangka waktu tertentu. Untuk streaming langsung periode waktu ini adalah 10 menit, untuk streaming VOD adalah 30 menit.
Jika batas sesi log debug aktif maksimum telah tercapai, log debug tidak ditulis ke CloudWatch Log untuk sesi Anda. Jika Anda tidak melihat log debug di CloudWatch Log untuk sesi Anda, Anda bisa mencapai batas ini. Untuk mengonfirmasi apakah batas telah tercapai, lihatVerify that the debug log mode is active for your playback session.
Bidang log debug
Tabel berikut mencantumkan bidang log debug yang MediaTailor menulis ke CloudWatch.
| Bidang | Deskripsi |
|---|---|
awsAccountId |
Akun AWS ID Anda. |
customerId |
ID MediaTailor pelanggan Anda. |
eventTimestamp |
Stempel waktu ISO 8601 yang terkait dengan peristiwa log debug. |
eventType |
Jenis peristiwa log debug. Nilai:
|
originRequestUrl |
URL server asal Anda yang diambil untuk permintaan ini. |
mediaTailorPath |
MediaTailor Titik akhir yang dipanggil, termasuk parameter apa pun yang diteruskan ke MediaTailor dalam permintaan manifes awal. |
requestId |
ID permintaan HTTP tertentu untuk MediaTailor. |
responseBody |
Manifestasi dalam tubuh respons dari MediaTailor. Ini adalah manifes asal mentah atau manifes yang dihasilkan oleh MediaTailor. |
sessionId |
ID sesi pemutaran. |
sessionType |
Jenis sesi pemutaran. Nilai: |
Baca log debug
MediaTailor menulis log debug ke Amazon CloudWatch Logs. Biaya CloudWatch Log Khas berlaku. Gunakan CloudWatch Wawasan untuk membaca log debug. Untuk informasi tentang cara menggunakan Wawasan CloudWatch Log, lihat Menganalisis Data Log dengan Wawasan CloudWatch Log di Panduan Pengguna AWS CloudWatch Logs.
catatan
Log debug dapat memakan waktu beberapa menit untuk muncul. CloudWatch Jika Anda tidak melihat log, tunggu beberapa menit dan coba lagi. Jika Anda masih tidak melihat log, bisa jadi Anda telah mencapai jumlah maksimum sesi log debug aktif. Untuk memverifikasi apakah ini masalahnya, jalankan CloudWatch kueri untuk melihat apakah ada sesi debug yang diinisialisasi untuk sesi pemutaran Anda. Untuk informasi selengkapnya, lihat Verify that the debug log mode is active for your playback session.
Contoh
Bagian ini mencakup contoh kueri yang dapat Anda gunakan untuk membaca data log MediaTailor debug.
contoh 1: Verifikasi bahwa mode log debug aktif untuk sesi pemutaran Anda
fields @timestamp, @message | filter sessionId = "32002de2-837c-4e3e-9660-f3075e8dfd90" | filter eventType = "SESSION_INITIALIZED" # client-side reporting or mediaTailorPath like “/v1/master" # server-side reporting HLS or mediaTailorPath like “/v1/dash" # server-side reporting DASH
contoh 2: Lihat tanggapan dari asal Anda
fields @timestamp, responseBody, @message, mediaTailorPath | filter eventType = "ORIGIN_MANIFEST" and sessionId = "32002de2-837c-4e3e-9660-f3075e8dfd90"
contoh 3: Lihat manifes yang dihasilkan oleh MediaTailor untuk sesi tertentu
fields @timestamp, responseBody, @message | filter mediaTailorPath like "/v1/master/" and eventType = "GENERATED_MANIFEST" and sessionId = "32002de2-837c-4e3e-9660-f3075e8dfd90"
contoh 4: Lihat semua acara untuk diberikan requestId
Gunakan kueri ini untuk melihat manifes asal dan manifes yang dihasilkan oleh MediaTailor.
fields @timestamp, responseBody, @message, mediaTailorPath | filter requestId = "e5ba82a5-f8ac-4efb-88a0-55bed21c45b4"
