Akses pencatatan

MediaPackage menyediakan log akses yang menangkap informasi terperinci tentang permintaan yang dikirim ke MediaPackage saluran atau grup kemasan Anda. MediaPackage menghasilkan log akses masuk untuk permintaan yang dikirim ke titik akhir input saluran, dan log akses keluar untuk permintaan yang dikirim ke titik akhir saluran atau aset grup kemasan Anda. Setiap log berisi informasi, seperti waktu permintaan diterima, alamat IP klien, latensi, jalur permintaan, dan respons server. Anda dapat menggunakan log akses ini untuk menganalisis kinerja layanan dan memecahkan masalah. Mereka juga dapat membantu Anda mempelajari basis pelanggan Anda dan memahami MediaPackage tagihan Anda.

Pencatatan akses adalah fitur opsional MediaPackage yang dinonaktifkan secara default. Setelah Anda mengaktifkan pencatatan akses, MediaPackage menangkap log dan menyimpannya ke grup CloudWatch log yang Anda tentukan saat Anda membuat atau mengelola pencatatan akses. Biaya CloudWatch Log Khas berlaku.

Izin untuk mempublikasikan log akses ke CloudWatch

Saat Anda mengaktifkan pencatatan akses, MediaPackage buat peran terkait layanan IAMAWSServiceRoleForMediaPackage, di akun Anda. AWS Peran ini memungkinkan MediaPackage untuk mempublikasikan log akses ke CloudWatch. Untuk informasi tentang cara MediaPackage menggunakan peran terkait layanan, lihat. Menggunakan Peran Tertaut Layanan untuk MediaPackage

Mengaktifkan pengelogan akses

Anda dapat mengaktifkan log akses menggunakan AWS Management Console atauAWS CLI.

Untuk mengaktifkan log akses untuk saluran yang ada menggunakan konsol

1. Buka MediaPackage konsol di https://console.aws.amazon.com/mediapackage/.

2. Pilih saluran Anda.

3. Di bagian Konfigurasi Log Akses, lakukan hal berikut:

   1. Pilih Aktifkan log akses masuk atau Aktifkan log akses keluar, atau keduanya.

   2. Anda dapat menentukan nama grup CloudWatch Log kustom. Jika dibiarkan kosong, grup default digunakan.

Untuk mengaktifkan log akses untuk grup kemasan yang ada menggunakan konsol

1. Buka MediaPackage konsol di https://console.aws.amazon.com/mediapackage/.

2. Pilih Grup kemasan dari bagian navigasi.

3. Pilih grup kemasan Anda.

   1. Pilih Edit di bilah navigasi.

   2. Di bagian Access logging, pilih Aktifkan log akses keluar.

   3. Anda dapat menentukan nama grup CloudWatch Log kustom. Jika dibiarkan kosong, grup default digunakan.

4. Pilih Save changes (Simpan perubahan).

Untuk mengaktifkan log akses untuk saluran menggunakan AWS CLI

Gunakan perintah configurre-logs dengan --ingress-access-logs parameter, --egress-access-logs parameter, atau keduanya, untuk mengaktifkan logging akses. Anda dapat menyertakan nama grup CloudWatch log untuk --egress-access-logs parameter --ingress-access-logs dan. Jika Anda tidak menentukan nama grup log, maka grup log MediaPackage default akan digunakan. Untuk log masuk, grup log default adalah/aws/MediaPackage/IngressAccessLogs, dan untuk log keluar grup log default adalah. /aws/MediaPackage/EgressAccessLogs

Gunakan perintah berikut untuk mengaktifkan log masuk dan akses menggunakan grup log default:

aws mediapackage configure-logs --id channel-name --ingress-access-logs {} --egress-access-logs {}

Perintah ini tidak memiliki nilai kembali.

Untuk mengaktifkan log akses untuk grup kemasan menggunakan AWS CLI

Gunakan perintah configurre-logs dengan --egress-access-logs parameter untuk mengaktifkan akses logging. Anda dapat menyertakan nama grup CloudWatch log untuk --egress-access-logs parameter. Jika Anda tidak menentukan nama grup log, maka grup log MediaPackage default akan digunakan. Untuk log masuk, grup log default adalah/aws/MediaPackage/IngressAccessLogs, dan untuk log keluar grup log default adalah. /aws/MediaPackage/EgressAccessLogs

Gunakan perintah berikut untuk mengaktifkan log akses keluar menggunakan grup log default:

aws mediapackage configure-logs --id package-name --egress-access-logs {}

Perintah ini tidak memiliki nilai kembali.

Menonaktifkan pengelogan akses

Anda dapat menonaktifkan log akses untuk MediaPackage saluran atau grup kemasan kapan saja.

Untuk menonaktifkan pengelogan akses menggunakan konsol

1. Buka MediaPackage konsol di https://console.aws.amazon.com/mediapackage/.

   Pilih saluran atau grup paket Anda.

2. Pilih Edit.

3. Di bagian Access logging, batalkan pilihan Ingress access logging, Egress access logging, atau keduanya.

4. Pilih Save changes (Simpan perubahan).

Untuk menonaktifkan pencatatan akses untuk saluran menggunakan AWS CLI

Gunakan configure-logs perintah untuk menonaktifkan logging akses. Jika satu atau beberapa parameter log akses tidak dideklarasikan dengan configure-logs perintah, maka log akses yang sesuai dinonaktifkan. Misalnya, dalam perintah berikut log akses keluar diaktifkan untuk saluran, dan log akses masuk dinonaktifkan:

aws mediapackage configure-logs --id channel-name --egress-access-logs {}

Perintah ini tidak memiliki nilai kembali.

Untuk menonaktifkan pencatatan akses untuk grup kemasan menggunakan AWS CLI

Gunakan configure-logs perintah untuk menonaktifkan logging akses. Jika satu atau beberapa parameter log akses tidak dideklarasikan dengan configure-logs perintah, maka log akses yang sesuai dinonaktifkan. Misalnya, dalam perintah berikut configure-logs tidak termasuk --egress-access-logs sehingga log keluar dinonaktifkan:

aws mediapackage configure-logs --id package-group-name

Perintah ini tidak memiliki nilai kembali.

Akses format log

File log akses terdiri dari urutan catatan log berformat JSON, di mana setiap catatan log mewakili satu permintaan. Urutan bidang dalam log dapat bervariasi. Berikut ini adalah contoh log akses jalan keluar saluran:

{
    "timestamp": "2020-07-13T18:59:56.293656Z",
    "clientIp": "192.0.2.0/24",
    "processingTime": 0.445,
    "statusCode": "200",
    "receivedBytes": 468,
    "sentBytes": 2587370,
    "method": "GET",
    "request": "https://aaabbbcccdddee.mediapackage.us-east-1.amazonaws.com:443/out/v1/75ee4f20e5df43e5821e5cb17ea19238/hls_7_145095.ts?m=1538005779",
    "protocol": "HTTP/1.1",
    "userAgent": "sabr/3.0 Mozilla/5.0 (Windows; U; Windows NT 5.1; en-US) AppleWebKit/528.18 (KHTML, like Gecko) Version/4.0 Safari/528.17",
    "account": "111122223333",
    "channelId": "my_channel",
    "channelArn": "arn:aws:mediapackage:us-west-2:111122223333:channels/ExampleChannelID",
    "domainName": "aaabbbcccdddee.mediapackage.us-east-1.amazonaws.com",
    "requestId": "aaaAAA111bbbBBB222cccCCC333dddDDD",
    "endpointId": "my_endpoint",
    "endpointArn": "arn:aws:mediapackage:us-west-2:111122223333:origin_endpoints/ExampleEndpointID"
}

Daftar berikut menjelaskan bidang catatan log, secara berurutan:

stempel waktu

Waktu hari ketika permintaan diterima. Nilainya adalah waktu ISO-8601 tanggal dan didasarkan pada jam sistem host yang melayani permintaan.

ClienTip

Alamat IP dari klien yang meminta.

ProcessingTime

Jumlah detik yang MediaPackage dihabiskan untuk memproses permintaan Anda. Nilai ini diukur dari waktu byte terakhir permintaan Anda diterima hingga saat byte pertama respons dikirim.

StatusCode

Kode status HTTP numerik dari respons.

DiterimaBytes

Jumlah byte dalam badan permintaan yang diterima MediaPackage server.

SentBytes

Jumlah byte dalam badan respons yang dikirim MediaPackage server. Nilai ini sering sama dengan nilai Content-Length header yang disertakan dengan respons server.

metode

Metode permintaan HTTP yang digunakan untuk permintaan: DELETE, GET, HEAD, OPTIONS, PATCH, POST, atau PUT.

permintaan

URL permintaan.

protokol

Jenis protokol yang digunakan untuk permintaan, seperti HTTP.

UserAgent

String user-agent yang mengidentifikasi klien yang berasal dari permintaan, terlampir dalam tanda kutip ganda. String terdiri dari satu atau lebih pengidentifikasi produk, produk/versi. Jika string lebih panjang dari 8 KB, string akan terpotong.

akun

ID AWS akun akun yang digunakan untuk membuat permintaan.

ChannelID

ID saluran yang menerima permintaan.

ChannelARN

Nama Sumber Daya Amazon (ARN) dari saluran yang menerima permintaan.

domainName

Domain indikasi nama server yang disediakan oleh klien selama jabat tangan TLS, terlampir dalam tanda kutip ganda. Nilai ini disetel ke - jika klien tidak mendukung SNI atau domain tidak cocok dengan sertifikat dan sertifikat default disajikan kepada klien.

RequesTid

String yang dihasilkan oleh MediaPackage untuk mengidentifikasi setiap permintaan secara unik.

EndpointID

ID titik akhir yang menerima permintaan.

EndpointArn

Nama Sumber Daya Amazon (ARN) dari titik akhir yang menerima permintaan.

Urutan bidang di log dapat bervariasi.

Baca log akses

MediaPackage menulis log akses ke Amazon CloudWatch Logs. Biaya CloudWatch Log Khas berlaku. Gunakan Wawasan CloudWatch Log untuk membaca log akses. Untuk informasi tentang cara menggunakan Wawasan CloudWatch Log, lihat Menganalisis Data Log dengan Wawasan CloudWatch Log di Panduan Pengguna AWS CloudWatch Log.

catatan

Log akses dapat memakan waktu beberapa menit untuk muncul CloudWatch. Jika Anda tidak melihat log, tunggu beberapa menit dan coba lagi.

Contoh

Bagian ini mencakup contoh kueri yang dapat Anda gunakan untuk membaca data log MediaPackage debug.

contoh Lihat respons kode status HTTP untuk saluran.

Gunakan kueri ini untuk melihat respons dengan kode status HTTP untuk saluran. Anda dapat menggunakan ini untuk melihat respons kode kesalahan HTTP untuk membantu Anda memecahkan masalah.

fields @timestamp, @message
| filter channelId like 'my-channel'
| stats count() by statusCode

contoh Dapatkan jumlah permintaan per titik akhir pada saluran.

fields @timestamp, @message
| filter channelId like 'my-channel'
| stats count() by endpointId

contoh Lihat kode status per aset.

fields @timestamp, @message
| filter assetArnlike 'my-asset-id'
| stats count() by statusCode

contoh Dapatkan waktu respons P99 untuk konfigurasi kemasan dari waktu ke waktu

fields @timestamp, @message
| filter packagingConfigArn like 'my-dash-config'
| stats pct(processingTime, 99) by bin(5m)