Menghasilkan 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 data log debug ke CloudWatch Log. Log debug memberikan informasi tentang peristiwa berikut. Untuk daftar lengkap data yang dihasilkan di log debug, lihat Bidang log debug.

• Interaksi asal — Detail MediaTailor tentang interaksi dengan server asal. Misalnya, respons manifes asal, tipe manifes, dan asalURL.

• Manifes yang dihasilkan - Detail tentang respons sesi pemutaran dari MediaTailor. Misalnya, manifes yang MediaTailor menghasilkan.

• Sesi diinisialisasi — Rincian inisialisasi sesi, seperti ID sesi.

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 HLS akhir

GET <mediatailorURL>/v1/master/<hashed-account-id>/<origin-id>/<asset-id>?aws.logMode=DEBUG

Setelah Anda mengatur mode log ke debug, kami sarankan Anda memverifikasi bahwa sesi logging debug aktif. Untuk memverifikasi bahwa sesi debug aktif, periksa 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 VOD streaming itu 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: ORIGIN_INTERACTION— Detail MediaTailor tentang interaksi dengan server asal. Misalnya, respons manifes asal, tipe manifes, dan asalURL. GENERATED_MANIFEST— Detail tentang respons sesi pemutaran dari MediaTailor. Misalnya, manifes yang MediaTailor menghasilkan. SESSION_INITIALIZED— Rincian inisialisasi sesi, seperti ID sesi.
originRequestUrl	Server URL asal Anda yang diambil untuk permintaan ini.
mediaTailorPath	MediaTailor Titik akhir yang dipanggil, termasuk parameter apa pun yang diteruskan ke MediaTailor permintaan manifes awal.
requestId	ID HTTP permintaan khusus 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:HLS, DASH

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 Log.

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"