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. MediaTailor Untuk pelaporan sisi server, atur mode log dalam permintaan * pemutaran. * Untuk pelaporan sisi klien, atur mode log dalam permintaan inisialisasi * sesi. *
Ketika mode log diatur untuk debug, MediaTailor tulis semua jenis peristiwa CloudWatch log ke Log. Log memberikan informasi tentang peristiwa berikut. Untuk daftar lengkap data yang dihasilkan dalam log debug, lihat kolom log [ Debug. ](https://docs.aws.amazon.com/mediatailor/latest/ug/debug-log-mode.html#debug-log-mode-fields)
+ **Interaksi asal ** — Rincian tentang MediaTailor interaksi dengan server asal. Misalnya, respon manifes asal, jenis manifes, dan URL asal.
+ **Manifes yang dihasilkan ** — Detail tentang respons sesi pemutaran dari MediaTailor. Misalnya, manifes yang MediaTailor menghasilkan.
+ **Sesi diinisialisasi ** — Detail inisialisasi sesi, seperti ID sesi.
Untuk menyesuaikan jenis peristiwa log yang Anda terima per sesi, lihat[Memfilter log dan peristiwa](logs-filter.md).
## Prasyarat
Untuk mengatur mode log ke debug, pertama-tama Anda perlu 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 akses, CloudWatch lihat Men [ yiapkan Izin untuk Amazon CloudWatch](https://docs.aws.amazon.com/mediatailor/latest/ug/monitoring-permissions.html).
## Cara mengatur mode log untuk debug
Bagian ini menjelaskan cara mengatur mode log untuk debug untuk pelaporan sisi server dan pelaporan sisi klien.
### Server-side pelaporan
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 [ Server-side Pelaporan. ](https://docs.aws.amazon.com/mediatailor/latest/ug/ad-reporting-server-side.html)
**penting**
Nilai `DEBUG` ini bersifat peka huruf besar-kecil.
Permintaan pemutaran yang menyer `?aws.logMode=DEBUG` takan terlihat seperti berikut:
**Example Permintaan pemutaran ke titik akhir HLS**
```
GET {{}}/v1/master/{{}}/{{}}/{{}}?aws.logMode=DEBUG
```
Setelah Anda mengatur mode log ke debug, sebaiknya verifikasi bahwa sesi pencatatan 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](#debug-active).
### Client-side pelaporan
Untuk pelaporan sisi klien, sertakan `logMode` kunci dan `DEBUG` nilai dalam badan permintaan inisialisasi `POST HTTP` sesi klien Anda ke titik akhir MediaTailor /. v1/session Untuk informasi umum tentang pelaporan sisi klien, lihat [ Client-Side Pelaporan. ](https://docs.aws.amazon.com/mediatailor/latest/ug/ad-reporting-client-side.html)
**penting**
Nilai `DEBUG` ini bersifat peka huruf besar-kecil.
Setelah Anda mengatur mode log ke debug, sebaiknya verifikasi 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](#debug-active).
## Sesi debug aktif maksimum
Anda dapat memiliki maksimal 10 sesi log debug aktif. Saat pemain mengirimkan inisialisasi sesi atau permintaan pemutaran ke MediaTailor, MediaTailor periksa untuk melihat apakah batas telah tercapai. Jika ya, MediaTailor periksa untuk melihat apakah ada sesi basi. Sesi menjadi basi jika belum diakses dalam jangka waktu tertentu. Untuk streaming langsung periode waktu ini adalah 10 menit, untuk streaming VOD 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 mungkin telah mencapai batas ini. Untuk mengonfirmasi apakah batas telah tercapai, lihat[Verify that the debug log mode is active for your playback session](#debug-active).
## 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 terkait dengan peristiwa log debug. |
| eventType | Jenis peristiwa log debug. Nilai:+ `ORIGIN_INTERACTION`— Rincian tentang MediaTailor interaksi dengan server asal. Misalnya, respon manifes asal, jenis manifes, dan URL asal.
+ `GENERATED_MANIFEST`— Detail tentang respons sesi pemutaran dari MediaTailor. Misalnya, manifes yang MediaTailor menghasilkan.
+ `SESSION_INITIALIZED`— Rincian inisialisasi sesi, seperti ID sesi. |
| originRequestUrl | URL server asal Anda yang diambil untuk permintaan ini. |
| mediaTailorPath | T MediaTailor itik akhir yang dipanggil, termasuk parameter apa pun yang diteruskan MediaTailor dalam permintaan manifes awal. |
| requestId | ID permintaan HTTP tertentu ke MediaTailor. |
| responseBody | Manifest dalam badan 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 biasa berlaku. Gunakan CloudWatch Wawasan untuk membaca log debug. Untuk informasi tentang cara menggunakan CloudWatch Logs Insights, lihat [ Menganalisis Data CloudWatch Log dengan Wawasan Log ](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/AnalyzingLogData.html) 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](#debug-active).
### Contoh
Bagian ini mencakup contoh kueri yang dapat Anda gunakan untuk membaca data log MediaTailor debug.
**Example 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
```
**Example 2: Lihat tanggapan dari asal Anda**
```
fields @timestamp, responseBody, @message, mediaTailorPath
| filter eventType = "ORIGIN_MANIFEST" and sessionId = "{{32002de2-837c-4e3e-9660-f3075e8dfd90}}"
```
**Example 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}}"
```
**Example 4: Lihat semua acara untuk `requesTid tertentu`**
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}}"
```