Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# 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.
**Topics**
+ [Izin untuk mempublikasikan log akses ke CloudWatch](#permissions)
+ [Mengaktifkan pengelogan akses](#enable-access-logging)
+ [Menonaktifkan pengelogan akses](#disable-access-logging)
+ [Akses format log](#access-log-format)
+ [Baca log akses](#read-access-logs)
## Izin untuk mempublikasikan log akses ke CloudWatch
Saat Anda mengaktifkan pencatatan akses, MediaPackage buat peran terkait layanan IAM`AWSServiceRoleForMediaPackage`, 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](using-service-linked-roles.md)
## Mengaktifkan pengelogan akses
Anda dapat mengaktifkan log akses menggunakan Konsol Manajemen AWS atau AWS CLI.
**Untuk mengaktifkan log akses untuk saluran yang ada menggunakan konsol**
1. Buka MediaPackage konsol di [https://console.aws.amazon.com/mediapackage/](https://console.aws.amazon.com/mediapackage/).
1. Pilih saluran Anda.
1. Di bagian **Konfigurasi Log Akses**, lakukan hal berikut:
1. Pilih **Aktifkan log akses masuk** atau **Aktifkan log akses keluar**, atau keduanya.
1. 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/](https://console.aws.amazon.com/mediapackage/).
1. Pilih **Grup kemasan** dari bagian navigasi.
1. Pilih grup kemasan Anda.
1. Pilih **Edit** di bilah navigasi.
1. Di bagian **Access logging**, pilih **Aktifkan log akses keluar**.
1. Anda dapat menentukan **nama grup CloudWatch Log** kustom. Jika dibiarkan kosong, grup default digunakan.
1. Pilih **Simpan perubahan**.
**Untuk mengaktifkan log akses untuk saluran menggunakan AWS CLI**
Gunakan perintah [configurre-logs](https://docs.aws.amazon.com/cli/latest/reference/mediapackage/configure-logs.html) 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 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](https://docs.aws.amazon.com/cli/latest/reference/mediapackage-vod/configure-logs.html) 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 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/](https://console.aws.amazon.com/mediapackage/).
Pilih saluran atau grup paket Anda.
1. Pilih **Edit**.
1. Di bagian **Access logging**, batalkan pilihan **Ingress access logging**, **Egress access logging**, atau keduanya.
1. Pilih **Simpan perubahan**.
**Untuk menonaktifkan akses logging 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](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/AnalyzingLogData.html) 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.
**Example 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
```
**Example Dapatkan jumlah permintaan per titik akhir pada saluran.**
```
fields @timestamp, @message
| filter channelId like 'my-channel'
| stats count() by endpointId
```
**Example Lihat kode status per aset.**
```
fields @timestamp, @message
| filter assetArnlike 'my-asset-id'
| stats count() by statusCode
```
**Example 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)
```