

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# Memantau dan menandai sumber daya AWS Elemental MediaTailor
<a name="monitoring"></a>

Pemantauan adalah bagian penting dari menjaga keandalan, ketersediaan, dan kinerja AWS Elemental MediaTailor dan AWS solusi Anda yang lain. AWS menyediakan alat pemantauan berikut untuk menonton MediaTailor, melaporkan ketika ada sesuatu yang salah, dan mengambil tindakan otomatis bila perlu:
+ *Amazon CloudWatch* memantau AWS sumber daya Anda dan aplikasi yang Anda jalankan AWS secara real time. Anda dapat mengumpulkan dan melacak metrik, membuat dasbor yang disesuaikan, dan mengatur alarm yang memberi tahu Anda atau mengambil tindakan saat metrik tertentu mencapai ambang batas yang ditentukan. Misalnya, Anda dapat membuat CloudWatch melacak penggunaan CPU atau metrik lain dari instans Amazon EC2 Anda dan secara otomatis meluncurkan instans baru ketika diperlukan. Untuk informasi selengkapnya, lihat [Panduan CloudWatch Pengguna Amazon](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/).
+ *Amazon CloudWatch Logs* memungkinkan Anda memantau, menyimpan, dan mengakses file log Anda dari semua interaksi dengan server keputusan iklan (ADS) Anda. AWS Elemental MediaTailor memancarkan log untuk permintaan iklan, pengalihan, tanggapan, serta permintaan dan tanggapan pelaporan. Kesalahan dari ADS dan server asal juga dipancarkan ke grup log di Amazon. CloudWatch MediaTailor juga memberikan informasi tentang iklan yang dilewati dan alasan mereka dilewati. Untuk informasi selengkapnya, lihat [Pemecahan masalah melewatkan iklan](troubleshooting-ad-skipping-overview.md). Anda juga dapat mengarsipkan data log dalam penyimpanan yang sangat durabel. Untuk informasi umum, lihat [Panduan Pengguna Amazon CloudWatch Logs](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/). Untuk informasi tentang log ADS dan cara mengaksesnya untuk analisis melalui Amazon CloudWatch Logs Insights, lihat[AWS Elemental MediaTailor Analisis log ADS di Amazon CloudWatch Logs Insights](monitor-cloudwatch-ads-logs.md).

**Topics**
+ [Melihat AWS Elemental MediaTailor log](monitoring-through-logs.md)
+ [Pemantauan AWS Elemental MediaTailor dengan CloudWatch metrik Amazon](monitoring-cloudwatch-metrics.md)
+ [Merekam panggilan AWS Elemental MediaTailor API](logging-using-cloudtrail.md)
+ [Menerima peringatan perakitan AWS Elemental MediaTailor saluran](channel-assembly-alerts.md)
+ [Sumber daya penandaan AWS Elemental MediaTailor](tagging.md)
+ [Memantau layanan AWS media dengan monitor alur kerja](monitor-with-workflow-monitor.md)

# Melihat AWS Elemental MediaTailor log
<a name="monitoring-through-logs"></a>

MediaTailor memancarkan log yang menggambarkan berbagai tonggak dan aktivitas di saluran dan konfigurasi pemutaran. Anda dapat menggunakan log ini untuk mendapatkan visibilitas ke dalam alur kerja Anda dan untuk memecahkan masalah dengan layanan. Topik berikut menjelaskan log dan opsi logging. 

**Topics**
+ [Log ADS](ads-log-format.md)
+ [Log manifes](log-types.md)
+ [Log transkode](tm-log-format.md)
+ [Menggunakan log vended](vended-logs.md)
+ [Menulis log ke CloudWatch Log](monitoring-cw-logs.md)
+ [Mengontrol volume log sesi penyisipan iklan](log-configuration.md)
+ [Memfilter log dan acara](logs-filter.md)
+ [Menghasilkan log debug](debug-log-mode.md)

# AWS Elemental MediaTailor Deskripsi log ADS dan jenis acara
<a name="ads-log-format"></a>

Bagian berikut menjelaskan log yang MediaTailor dipancarkan untuk mendeskripsikan peristiwa dengan server keputusan iklan (ADS). Ini adalah `AdDecisionServerInteractions` log.

**Topics**
+ [Peristiwa AdDecisionServerInteractions](#log-types-adsinteraction)
+ [Deskripsi log ADS](#ads-log-description)
+ [Skema JSON log ADS](#ads-log-json-schema)

## Peristiwa AdDecisionServerInteractions
<a name="log-types-adsinteraction"></a>

Peristiwa berikut dipancarkan selama MediaTailor interaksi dengan server keputusan iklan (ADS). 


| Log | Deskripsi | 
| --- | --- | 
| AD\$1MARKER\$1FOUND | MediaTailor menemukan penanda iklan di manifes. | 
| BEACON\$1FIRED | Sebuah suar pelacak dipecat untuk melaporkan peristiwa iklan. Dalam mode pelaporan sisi server (default), MediaTailor menyalakan suar. Dalam mode pelaporan sisi klien, perangkat pemutaran menyalakan suar. | 
| EMPTY\$1VAST\$1RESPONSE | ADS mengembalikan respons VAST kosong yang berisi nol iklan. | 
| EMPTY\$1VMAP\$1RESPONSE | ADS mengembalikan respons VMAP kosong. | 
| ERROR\$1ADS\$1INVALID\$1RESPONSE | ADS mengembalikan kode status non-200. | 
| ERROR\$1ADS\$1IO | MediaTailor mengalami kesalahan saat mencoba berkomunikasi dengan ADS.  | 
| ERROR\$1ADS\$1RESPONSE\$1PARSE | MediaTailor mengalami kesalahan saat mengurai respons ADS.  | 
| ERROR\$1ADS\$1RESPONSE\$1UNKNOWN\$1ROOT\$1ELEMENT | Respons ADS berisi elemen root yang tidak valid. | 
| ERROR\$1ADS\$1TIMEOUT |  MediaTailor Permintaan ke ADS habis waktunya. | 
| ERROR\$1DISALLOWED\$1HOST | Host ADS tidak diperbolehkan. | 
| ERROR\$1FIRING\$1BEACON\$1FAILED | MediaTailor gagal menembakkan suar pelacak. | 
| ERROR\$1PERSONALIZATION\$1DISABLED | Penyisipan iklan dinonaktifkan untuk sesi ini. | 
| ERROR\$1UNKNOWN | MediaTailor mengalami kesalahan yang tidak diketahui selama permintaan ADS. | 
| ERROR\$1UNKNOWN\$1HOST | Host ADS tidak diketahui. | 
| ERROR\$1VAST\$1INVALID\$1MEDIA\$1FILE | VAST Ad memiliki elemen yang tidak valid atau hilangMediaFile. | 
| ERROR\$1VAST\$1INVALID\$1VAST\$1AD\$1TAG\$1URI | Respons VAST berisi invalidVASTAdTagURI. | 
| ERROR\$1VAST\$1MISSING\$1CREATIVES | VAST Ad berisi nol atau beberapa Creatives elemen. Tepat satu Creatives elemen diperlukan. | 
| ERROR\$1VAST\$1MISSING\$1IMPRESSION | VAST Ad mengandung nol Impression elemen. Setidaknya satu Impression elemen diperlukan.  | 
| ERROR\$1VAST\$1MISSING\$1MEDIAFILES | VAST Ad berisi nol atau beberapa MediaFiles elemen. Tepat satu MediaFiles elemen diperlukan. | 
| ERROR\$1VAST\$1MISSING\$1OVERLAYS | MediaTailor tidak menerima materi iklan non-linier dari server iklan.  | 
| ERROR\$1VAST\$1MULTIPLE\$1LINEAR | VAST Ad berisi banyak Linear elemen. | 
| ERROR\$1VAST\$1MULTIPLE\$1TRACKING\$1EVENTS | VAST Ad berisi banyak TrackingEvents elemen. | 
| ERROR\$1VAST\$1REDIRECT\$1EMPTY\$1RESPONSE | Permintaan pengalihan VAST mengembalikan respons kosong. | 
| ERROR\$1VAST\$1REDIRECT\$1FAILED | Permintaan pengalihan VAST mengalami kesalahan. | 
| ERROR\$1VAST\$1REDIRECT\$1MULTIPLE\$1VAST | Permintaan pengalihan VAST menampilkan beberapa iklan. | 
| FILLED\$1AVAIL | MediaTailor berhasil mengisi keberhasilannya. | 
| FILLED\$1OVERLAY\$1AVAIL | MediaTailor berhasil mengisi overlay yang berhasil. | 
| INTERSTITIAL\$1VOD\$1FAILURE | Permintaan atau respons ADS mengalami masalah saat mengisi ketersediaan pengantara untuk daftar putar VOD. Tidak ada iklan yang akan dimasukkan. | 
| INTERSTITIAL\$1VOD\$1SUCCESS | MediaTailor berhasil mengisi ketersediaan pengantara untuk daftar putar VOD. | 
| MAKING\$1ADS\$1REQUEST | MediaTailor meminta iklan dari ADS. | 
| MODIFIED\$1TARGET\$1URL | MediaTailor memodifikasi URL target keluar. | 
| NON\$1AD\$1MARKER\$1FOUND | MediaTailor menemukan penanda iklan yang tidak dapat ditindaklanjuti dalam manifes. | 
| RAW\$1ADS\$1RESPONSE | MediaTailor menerima respons ADS mentah. | 
| REDIRECTED\$1VAST\$1RESPONSE | MediaTailor menerima tanggapan VAST setelah mengikuti pengalihan VAST. | 
| VAST\$1REDIRECT | Respons iklan VAST berisi pengalihan. | 
| VAST\$1RESPONSE | MediaTailor menerima tanggapan yang luas. | 
| VOD\$1TIME\$1BASED\$1AVAIL\$1PLAN\$1SUCCESS | MediaTailor berhasil membuat rencana penggunaan berbasis waktu untuk template VOD. | 
| VOD\$1TIME\$1BASED\$1AVAIL\$1PLAN\$1VAST\$1RESPONSE\$1FOR\$1OFFSET | MediaTailor sedang membuat rencana penggunaan berbasis waktu untuk template VOD. MediaTailor menerima respons VAST untuk offset waktu. | 
| VOD\$1TIME\$1BASED\$1AVAIL\$1PLAN\$1WARNING\$1NO\$1ADVERTISEMENTS | Permintaan atau respons ADS mengalami masalah saat membuat rencana penggunaan berbasis waktu untuk template VOD. Tidak ada iklan yang akan dimasukkan. | 
| WARNING\$1NO\$1ADVERTISEMENTS | MediaTailor mengalami masalah saat mengisi avail. Tidak ada iklan yang disisipkan. | 
| WARNING\$1URL\$1VARIABLE\$1SUBSTITUTION\$1FAILED | MediaTailor tidak dapat mengganti variabel dinamis di URL ADS. Periksa konfigurasi URL. | 
| WARNING\$1VPAID\$1AD\$1DROPPED | Iklan VPAID turun karena papan tulis yang hilang, atau sesi menggunakan pelaporan sisi server. | 

## Deskripsi log ADS
<a name="ads-log-description"></a>

Bagian ini menjelaskan struktur dan isi deskripsi log ADS. Untuk menjelajah sendiri di editor JSON, gunakan daftar di[Skema JSON log ADS](#ads-log-json-schema). 

Setiap peristiwa dalam log ADS berisi bidang standar yang dihasilkan oleh CloudWatch Log. Untuk selengkapnya, lihat [Menganalisis data CloudWatch log dengan wawasan Log](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/AnalyzingLogData.html). 

### Properti log ADS
<a name="ads-logs-main"></a>

Bagian ini menjelaskan properti log ADS.


| Properti | Tipe | Diperlukan | Deskripsi | 
| --- | --- | --- | --- | 
| adsRequestUrl | string | false | URL lengkap dari permintaan ADS yang dibuat oleh MediaTailor. | 
| avail | objek tipe [berhasil](#ads-logs-avail) | false | Informasi tentang pemanfaatan yang MediaTailor diisi dengan iklan. Saat ini, untuk jenis FILLED\$1AVAIL acara, ini adalah rencana yang dibuat oleh MediaTailor saat pertama kali menemukan keuntungannya. Bagaimana hasil akhirnya diisi dapat bervariasi dari rencana ini, tergantung pada bagaimana konten diputar.  | 
| awsAccountId | string | true | ID akun AWS untuk MediaTailor konfigurasi yang digunakan untuk sesi tersebut. | 
| customerId | string | true | Versi hash dari ID akun AWS, yang dapat Anda gunakan untuk mengkorelasikan beberapa entri log. | 
| eventDescription | string | true | Deskripsi singkat tentang peristiwa yang memicu pesan log ini, yang disediakan oleh MediaTailor layanan. Secara default, ini kosong. Contoh:Got VAST response. | 
| eventTimestamp | string | true | Tanggal dan waktu acara. | 
| eventType | string | true | Kode untuk acara yang memicu pesan log ini. Contoh:VAST\$1RESPONSE. | 
| originId | string | true | Nama konfigurasi dari MediaTailor konfigurasi. Ini berbeda dari sumber konten video, yang juga merupakan bagian dari konfigurasi. | 
| prefetchScheduleName | string | false | Nama jadwal prefetch yang terkait dengan acara iklan ini. | 
| requestHeaders | array tipe [requestheader](#ads-logs-requestheaders) | false | Header yang MediaTailor disertakan dengan permintaan ADS. Biasanya, log menyertakan ini ketika permintaan ke ADS gagal, untuk membantu pemecahan masalah. | 
| requestId | string | true | ID MediaTailor permintaan, yang dapat Anda gunakan untuk menghubungkan beberapa entri log untuk permintaan yang sama. | 
| sessionId | string | true | Pengidentifikasi numerik unik yang MediaTailor ditugaskan ke sesi pemain. Semua permintaan yang dibuat pemain untuk sesi memiliki ID sesi yang sama. Contoh:e039fd39-09f0-46b2-aca9-9871cc116cde. | 
| sessionType | string (nilai hukum: [DASH, HLS]) | true | Jenis aliran pemain. | 
| vastAd | objek tipe [VastAd](#ads-logs-vastAd) | false | Informasi tentang satu iklan yang diuraikan dari respons VAST. | 
| vastResponse | objek tipe [VastResponse](#ads-logs-vastResponse) | false | Informasi tentang respons VAST yang MediaTailor diterima dari ADS. | 
| vodCreativeOffsets | objek tipe [vodCreativeOffsets](#ads-logs-vodCreativeOffsets) | false | Peta yang menunjukkan offset waktu dalam manifes tempat MediaTailor akan menyisipkan avails, berdasarkan respons VMAP. | 
| vodVastResponseTimeOffset | number | false | Offset waktu khusus VMAP untuk penyisipan iklan VOD. | 

### Konten iklan
<a name="ads-logs-adContent"></a>

Bagian ini menjelaskan properti AdContent log ADS.


**ADS Log Properti AdContent**  

| Properti | Tipe | Diperlukan | Deskripsi | 
| --- | --- | --- | --- | 
| adPlaylistUris | objek tipe [adPlaylistUris](#ads-logs-adPlaylistUris) | false | Pemetaan dari manifes asal untuk varian ke manifes iklan untuk varian tersebut. Untuk DASH, ini berisi satu entri, karena semua varian diwakili dalam manifes DASH tunggal.  | 

### adPlaylistUris
<a name="ads-logs-adPlaylistUris"></a>

Bagian ini menjelaskan properti log ADS adPlaylistUris.


**adPlaylistUris Properti ADS Log**  

| Properti | Tipe | Diperlukan | Deskripsi | 
| --- | --- | --- | --- | 
| <any string> | string | false | URL manifes iklan untuk varian tertentu. | 

### berhasil
<a name="ads-logs-avail"></a>

Bagian ini menjelaskan properti log ADS yang tersedia.


**ADS Log memanfaatkan Properti**  

| Properti | Tipe | Diperlukan | Deskripsi | 
| --- | --- | --- | --- | 
| availId | string | true | Pengidentifikasi unik untuk penggunaan ini. Untuk HLS, ini adalah nomor urut media tempat ketersediaan dimulai. Untuk DASH, ini adalah ID periode. | 
| creativeAds | array tipe [CreativeAD](#ads-logs-creativeAd) | true | Iklan yang MediaTailor dimasukkan ke dalam avail. | 
| fillRate | number | true | Tingkat di mana iklan mengisi durasi avail, dari 0,0 (untuk 0%) hingga 1,0 (untuk 100%). | 
| filledDuration | number | true | Jumlah durasi semua iklan yang dimasukkan ke dalam avail. | 
| numAds | number | true | Jumlah iklan yang MediaTailor dimasukkan ke dalam avail. | 
| originAvailDuration | number | true | Durasi penggunaan sebagaimana ditentukan dalam aliran konten dari asal (CUE\$1OUTatauSCTE). | 
| skippedAds | array tipe [SkippeDad](#ads-logs-skippedAd) | false | Iklan yang MediaTailor tidak menyisipkan, karena alasan seperti TRANSCODE\$1IN\$1PROGRESS danTRANSCODE\$1ERROR. Untuk daftar alasan iklan yang dilewati, lihat[Pemecahan masalah melewatkan iklan](troubleshooting-ad-skipping-overview.md). | 
| slateAd | objek tipe [SlateAD](#ads-logs-slateAd) | true | Informasi tentang iklan batu tulis, yang MediaTailor digunakan untuk mengisi segmen yang tidak terisi dalam avail. | 

### CreativeAD
<a name="ads-logs-creativeAd"></a>

Bagian ini menjelaskan properti log ADS CreativeAD.


**ADS Log Properti CreativeAD**  

| Properti | Tipe | Diperlukan | Deskripsi | 
| --- | --- | --- | --- | 
| adContent | objek tipe [Konten iklan](#ads-logs-adContent) | true | Informasi tentang konten iklan yang disisipkan. | 
| creativeUniqueId | string | true | Pengenal unik untuk iklan, digunakan sebagai kunci untuk transcoding. Ini adalah bidang ID untuk materi iklan dalam respons VAST, jika tersedia. Jika tidak, itu adalah URL mezzanine iklan.  | 
| trackingEvents | objek tipe [Melacak Acara](#ads-logs-trackingEvents) | true | Suar pelacakan URLs untuk berbagai acara pelacakan untuk iklan. Kuncinya adalah nama acara, dan nilainya adalah daftar suar URLs. | 
| transcodedAdDuration | number | true | Durasi iklan, dihitung dari aset yang ditranskode. | 
| uri | string | true | URL versi mezzanine iklan, yang merupakan input ke transcoder. | 
| vastDuration | number | true | Durasi iklan, sebagaimana diuraikan dari respons VAST. | 

### requestheader
<a name="ads-logs-requestheaders"></a>

Bagian ini menjelaskan properti dari log ADS requestheaders.


**ADS Log Requestheaders Properti**  

| Properti | Tipe | Diperlukan | Deskripsi | 
| --- | --- | --- | --- | 
| name | string | true | Nama header. | 
| value | string | true | Nilai header. | 

### SkippeDad
<a name="ads-logs-skippedAd"></a>

Bagian ini menjelaskan properti log ADS SkippeDad.


**ADS Log Properti SkippeDad**  

| Properti | Tipe | Diperlukan | Deskripsi | 
| --- | --- | --- | --- | 
| adMezzanineUrl | string | true | URL mezzanine dari iklan yang dilewati. | 
| creativeUniqueId | string | true | Pengenal unik untuk iklan, digunakan sebagai kunci untuk transcoding. Ini adalah bidang ID untuk materi iklan dalam respons VAST, jika tersedia. Jika tidak, itu adalah URL mezzanine iklan.  | 
| skippedReason | string | true | Kode yang menunjukkan mengapa iklan tidak dimasukkan. Contoh:TRANSCODE\$1IN\$1PROGRESS. Untuk daftar alasan iklan yang dilewati, lihat[Pemecahan masalah melewatkan iklan](troubleshooting-ad-skipping-overview.md). | 
| transcodedAdDuration | number | false | Durasi iklan, dihitung dari aset yang ditranskode. | 
| vastDuration | number | true | Durasi iklan, sebagaimana diuraikan dari respons VAST. | 

### SlateAD
<a name="ads-logs-slateAd"></a>

Bagian ini menjelaskan properti log ADS SlateAd.


**ADS Log Properti SlateAd**  

| Properti | Tipe | Diperlukan | Deskripsi | 
| --- | --- | --- | --- | 
| adContent | objek tipe [Konten iklan](#ads-logs-adContent) | true | Informasi tentang konten iklan yang disisipkan. | 
| creativeUniqueId | string | true | Pengenal unik untuk iklan, digunakan sebagai kunci untuk transcoding. Ini adalah bidang ID untuk materi iklan dalam respons VAST, jika tersedia. Jika tidak, itu adalah URL mezzanine iklan.  | 
| transcodedAdDuration | number | true | Durasi iklan, dihitung dari aset yang ditranskode. | 
| uri | string | true | URL versi mezzanine iklan, yang merupakan input ke transcoder. | 

### Melacak Acara
<a name="ads-logs-trackingEvents"></a>

Bagian ini menjelaskan properti log ADS TrackingEvents.


**Properti Pelacakan Log IKLAN**  

| Properti | Tipe | Diperlukan | Deskripsi | 
| --- | --- | --- | --- | 
| <any string> | array tipe string | false | Daftar suar URLs untuk acara pelacakan yang ditentukan (tayangan, lengkap, dan sebagainya) | 

### VastAd
<a name="ads-logs-vastAd"></a>

Bagian ini menjelaskan properti log ADS VastAd.


**ADS Log Properti VastAd**  

| Properti | Tipe | Diperlukan | Deskripsi | 
| --- | --- | --- | --- | 
| adSystem | string | true | Nilai AdSystem tag dalam respons VAST. | 
| adTitle | string | true | File media yang tersedia untuk iklan dalam respons VAST. | 
| creativeAdId | string | true | Nilai atribut aDid dari Creative tag dalam respons VAST. | 
| creativeId | string | true | Nilai atribut id Creative tag dalam respon VAST. | 
| duration | number | true | Perkiraan durasi iklan, berdasarkan duration tag di linear elemen respons VAST. | 
| trackingEvents | objek tipe [Melacak Acara](#ads-logs-trackingEvents) | true | Suar pelacakan URLs untuk berbagai acara pelacakan untuk iklan. Kuncinya adalah nama acara, dan nilainya adalah daftar suar URLs. | 
| vastAdId | string | true | Nilai atribut id Ad tag dalam respon VAST | 
| vastAdTagUri | string | false | URI pengalihan khusus VMAP untuk iklan. | 
| vastMediaFiles | array tipe [vastMediaFile](#ads-logs-vastMediaFile) | true | Daftar file media yang tersedia untuk iklan dalam respons VAST. | 

### vastMediaFile
<a name="ads-logs-vastMediaFile"></a>

Bagian ini menjelaskan properti log ADS vastMediaFile.


**vastMediaFile Properti ADS Log**  

| Properti | Tipe | Diperlukan | Deskripsi | 
| --- | --- | --- | --- | 
| apiFramework | string | true | Framework API diperlukan untuk mengelola file media. Contoh:VPAID. | 
| bitrate | number | true | Bitrate dari file media. | 
| delivery | string | true | Protokol yang digunakan untuk file media, diatur ke progresif atau streaming. | 
| height | number | true | Tinggi piksel file media. | 
| id | string | true | Nilai atribut id dari MediaFile tag. | 
| type | string | true | Jenis MIME dari file media, diambil dari atribut tipe MediaFile tag. | 
| uri | string | true | URL versi mezzanine iklan, yang merupakan input ke transcoder. | 
| width | number | true | Lebar piksel file media. | 

### VastResponse
<a name="ads-logs-vastResponse"></a>

Bagian ini menjelaskan properti log ADS VastResponse.


**ADS Log Properti VastResponse**  

| Properti | Tipe | Diperlukan | Deskripsi | 
| --- | --- | --- | --- | 
| errors | array tipe string | true | Kesalahan URLs diuraikan dari Error tag dalam respons VAST. | 
| vastAds | array tipe [VastAd](#ads-logs-vastAd) | true | Iklan diuraikan dari respons VAST. | 
| version | string | true | Versi spesifikasi VAST, diuraikan dari version atribut VAST tag dalam respons. | 

### vodCreativeOffsets
<a name="ads-logs-vodCreativeOffsets"></a>

Bagian ini menjelaskan properti log ADS vodCreativeOffsets.


**vodCreativeOffsets Properti ADS Log**  

| Properti | Tipe | Diperlukan | Deskripsi | 
| --- | --- | --- | --- | 
| <any string> | array tipe [vodCreativeOffset](#ads-logs-vodCreativeOffset) | false | Pemetaan dari offset waktu dalam manifes ke daftar iklan yang akan disisipkan saat ini. | 

### vodCreativeOffset
<a name="ads-logs-vodCreativeOffset"></a>

Bagian ini menjelaskan properti log ADS vodCreativeOffset.


**vodCreativeOffset Properti ADS Log**  

| Properti | Tipe | Diperlukan | Deskripsi | 
| --- | --- | --- | --- | 
| adContent | objek tipe [Konten iklan](#ads-logs-adContent) | true | Informasi tentang konten iklan yang disisipkan. | 
| creativeUniqueId | string | true | Pengenal unik untuk iklan, digunakan sebagai kunci untuk transcoding. Ini adalah bidang ID untuk materi iklan dalam respons VAST, jika tersedia. Jika tidak, itu adalah URL mezzanine iklan.  | 
| trackingEvents | objek tipe [Melacak Acara](#ads-logs-trackingEvents) | true | Suar pelacakan URLs untuk berbagai acara pelacakan untuk iklan. Kuncinya adalah nama acara, dan nilainya adalah daftar suar URLs. | 
| transcodedAdDuration | number | true | Durasi iklan, dihitung dari aset yang ditranskode. | 
| uri | string | true | URL versi mezzanine iklan, yang merupakan input ke transcoder. | 
| vastDuration | number | true | Durasi iklan, sebagaimana diuraikan dari respons VAST. | 

## Skema JSON log ADS
<a name="ads-log-json-schema"></a>

Berikut ini mencantumkan skema JSON untuk log AWS Elemental MediaTailor ADS.

```
{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "$id": "http://amazon.com/elemental/midas/mms/adsLogSchema.json",
  "type": "object",
  "title": "AWS Elemental MediaTailor ADS Log JSON Schema",
  "required": [
    "eventType",
    "eventTimestamp",
    "requestId",
    "sessionType",
    "eventDescription",
    "awsAccountId",
    "customerId",
    "originId",
    "sessionId"
  ],
  "additionalProperties": false,
  "properties": {
    "eventType": {
      "$id": "#/properties/eventType",
      "type": "string",
      "description": "The code for the event that triggered this log message. Example: <code>VAST_RESPONSE</code>.",
      "examples": [
        "FILLED_AVAIL"
      ]
    },
    "eventTimestamp": {
      "$id": "#/properties/eventTimestamp",
      "type": "string",
      "description": "The date and time of the event.",
      "examples": [
        "1970-01-01T00:00:00Z"
      ],
      "format": "date-time"
    },
    "requestId": {
      "$id": "#/properties/requestId",
      "type": "string",
      "description": "The MediaTailor request ID, which you can use to correlate multiple log entries for the same request.",
      "examples": [
        "c7c7ae8c-a61e-44e0-8efd-7723995337a1"
      ],
      "pattern": "^(.*)$"
    },
    "sessionType": {
      "$id": "#/properties/sessionType",
      "type": "string",
      "enum": [
        "HLS",
        "DASH"
      ],
      "description": "The player's stream type."
    },
    "eventDescription": {
      "$id": "#/properties/eventDescription",
      "type": "string",
      "description": "A short description of the event that triggered this log message, provided by the MediaTailor service. By default, this is empty. Example: <code>Got VAST response</code>.",
      "default": "",
      "examples": [
        "Got VAST response"
      ],
      "pattern": "^(.*)$"
    },
    "awsAccountId": {
      "$id": "#/properties/awsAccountId",
      "type": "string",
      "description": "The AWS account ID for the MediaTailor configuration that was used for the session."
    },
    "customerId": {
      "$id": "#/properties/customerId",
      "type": "string",
      "description": "The hashed version of the AWS account ID, which you can use to correlate multiple log entries.",
      "pattern": "^(.*)$"
    },
    "originId": {
      "$id": "#/properties/originId",
      "type": "string",
      "description": "The configuration name from the MediaTailor configuration. This is different from the video content source, which is also part of the configuration.",
      "examples": [
        "external-canary-dash-serverside-reporting-onebox"
      ],
      "pattern": "^(.*)$"
    },
    "sessionId": {
      "$id": "#/properties/sessionId",
      "type": "string",
      "description": "The unique numeric identifier that MediaTailor assigned to the player session. All requests that a player makes for a session have the same session ID. Example: <code>e039fd39-09f0-46b2-aca9-9871cc116cde</code>.",
      "examples": [
        "120b9873-c007-40c8-b3db-0f1bd194970b"
      ],
      "pattern": "^(.*)$"
    },
    "avail": {
      "$id": "#/properties/avail",
      "type": "object",
      "title": "avail",
      "description": "Information about an avail that MediaTailor fills with ads. Currently, for the <code>FILLED_AVAIL</code> event type, this is the plan created by MediaTailor when it first encounters the avail. How the avail is eventually filled may vary from this plan, depending on how the content plays out.  ",
      "required": [
        "creativeAds",
        "originAvailDuration",
        "filledDuration",
        "fillRate",
        "driftMillisecondsAtAvailStart",
        "numAds",
        "slateAd",
        "availId"
      ],
      "additionalProperties":  false,
      "properties": {
        "originAvailDuration": {
          "$id": "#/properties/avail/originAvailDuration",
          "type": "number",
          "description": "The duration of the avail as specified in the content stream from the origin (<code>CUE_OUT</code> or <code>SCTE</code>)."
        },
        "filledDuration": {
          "$id": "#/properties/avail/filledDuration",
          "type": "number",
          "description": "The sum of the durations of all the ads inserted into the avail."
        },
        "fillRate": {
          "$id": "#/properties/avail/fillRate",
          "type": "number",
          "description": "The rate at which the ads fill the avail duration, from 0.0 (for 0%) to 1.0 (for 100%)."
        },
        "driftMillisecondsAtAvailStart": {
          "$id": "#/properties/avail/driftMillisecondsAtAvailStart",
          "type": "number",
          "description": "The cumulative drift at the beginning of this avail. A positive value implies that we are moving away from the live edge, a negative value implies that we are moving towards the live edge."
        },
        "creativeAds": {
          "$id": "#/properties/avail/creativeAds",
          "type": "array",
          "description": "The ads that MediaTailor inserted into the avail.",
          "items": {
            "type": "object",
            "title": "creativeAd",
            "description": "Information about a single inserted ad.",
            "required": [
              "uri",
              "creativeUniqueId",
              "adSystem",
              "adContent",
              "trackingEvents",
              "vastDuration",
              "transcodedAdDuration"
            ],
            "additionalProperties": false,
            "properties": {
              "uri": { "$ref": "#/definitions/adMezzanineUri" },
              "creativeUniqueId": { "$ref": "#/definitions/creativeUniqueId" },
              "adSystem": { "$ref": "#/definitions/adSystem" },
              "adContent": { "$ref": "#/definitions/adContent" },
              "trackingEvents": { "$ref": "#/definitions/trackingEvents" },
              "vastDuration": { "$ref": "#/definitions/vastDuration" },
              "transcodedAdDuration": { "$ref": "#/definitions/transcodedAdDuration" }
            }
          }
        },
        "numAds": {
          "$id": "#/properties/avail/numAds",
          "type": "number",
          "description": "The number of ads that MediaTailor inserted into the avail."
        },
        "slateAd": {
          "$id": "#/properties/avail/slateAd",
          "type": ["object", "null"],
          "title": "slateAd",
          "description": "Information about the slate ad, which MediaTailor uses to fill any unfilled segments in the avail.",
          "additionalProperties": false,
          "required": [
            "uri",
            "creativeUniqueId",
            "adContent",
            "transcodedAdDuration"
          ],
          "properties": {
            "uri": { "$ref": "#/definitions/adMezzanineUri" },
            "creativeUniqueId": { "$ref": "#/definitions/creativeUniqueId" },
            "adContent": { "$ref": "#/definitions/adContent" },
            "transcodedAdDuration": { "$ref": "#/definitions/transcodedAdDuration" }
          }
        },
        "availId": {
          "$id": "#/properties/avail/availId",
          "type": "string",
          "description": "The unique identifier for this avail. For HLS, this is the media sequence number where the avail begins. For DASH, this is the period ID."
        },
        "skippedAds": {
          "$id": "#/properties/avail/skippedAds",
          "type": "array",
          "description": "The ads that MediaTailor didn't insert, for reasons like <code>TRANSCODE_IN_PROGRESS</code> and <code>TRANSCODE_ERROR</code>.",
          "items": {
            "type": "object",
            "title": "skippedAd",
            "description": "Information about a single skipped ad.",
            "required": [
              "creativeUniqueId",
              "adMezzanineUrl",
              "skippedReason",
              "vastDuration"
            ],
            "additionalProperties": false,
            "properties": {
              "creativeUniqueId": { "$ref": "#/definitions/creativeUniqueId" },
              "adMezzanineUrl": {
                "type": "string",
                "description": "The mezzanine URL of the skipped ad."
              },
              "skippedReason": {
                "type": "string",
                "description": "The code that indicates why the ad wasn't inserted. Example: <code>TRANSCODE_IN_PROGRESS</code>."
              },
              "vastDuration": { "$ref": "#/definitions/vastDuration" },
              "transcodedAdDuration": { "$ref": "#/definitions/transcodedAdDuration" },
              "targetVariant": {
                "type": "object",
                "title": "targetVariant",
                "description": "The target variant of the source content. This key is present when an ad wasn't inserted due to the source content containing a variant that could not match to any variants present in this ad.",
                "required": [
                  "mediaProtocol",
                  "mediaType",
                  "bitrate",
                  "mediaResolution",
                  "codecs"
                ],
                "additionalProperties": false,
                "properties": {
                  "mediaProtocol": {
                    "type": "string",
                    "description": "The media protocol of this variant, such as HLS.",
                    "enum": [
                      "HLS",
                      "DASH"
                    ]
                  },
                  "mediaType": {
                    "type": "array",
                    "description": "The media type of this variant, such as VIDEO.",
                    "items": {
                      "type": "string",
                      "enum": [
                        "VIDEO",
                        "AUDIO",
                        "SUBTITLES",
                        "TRICK_PLAY"
                      ],
                      "description": "Media type, such as VIDEO."
                    }
                  },
                  "bitrate": {
                    "$ref": "#/definitions/bitrate"
                  },
                  "mediaResolution": {
                    "type": "object",
                    "title": "mediaResolution",
                    "description": "The media resolution of this variant.",
                    "required": [
                      "width",
                      "height"
                    ],
                    "additionalProperties": false,
                    "properties": {
                      "width": {
                        "$ref": "#/definitions/width"
                      },
                      "height": {
                        "$ref": "#/definitions/height"
                      }
                    }
                  },
                  "codecs": {
                    "type": "array",
                    "description": "The codecs of this variant.",
                    "items": {
                      "type": "string",
                      "description": "Codec, such as avc1."
                    }
                  }
                }
              }
            }
          }
        },
        "adBreakTrackingEvents": {
          "$id": "#properties/avail/adBreakTrackingEvents",
          "type": "object",
          "title": "adBreakTrackingEvents",
          "description": "VMAP/ad break tracking events and corresponding URL",
          "properties": {
            "items": {
              "$ref": "#/definitions/adBreakTrackingEvents"
            }
          }
        }
      }
    },

    "vastResponse": {
      "$id": "#/properties/vastResponse",
      "type": "object",
      "title": "vastResponse",
      "description": "Information about the VAST response that MediaTailor received from the ADS.",
      "required": [
        "version",
        "vastAds",
        "errors",
        "nonLinearAdsList"
      ],
      "additionalProperties":  false,
      "properties": {
        "version": {
          "$id": "#/properties/vastResponse/version",
          "type": "string",
          "description": "The VAST specification version, parsed from the <code>version</code> attribute of the <code>VAST</code> tag in the response.",
          "examples": [
            "3.0"
          ],
          "pattern": "^(.*)$"
        },
        "vastAds": {
          "$id": "#/properties/vastResponse/vastAds",
          "type": "array",
          "description": "The ads parsed from the VAST response.",
          "items": {
            "$ref": "#/definitions/vastAd"
          }
        },
        "errors": {
          "$id": "#/properties/vastResponse/errors",
          "type": "array",
          "description": "The error URLs parsed from the <code>Error</code> tags in the VAST response.",
          "items": {
            "type": "string",
            "description": "A single error URL."
          }
        },
        "nonLinearAdsList": {
          "$id": "#/properties/vastResponse/nonLinearAds",
          "type": "array",
          "description": "A list of NonLinearAds as they are read from the VAST response.",
          "items": {
            "$ref": "#/definitions/nonLinearAds"
          }
        }
      }
    },

    "vastAd": {
      "$ref": "#/definitions/vastAd"
    },

    "vodVastResponseTimeOffset": {
      "$id": "#/properties/vodVastResponseTimeOffset",
      "type": "number",
      "description": "The VMAP specific time offset for VOD ad insertion.",
      "examples": [
        5.0
      ]
    },

    "vodCreativeOffsets": {
      "$id": "#/properties/vodCreativeOffsets",
      "type": "object",
      "title": "vodCreativeOffsets",
      "description": "A map that indicates the time offsets in the manifest where MediaTailor will insert avails, based on the VMAP response.",
      "additionalProperties": {
        "type": "array",
        "$id": "#/properties/vodCreativeOffsets/entry",
        "description": "A mapping from a time offset in the manifest to a list of ads to insert at this time.",
        "items": {
          "type": "object",
          "$id": "#/properties/vodCreativeOffsets/entry/items",
          "title": "vodCreativeOffset",
          "description": "The list of ads to insert at the specified time offset.",
          "additionalProperties": false,
          "required": [
            "uri",
            "creativeUniqueId",
            "vastDuration",
            "transcodedAdDuration",
            "adContent",
            "trackingEvents"
          ],
          "properties": {
            "uri": { "$ref": "#/definitions/adMezzanineUri" },
            "creativeUniqueId": { "$ref": "#/definitions/creativeUniqueId" },
            "vastDuration": { "$ref": "#/definitions/vastDuration" },
            "transcodedAdDuration": { "$ref": "#/definitions/transcodedAdDuration" },
            "adContent": { "$ref": "#/definitions/adContent" },
            "trackingEvents": { "$ref": "#/definitions/trackingEvents" }
          }
        }
      }
    },

    "adsRequestUrl": {
      "$id": "#/properties/adsRequestUrl",
      "type": "string",
      "description": "The full URL of the ADS request made by MediaTailor."
    },
    "adMarkers": {
      "$id": "#/properties/adMarkers",
      "type": "string",
      "description": "Found Ad Marker in the Manifest."
    },
    "segmentationUpid": {
      "$id": "#/properties/segmentationUpid",
      "type": "string",
      "description": "Value of segmentation upid parsed from ad markers in manifest."
    },
    "segmentationTypeId": {
      "$id": "#/properties/segmentationTypeId",
      "type": "integer",
      "description": "Value of segmentation typeId parsed from ad markers in manifest."
    },
    "requestHeaders": {
      "$id": "#/properties/requestHeaders",
      "type": "array",
      "description": "The headers that MediaTailor included with the ADS request. Typically, the logs include these when a request to the ADS fails, to help with troubleshooting.",
      "items": {
        "type": "object",
        "title": "requestheaders",
        "description": "The name and value for a single header included in the ADS request.",
        "required": [
          "name",
          "value"
        ],
        "additionalProperties": false,
        "properties": {
          "name": {
            "type": "string",
            "description": "The name of the header."
          },
          "value": {
            "type": "string",
            "description": "The value of the header."
          }
        }
      }
    },

    "originalTargetUrl": {
      "$id": "#/properties/originalTargetUrl",
      "type": "string",
      "description": "The old URL to which MediaTailor was going to make a request."
    },
    "prefetchScheduleName": {
      "$id": "#/properties/prefetchScheduleName",
      "type": "string",
      "description": "The name of the prefetch schedule associated with this ad event.",
      "examples": [
        "PrefetchScheduleName"
      ],
      "pattern": "^(.*)$"
    },
    "updatedTargetUrl": {
      "$id": "#/properties/updatedTargetUrl",
      "type": "string",
      "description": "The new URL to which MediaTailor is making a request."
    },

    "rawAdsResponse": {
      "$id": "#/properties/rawAdsResponse",
      "type": "string",
      "description": "Paginated ADS response as it's exactly returned to MediaTailor."
    },
    "rawAdsResponseIndex": {
      "$id": "#/properties/rawAdsResponseIndex",
      "type": "integer",
      "description": "Integer value denoting this rawAdsResponse's index into the full ADS response. This value is used to order the paginated messages for this ADS response."
    }
  },

  "__COMMENT_oneOf": "The oneOf section defines subtypes for our events. Subtypes can have different rules, including which fields are required. For more information, see https://json-schema.org/understanding-json-schema/reference/combining.html#oneof ",

  "oneOf": [
    { "$ref": "#/definitions/eventAdMarkersFound" },
    { "$ref": "#/definitions/eventNonAdMarkerFound" },
    { "$ref": "#/definitions/eventMakingAdsRequest" },
    { "$ref": "#/definitions/eventModifiedTargetUrl" },
    { "$ref": "#/definitions/eventRawAdsResponse" },
    { "$ref": "#/definitions/eventVastResponse" },
    { "$ref": "#/definitions/eventFilledAvail" },
    { "$ref": "#/definitions/eventFilledOverlayAvail" },
    { "$ref": "#/definitions/eventErrorFiringBeaconFailed" },
    { "$ref": "#/definitions/eventWarningNoAdvertisements" },
    { "$ref": "#/definitions/eventUnknownHost" },
    { "$ref": "#/definitions/eventErrorAdsTimeout" },
    { "$ref": "#/definitions/eventErrorVastMissingOverlays" },
    { "$ref": "#/definitions/eventPlannedAvail" },
    { "$ref": "#/definitions/eventEmptyVastResponse" },
    { "$ref": "#/definitions/eventEmptyVmapResponse" },
    { "$ref": "#/definitions/eventErrorUnknown" },
    { "$ref": "#/definitions/eventVastRedirect" },
    { "$ref": "#/definitions/eventRedirectedVastResponse" },
    { "$ref": "#/definitions/eventErrorAdsMissingImpression" },
    { "$ref": "#/definitions/eventErrorAdsResponseParse" },
    { "$ref": "#/definitions/eventErrorAdsInvalidResponse" },
    { "$ref": "#/definitions/eventErrorDisallowedHost"},
    { "$ref": "#/definitions/eventPersonalizationDisabled"},
    { "$ref": "#/definitions/eventWarningDynamicVariableSubFailed"},
    { "$ref": "#/definitions/eventVodTimeBasedAvailPlanVastResponseForOffset" },
    { "$ref": "#/definitions/eventVodTimeBasedAvailPlanSuccess" }
  ],

  "definitions": {
    "eventAdMarkersFound": {
      "$id": "#/definitions/eventAdMarkersFound",
      "required": [
        "eventType",
        "adMarkers"
      ],
      "properties": {
        "eventType": {
          "type": "string",
          "const": "AD_MARKER_FOUND"
        }
      }
    },
    "eventNonAdMarkerFound": {
      "$id": "#/definitions/eventNonAdMarkerFound",
      "required": [
        "eventType",
        "adMarkers"
      ],
      "properties": {
        "eventType": {
          "type": "string",
          "const": "NON_AD_MARKER_FOUND"
        }
      }
    },
    "eventMakingAdsRequest": {
      "$id": "#/definitions/eventMakingAdsRequest",
      "required": [
        "eventType",
        "adsRequestUrl"
      ],
      "properties": {
        "eventType": {
          "type": "string",
          "const": "MAKING_ADS_REQUEST"
        }
      }
    },

    "eventModifiedTargetUrl": {
      "$id": "#/definitions/eventModifiedTargetUrl",
      "required": [
        "eventType",
        "originalTargetUrl",
        "updatedTargetUrl"
      ],
      "properties": {
        "eventType": {
          "type": "string",
          "const": "MODIFIED_TARGET_URL"
        }
      }
    },

    "eventRawAdsResponse": {
      "$id": "#/definitions/eventRawAdsResponse",
      "required": [
        "eventType",
        "rawAdsResponse",
        "rawAdsResponseIndex"
      ],
      "properties": {
        "eventType": {
          "type": "string",
          "const": "RAW_ADS_RESPONSE"
        }
      }
    },

    "eventVastResponse": {
      "$id": "#/definitions/eventVastResponse",
      "_comment": "NOTE: the vastResponse property should ideally be marked as a required field for this event, but unfortunately, in the case of an empty vast response, we currently emit an EMPTY_VAST_RESPONSE followed by a VAST_RESPONSE, and the vastResponse property is not present in the latter. We need to fix this so that we don't emit both of those events in the empty response case, and update this schema to flag vastResponse as required for VAST_RESPONSE.",
      "required": [
        "eventType"
      ],
      "properties": {
        "eventType": {
          "type": "string",
          "const": "VAST_RESPONSE"
        }
      }
    },

    "eventFilledAvail": {
      "$id": "#/definitions/eventFilledAvail",
      "required": [
        "eventType",
        "avail"
      ],
      "properties": {
        "eventType": {
          "type": "string",
          "const": "FILLED_AVAIL"
        }
      }
    },

    "eventFilledOverlayAvail": {
      "$id": "#/definitions/eventFilledOverlayAvail",
      "required": [
        "eventType",
        "avail"
      ],
      "properties": {
        "eventType": {
          "type": "string",
          "const": "FILLED_OVERLAY_AVAIL"
        }
      }
    },

    "eventErrorVastMissingOverlays": {
      "$id": "#/definitions/eventErrorVastMissingOverlays",
      "required": [
        "eventType",
        "adsRequestUrl",
        "requestHeaders"
      ],
      "properties": {
        "eventType": {
          "type": "string",
          "const": "ERROR_VAST_MISSING_OVERLAYS"
        }
      }
    },

    "eventErrorFiringBeaconFailed": {
      "$id": "#/definitions/eventErrorFiringBeaconFailed",
      "required": [
        "eventType",
        "error",
        "beaconInfo"
      ],
      "properties": {
        "eventType": {
          "type": "string",
          "const": "ERROR_FIRING_BEACON_FAILED"
        }
      }
    },

    "eventWarningNoAdvertisements": {
      "$id": "#/definitions/eventWarningNoAdvertisements",
      "required": [
        "eventType"
      ],
      "_comment": "We should really have a more descriptive error field for these events",
      "properties": {
        "eventType": {
          "type": "string",
          "const": "WARNING_NO_ADVERTISEMENTS"
        }
      }
    },

    "eventUnknownHost": {
      "$id": "#/definitions/eventUnknownHost",
      "required": [
        "eventType",
        "requestHeaders"
      ],
      "properties": {
        "eventType": {
          "type": "string",
          "const": "ERROR_UNKNOWN_HOST"
        }
      }
    },

    "eventErrorAdsTimeout": {
      "$id": "#/definitions/eventErrorAdsTimeout",
      "required": [
        "eventType",
        "adsRequestUrl",
        "requestHeaders"
      ],
      "properties": {
        "eventType": {
          "type": "string",
          "const": "ERROR_ADS_TIMEOUT"
        }
      }
    },

    "eventPlannedAvail": {
      "$id": "#/definitions/eventPlannedAvail",
      "required": [
        "eventType"
      ],
      "_comment": "TODO: Flesh this out as we implement it",
      "properties": {
        "eventType": {
          "type": "string",
          "const": "PLANNED_AVAIL"
        }
      }
    },

    "eventEmptyVastResponse": {
      "$id": "#/definitions/eventEmptyVastResponse",
      "required": [
        "eventType"
      ],
      "properties": {
        "eventType": {
          "type": "string",
          "const": "EMPTY_VAST_RESPONSE"
        }
      }
    },

    "eventEmptyVmapResponse": {
      "$id": "#/definitions/eventEmptyVmapResponse",
      "required": [
        "eventType"
      ],
      "properties": {
        "eventType": {
          "type": "string",
          "const": "EMPTY_VMAP_RESPONSE"
        }
      }
    },

    "eventErrorUnknown": {
      "$id": "#/definitions/eventErrorUnknown",
      "required": [
        "eventType"
      ],
      "_comment": "TODO: we should have a field for the exception message or something",
      "properties": {
        "eventType": {
          "type": "string",
          "const": "ERROR_UNKNOWN"
        }
      }
    },

    "eventVastRedirect": {
      "$id": "#/definitions/eventVastRedirect",
      "required": [
        "eventType"
      ],
      "properties": {
        "eventType": {
          "type": "string",
          "const": "VAST_REDIRECT"
        }
      }
    },

    "eventRedirectedVastResponse": {
      "$id": "#/definitions/eventRedirectedVastResponse",
      "required": [
        "eventType"
      ],
      "properties": {
        "eventType": {
          "type": "string",
          "const": "REDIRECTED_VAST_RESPONSE"
        }
      },
      "_comment": "NOTE that the property vastResponse is not required because empty vast responses do not contain a vastResponse."
    },

    "eventErrorAdsResponseParse": {
      "$id": "#/definitions/eventErrorAdsResponseParse",
      "required": [
        "eventType"
      ],
      "_comment": "We should have a field with an error message here",
      "properties": {
        "eventType": {
          "type": "string",
          "const": "ERROR_ADS_RESPONSE_PARSE"
        }
      }
    },

    "eventErrorAdsInvalidResponse": {
      "$id": "#/definitions/eventErrorAdsInvalidResponse",
      "required": [
        "eventType",
        "additionalInfo"
      ],
      "properties": {
        "eventType": {
          "type": "string",
          "const": "ERROR_ADS_INVALID_RESPONSE"
        }
      }
    },

    "eventErrorAdsMissingImpression": {
      "$id": "#/definitions/eventErrorAdsMissingImpression",
      "required": [
        "eventType"
      ],
      "properties": {
        "eventType": {
          "type": "string",
          "const": "ERROR_VAST_MISSING_IMPRESSION"
        }
      }
    },

    "eventErrorDisallowedHost": {
      "$id": "#/definitions/eventErrorDisallowedHost",
      "required": [
        "eventType"
      ],
      "properties": {
        "eventType": {
          "type": "string",
          "const": "ERROR_DISALLOWED_HOST"
        }
      }
    },

    "eventPersonalizationDisabled": {
      "$id": "#/definitions/eventPersonalizationDisabled",
      "required": [
        "eventType"
      ],
      "properties": {
        "eventType": {
          "type": "string",
          "const": "ERROR_PERSONALIZATION_DISABLED"
        }
      }
    },

    "eventWarningDynamicVariableSubFailed": {
      "$id": "#/definitions/eventWarningDynamicVariableSubFailed",
      "required": [
        "eventType",
        "adsRequestUrl"
      ],
      "properties": {
        "eventType": {
          "type": "string",
          "const": "WARNING_URL_VARIABLE_SUBSTITUTION_FAILED"
        }
      }
    },

    "eventVodTimeBasedAvailPlanVastResponseForOffset": {
      "$id": "#/definitions/eventVodTimeBasedAvailPlanVastResponseForOffset",
      "required": [
        "eventType",
        "vastResponse"
      ],
      "properties": {
        "eventType": {
          "type": "string",
          "const": "VOD_TIME_BASED_AVAIL_PLAN_VAST_RESPONSE_FOR_OFFSET"
        }
      }
    },

    "eventVodTimeBasedAvailPlanSuccess": {
      "$id": "#/definitions/eventVodTimeBasedAvailPlanSuccess",
      "required": [
        "eventType",
        "vodCreativeOffsets"
      ],
      "properties": {
        "eventType": {
          "type": "string",
          "const": "VOD_TIME_BASED_AVAIL_PLAN_SUCCESS"
        }
      }
    },

    "creativeUniqueId": {
      "type": "string",
      "description": "The unique identifier for the ad, used as a key for transcoding. This is the ID field for the creative in the VAST response, if available. Otherwise, it's the mezzanine URL of the ad. "
    },

    "adSystem": {
      "type": "string",
      "description": "The value of the <code>AdSystem</code> tag in the VAST response. "
    },

    "vastDuration": {
      "type": "number",
      "description": "The duration of the ad, as parsed from the VAST response."
    },

    "transcodedAdDuration": {
      "type": "number",
      "description": "The duration of the ad, calculated from the transcoded asset."
    },

    "adContent": {
      "$id": "#/properties/adContent",
      "type": ["object", "null"],
      "title": "adContent",
      "description": "Information about the content of the inserted ad.",
      "additionalProperties": false,
      "properties": {
        "adPlaylistUris": {
          "$id": "#/properties/adContent/adPlaylistUris",
          "type": "object",
          "title": "adPlaylistUris",
          "description": "The mapping from the origin manifest for a variant to the ad manifest for the variant. For DASH, this contains a single entry, because all variants are represented in a single DASH manifest. ",
          "additionalProperties": {
            "$id": "#/properties/adContent/adPlaylistUris/adPlaylistUri",
            "type": "string",
            "description": "The URL of the ad manifest for the specific variant."
          }
        }
      }
    },

    "adMezzanineUri": {
      "type": "string",
      "description": "The URL of the mezzanine version of the ad, which is the input to the transcoder."
    },

    "bitrate": {
      "type": "integer",
      "examples": [
        533
      ],
      "description": "The bitrate."
    },
    "width": {
      "type": "integer",
      "examples": [
        1280
      ],
      "description": "Width in pixels."
    },
    "height": {
      "type": "integer",
      "examples": [
        720
      ],
      "description": "Height in pixels."
    },

    "trackingEvents": {
      "type": "object",
      "title": "trackingEvents",
      "description": "The tracking beacon URLs for the various tracking events for the ad. The keys are the event names, and the values are a list of beacon URLs.",

      "additionalProperties":  {
        "type": "array",
        "description": "The list of beacon URLs for the specified tracking event (impression, complete, and so on)",
        "items": {
          "type": "string",
          "description": "The beacon URLs for this tracking event."
        }
      }
    },

    "nonLinearAds": {
      "$id": "#/properties/nonLinearAds",
      "type": "object",
      "title": "nonLinearAds",
      "description": "A NonLinearAds as it appears in the VAST response.",
      "required": [
        "nonLinearAdList",
        "nonLinearTrackingEvents"
      ],
      "properties": {
        "nonLinearAdList": {
          "type": "array",
          "description": "List of non linear ads as they exist within one NonLinearAds.",
          "items": {
            "type": "object",
            "title": "nonLinearAdList",
            "description": "List of NonLinearAd as they are parsed from its parent NonLinearAds.",
            "properties": {
              "nonLinearAdId": {
                "type": "string",
                "description": "Ad ID of this non linear ad."
              },
              "nonLinearAdSystem": {
                "type": "string",
                "description": "Ad system of this non linear ad's parent Inline ad."
              },
              "nonLinearAdTitle": {
                "type": "string",
                "description": "Ad title of this non linear ad's parent Inline ad."
              },
              "nonLinearCreativeId": {
                "type": "string",
                "description": "Creative ID of this non linear ad's parent Creative ad."
              },
              "nonLinearCreativeAdId": {
                "type": "string",
                "description": "Creative ad ID of this non linear ad."
              },
              "nonLinearCreativeSequence": {
                "type": "string",
                "description": "Creative sequence of this non linear ad."
              },
              "nonLinearWidth": {
                "type": "string",
                "description": "Width of this non linear ad."
              },
              "nonLinearHeight": {
                "type": "string",
                "description": "Height of this non linear ad."
              },
              "nonLinearExpandedWidth": {
                "type": "string",
                "description": "Expanded width of this non linear ad."
              },
              "nonLinearExpandedHeight": {
                "type": "string",
                "description": "Expanded height of this non linear ad."
              },
              "nonLinearScalable": {
                "type": "boolean",
                "description": "Boolean denoting if this non linear ad is scalable."
              },
              "nonLinearMaintainAspectRatio": {
                "type": "boolean",
                "description": "Boolean denoting if aspect ratio should be maintained for this non linear ad."
              },
              "nonLinearMinSuggestedDuration": {
                "type": "string",
                "description": "Min suggested duration for this non linear ad."
              },
              "nonLinearApiFramework": {
                "type": "string",
                "description": "API framework for this non linear ad's parent Inline ad."
              },
              "nonLinearStaticResource": {
                "type": "string",
                "description": "Static resource for this non linear ad."
              },
              "nonLinearStaticResourceCreativeType": {
                "type": "string",
                "description": "Static Resource creative type for this non linear ad."
              },
              "nonLinearIFrameResource": {
                "type": "string",
                "description": "I-Frame resource for this non linear ad."
              },
              "nonLinearHtmlResource": {
                "type": "string",
                "description": "HTML resource for this non linear ad."
              },
              "nonLinearAdParameters": {
                "type": "string",
                "description": "Ad parameters for this non linear ad."
              },
              "nonLinearClickThrough": {
                "type": "string",
                "description": "Click Through data for this non linear ad."
              },
              "nonLinearClickTracking": {
                "type": "string",
                "description": "Click Tracking data for this non linear ad."
              },
              "nonLinearClickTrackingId": {
                "type": "string",
                "description": "Click Tracking ID for this non linear ad."
              }
            }
          }
        },
        "nonLinearTrackingEvents": { "$ref": "#/definitions/trackingEvents" },
        "extensions": {
          "$id": "#/properties/nonLinearAds/extensions",
          "type": "array",
          "description": "Extensions that exist for this NonLinearAds.",
          "items": {
            "$id": "#/properties/nonLinearAds/extensions/items",
            "type": "object",
            "title": "Extensions",
            "description": "Extensions found in non linear ads",
            "additionalProperties":  false,
            "properties": {
              "extensionType": {
                "$id": "#/properties/nonLinearAds/extensions/extensionType",
                "type": "string",
                "description": "The value of the extension type attribute of the <code>Extensions</code> tag.",
                "examples": [
                  "FreeWheel"
                ]
              },
              "extensionContent": {
                "$id": "#/properties/nonLinearAds/extensions/extensionContent",
                "type": "string",
                "description": "The extension content attribute of the <code>Extensions</code> tag.",
                "examples": [
                  "progressive"
                ]
              }
            }
          }
        }
      }
    },
    "adBreakTrackingEvents": {
      "$id": "#/properites/adBreakTrackingEvents",
      "type": "object",
      "title": "adBreakTrackingEvents",
      "description": "These are all VMAP ad break tracking events.",
      "additionalProperties": {
        "type": "array",
        "description": "VMAP/ad break tracking events and corresponding URL",
        "items": {
          "type": "string",
          "description": "The beacon URLs for this tracking event."
        }
      }
    },
    "vastAd": {
      "$id": "#/properties/vastAd",
      "type": "object",
      "title": "vastAd",
      "description": "Information about a single ad parsed from the VAST response.",
      "required": [
        "vastAdId",
        "adSystem",
        "adTitle",
        "creativeId",
        "creativeAdId",
        "duration",
        "vastMediaFiles",
        "trackingEvents"
      ],
      "additionalProperties":  false,
      "properties": {
        "vastAdId": {
          "$id": "#/properties/vastAd/vastAdId",
          "type": "string",
          "description": "The value of the id attribute of the <code>Ad</code> tag in the VAST response",
          "examples": [
            "ad1"
          ]
        },
        "adSystem": {"$ref": "#/definitions/adSystem" } ,
        "adTitle": {
          "$id": "#/properties/vastAd/adTitle",
          "type": "string",
          "description": "The media files that are available for the ad in the VAST response.",
          "examples": [
            "External NCA1C1L1 LinearInlineSkippable"
          ]
        },
        "creativeId": {
          "$id": "#/properties/vastAd/creativeId",
          "type": "string",
          "description": "The value of the id attribute of the <code>Creative</code> tag in the VAST response.",
          "examples": [
            "creative1"
          ]
        },
        "creativeAdId": {
          "$id": "#/properties/vastAd/creativeAdId",
          "type": "string",
          "description": "The value of the adId attribute of the <code>Creative</code> tag in the VAST response."
        },
        "duration": {
          "$id": "#/properties/vastAd/duration",
          "type": "number",
          "description": "The approximate duration of the ad, based on the <code>duration</code> tag in the <code>linear</code> element of the VAST response.",
          "examples": [
            30,
            30.0
          ]
        },
        "vastMediaFiles": {
          "$id": "#/properties/vastAd/vastMediaFiles",
          "type": "array",
          "description": "The list of available media files for the ad in the VAST response.",
          "items": {
            "$id": "#/properties/vastAd/vastMediaFiles/items",
            "type": "object",
            "title": "vastMediaFile",
            "description": "Information about a media file for the ad.",
            "required": [
              "uri",
              "id",
              "delivery",
              "type",
              "apiFramework",
              "width",
              "height",
              "bitrate"
            ],
            "additionalProperties":  false,
            "properties": {
              "uri": { "$ref": "#/definitions/adMezzanineUri" },
              "id": {
                "$id": "#/properties/vastAd/vastMediaFiles/items/properties/id",
                "type": "string",
                "description": "The value of the id attribute of the <code>MediaFile</code> tag.",
                "examples": [
                  "GDFP"
                ]
              },
              "delivery": {
                "$id": "#/properties/vastAd/vastMediaFiles/items/properties/delivery",
                "type": "string",
                "description": "The protocol used for the media file, set to either progressive or streaming.",
                "examples": [
                  "progressive"
                ]
              },
              "type": {
                "$id": "#/properties/vastAd/vastMediaFiles/items/properties/type",
                "type": "string",
                "description": "The MIME type of the media file, taken from the type attribute of the <code>MediaFile</code> tag.",
                "examples": [
                  "video/mp4"
                ]
              },
              "apiFramework": {
                "$id": "#/properties/vastAd/vastMediaFiles/items/properties/apiFramework",
                "type": "string",
                "description": "The API framework needed to manage the media file. Example: <code>VPAID</code>."
              },
              "width": {
                "$ref": "#/definitions/width"
              },
              "height": {
                "$ref": "#/definitions/height"
              },
              "bitrate": {
                "$ref": "#/definitions/bitrate"
              }
            }
          }
        },
        "trackingEvents": { "$ref": "#/definitions/trackingEvents" },
        "vastAdTagUri": {
          "$id": "#/properties/vastAd/vastAdTagUri",
          "type": "string",
          "description": "The VMAP-specific redirect URI for an ad.",
          "examples": [
            "https://ads.redirect.com/redirect1"
          ]
        }
      }
    }
  }
}
```

# AWS Elemental MediaTailor deskripsi log manifes dan jenis acara
<a name="log-types"></a>

Bagian berikut menjelaskan log yang MediaTailor dipancarkan untuk menggambarkan peristiwa dengan server asal saat meminta dan menerima manifes. Ini adalah `ManifestService` log.

**Topics**
+ [Peristiwa ManifestService](#log-types-origininteraction)
+ [Properti log manifes](#manifest-logs-main)

## Peristiwa ManifestService
<a name="log-types-origininteraction"></a>

Peristiwa berikut dipancarkan selama MediaTailor interaksi dengan asal. 


| Log | Deskripsi | 
| --- | --- | 
| CONFIG\$1SECURITY\$1ERROR |  MediaTailor Konfigurasi memiliki masalah keamanan.  | 
| CONFIG\$1SYNTAX\$1ERROR | Jalur asal dan aset menghasilkan URL yang salah bentuk. | 
| CONNECTION\$1ERROR |  MediaTailor Koneksi ke asal ditolak atau gagal. | 
| GENERATED\$1MANIFEST | MediaTailor menghasilkan manifes. Anda harus mengaktifkan mode debug untuk menerima log ini. Untuk informasi tentang mode log debug, termasuk cara mengaktifkannya, lihat[Menghasilkan log debug](debug-log-mode.md). | 
| HOST\$1DISALLOWED | MediaTailor tidak mengizinkan permintaan HTTP ke host ini. | 
| INCOMPATIBLE\$1HLS\$1VERSION | Manifes menggunakan versi HLS yang tidak kompatibel. MediaTailor membutuhkan versi 3 atau lebih. | 
| INVALID\$1SINGLE\$1PERIOD\$1DASH\$1MANIFEST | Manifes DASH periode tunggal tidak valid. MediaTailor melewati manifes DASH periode tunggal. | 
| IO\$1ERROR | MediaTailor mengalami kesalahan IO selama komunikasi dengan asal. | 
| LAST\$1PERIOD\$1MISSING\$1AUDIO | Periode terakhir dalam manifes DASH kehilangan semua audio AdaptationSets karena ketidaksejajaran audio atau video asal. Untuk menghindari masalah pemutaran, tunda penerbitan periode terakhir hingga setidaknya permintaan berikutnya. | 
| LAST\$1PERIOD\$1MISSING\$1AUDIO\$1WARNING | Periode terakhir dalam manifes DASH kehilangan semua audio AdaptationSets karena ketidaksejajaran audio atau video asal. Memilih untuk menerbitkan (tidak menunda) periode terakhir. Audio yang hilang dapat menyebabkan masalah pemutaran. | 
| MANIFEST\$1ERROR | Permintaan MediaTailor manifes gagal. | 
| NO\$1MASTER\$1OR\$1MEDIA\$1PLAYLIST | Respons asal tidak berisi daftar putar utama atau daftar putar media. | 
| NO\$1MASTER\$1PLAYLIST | Respons asal tidak berisi daftar putar utama yang diharapkan. | 
| NO\$1MEDIA\$1PLAYLIST | Respons asal tidak berisi daftar putar media yang diharapkan. | 
| ORIGIN\$1MANIFEST | MediaTailor mengambil manifes asal. Anda harus mengaktifkan mode debug untuk menerima log ini. Untuk informasi tentang mode log debug, termasuk cara mengaktifkannya, lihat[Menghasilkan log debug](debug-log-mode.md). | 
| PARSING\$1ERROR | Asal tidak dapat mengurai permintaan manifes. | 
| SCTE35\$1PARSING\$1ERROR | MediaTailor tidak dapat mengurai Signal Binary elemen dalam manifes. | 
| SESSION\$1INITIALIZED | Sesi diinisialisasi. Anda harus mengaktifkan mode debug untuk menerima log ini. Untuk informasi tentang mode log debug, termasuk cara mengaktifkannya, lihat[Menghasilkan log debug](debug-log-mode.md). | 
| TIMEOUT\$1ERROR | Permintaan MediaTailor manifes habis waktunya. | 
| TRACKING\$1RESPONSE | MediaTailor melayani respon pelacakan. Anda harus mengaktifkan mode debug untuk menerima log ini. Untuk informasi tentang mode log debug, termasuk cara mengaktifkannya, lihat[Menghasilkan log debug](debug-log-mode.md). | 
| UNKNOWN\$1ERROR | MediaTailor mengalami kesalahan yang tidak diketahui. | 
| UNKNOWN\$1HOST | Tuan rumah tidak diketahui. | 
| UNSUPPORTED\$1SINGLE\$1PERIOD\$1DASH\$1MANIFEST | Manifes DASH periode tunggal tidak didukung. MediaTailor melewati manifes DASH periode tunggal. | 

## Properti log manifes
<a name="manifest-logs-main"></a>

Bagian ini menjelaskan properti log manifes.


| Properti | Tipe | Diperlukan | 
| --- | --- | --- | 
| awsAccountId | string | true | 
| eventTimestamp | string | true | 
| originId | string | true | 
| customerId | string | false | 
| eventType | string | false | 
| sessionId | string | false | 
| originRequestUrl | string | false | 
| mediaTailorPath | string | false | 
| requestId | string | false | 
| responseBody | string | false | 
| sessionType | string (nilai hukum: [DASH, HLS]) | false | 
| requestNextToken | string | false | 
| eventDescription | string | false | 
| assetPath | string | false | 
| originFullUrl | string | false | 
| originPrefixUrl | string | false | 
| additionalInfo | string | false | 
| cause | string | false | 
| response | string | false | 
| httpCode | string | false | 
| errorMessage | string | false | 
| adAdsResponse | string | false | 
| adAdsRawResponse | string | false | 
| adAdsRequest | string | false | 
| adNumNewAvails | string | false | 
| generatedMediaPlaylist | string | false | 
| requestStartTime | string | false | 
| requestEndTime | string | false | 
| requestStartTimeEpochMillis | string | false | 
| requestEndTimeEpochMillis | string | false | 

# AWS Elemental MediaTailor deskripsi log transcode dan jenis acara
<a name="tm-log-format"></a>

Bagian berikut menjelaskan log yang MediaTailor dipancarkan untuk menggambarkan peristiwa dengan layanan transcode saat menyiapkan materi iklan untuk jahitan iklan. Ini adalah `TranscodeService` log.

**Topics**
+ [Peristiwa TranscodeService](#log-types-tminteraction)
+ [Transcode properti log](#transcode-logs-main)

## Peristiwa TranscodeService
<a name="log-types-tminteraction"></a>

Peristiwa berikut dipancarkan selama MediaTailor interaksi saat mentranskode iklan. 


| Log | Deskripsi | 
| --- | --- | 
| IMPORT\$1ERROR | MediaTailor mengalami kesalahan internal selama pekerjaan impor (untuk iklan yang telah dikondisikan sebelumnya). Menggunakan kumpulan iklan kosong. | 
| INITIALIZED | MediaTailor menginisialisasi pekerjaan transkode atau pekerjaan impor (untuk iklan yang telah dikondisikan sebelumnya). | 
| INTERNAL\$1ERROR | MediaTailor mengalami kesalahan internal. Menggunakan kumpulan iklan kosong. | 
| MISSING\$1VARIANTS | MediaTailor tidak dapat mentranskode iklan karena varian yang hilang. Menggunakan kumpulan iklan kosong. | 
| PROFILE\$1NOT\$1FOUND | MediaTailor tidak dapat mentranskode iklan karena profil yang hilang untuk ditranskode. Menggunakan kumpulan iklan kosong. | 
| TRANSCODE\$1COMPLETED | Transcoding video selesai. Iklan dapat digunakan untuk penyisipan iklan. | 
| TRANSCODE\$1ERROR | MediaTailor mengalami kesalahan internal selama pekerjaan transcode. Menggunakan kumpulan iklan kosong. | 
| TRANSCODE\$1IN\$1PROGRESS | Transcoding video sedang berlangsung. Video yang ditranskode belum siap. Menggunakan kumpulan iklan kosong. | 

## Transcode properti log
<a name="transcode-logs-main"></a>

Bagian ini menjelaskan properti log transcode.


| Properti | Tipe | Diperlukan | Deskripsi | 
| --- | --- | --- | --- | 
| awsAccountId | string | true | ID AWS akun untuk MediaTailor konfigurasi yang digunakan untuk sesi. | 
| eventTimestamp | string | true | Tanggal dan waktu acara. | 
| originId | string | true | Nama konfigurasi dari MediaTailor konfigurasi. Ini berbeda dari sumber konten video, yang juga merupakan bagian dari konfigurasi. | 
| eventType | string | false | Kode untuk acara yang memicu pesan log ini. Contoh:TRANSCODE\$1ERROR. | 
| eventDescription | string | false | Deskripsi singkat tentang peristiwa yang memicu pesan log ini, yang disediakan oleh MediaTailor layanan. Secara default, ini kosong.  | 
| sessionId | string | false | Pengidentifikasi numerik unik yang MediaTailor ditugaskan ke sesi pemain. Semua permintaan yang dibuat pemain untuk sesi memiliki ID sesi yang sama. Contoh:e039fd39-09f0-46b2-aca9-9871cc116cde. | 
| creativeUniqueId | string | false | Pengenal unik untuk materi iklan yang sedang ditranskode. | 
| profileName | string | false |  | 
| adUri | string | false | URI untuk iklan kreatif. | 
| transcodeRequestId | string | false | Pengenal unik untuk permintaan transkode ini. | 
| cacheStatus | string | false | Menunjukkan jika MediaTailor di-cache iklan yang ditranskode.  | 

# Menggunakan log vended untuk mengirim AWS Elemental MediaTailor log
<a name="vended-logs"></a>

Anda dapat menggunakan log vended untuk fleksibilitas dan kontrol yang lebih besar atas tempat mengirimkan log yang MediaTailor dipancarkan dari konfigurasi pemutaran Anda. 

Dengan log vended, MediaTailor mengirimkan semua aktivitas log yang terkait dengan konfigurasi ke Amazon CloudWatch Logs. CloudWatch Log kemudian mengirimkan persentase log yang Anda tentukan ke tujuan yang Anda pilih. Tujuan yang didukung adalah grup CloudWatch log Amazon Log, bucket Amazon S3, atau aliran Amazon Data Firehose. 

Karena vended log tersedia dengan harga diskon volume, Anda bisa melihat penghematan biaya dibandingkan dengan mengirim log langsung ke CloudWatch Log. Untuk harga, lihat *Log Terjual* di tab **Log** di [ CloudWatch Harga Amazon](https://aws.amazon.com/cloudwatch/pricing/).

Untuk menggunakan log penjual otomatis, Anda harus melakukan hal berikut:

1. [Tambahkan izin](#vended-logs-perms).

1. [Buat tujuan pengiriman log](#vended-logs-destinations).

1. [Konfigurasikan pengiriman log di CloudWatch Log](#vended-logs-delivery).

1. [Aktifkan log vended di MediaTailor](#vended-logs-config).

Untuk informasi selengkapnya tentang log vended, lihat [Mengaktifkan pencatatan dari AWS layanan](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/AWS-logs-and-resource-policy.html) di panduan pengguna CloudWatch Log. MediaTailor mendukung V2 dari log vended. 

## Langkah 1: Tambahkan izin untuk pengiriman MediaTailor log
<a name="vended-logs-perms"></a>

Orang yang menyiapkan log vended harus memiliki izin untuk membuat tujuan pengiriman, mengonfigurasi pengiriman log, dan mengaktifkan log masuk vended. MediaTailor Gunakan kebijakan berikut untuk memastikan bahwa Anda memiliki izin yang sesuai untuk menyiapkan log vended. 

**Kebijakan untuk CloudWatch Log dan tujuan pengiriman**  
Bagian berikut dalam *Panduan Pengguna CloudWatch Log Amazon* menyediakan kebijakan yang memungkinkan Anda bekerja dengan CloudWatch log di Log dan tujuan pengiriman Anda. Jika Anda mengirim log ke beberapa lokasi, Anda dapat menggabungkan pernyataan kebijakan menjadi satu kebijakan, bukan membuat beberapa kebijakan.   
+ [Log dikirim ke CloudWatch Log](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/AWS-logs-and-resource-policy.html#AWS-logs-infrastructure-V2-CloudWatchLogs)
+ [Log dikirim ke Amazon S3](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/AWS-logs-and-resource-policy.html#AWS-logs-infrastructure-V2-S3)
+ [Log dikirim ke Firehose](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/AWS-logs-and-resource-policy.html#AWS-logs-infrastructure-V2-Firehose)

**Kebijakan untuk penyiapan dari konsol**  
Jika Anda menyiapkan pengiriman log vended melalui konsol alih-alih API atau AWS CLI, Anda harus memiliki izin tambahan berikut dalam kebijakan Anda.

**Kebijakan untuk log vended in MediaTailor**  
Untuk membuat, melihat, atau memodifikasi pengiriman log terjual MediaTailor, Anda harus memiliki izin berikut dalam kebijakan Anda.

Untuk informasi tentang menambahkan izin dan bekerja dengan kebijakan, lihat[Identity and Access Management untuk AWS Elemental MediaTailor](security-iam.md).

## Langkah 2: Buat tujuan pengiriman untuk MediaTailor log
<a name="vended-logs-destinations"></a>

Buat sumber daya tempat log Anda akan dikirim. Rekam ARN sumber daya untuk digunakan dalam mengonfigurasi pengiriman log di langkah selanjutnya.

**CloudWatch Log log tujuan pengiriman grup**  
Gunakan salah satu dari berikut ini untuk membantu membuat grup log.  
+ Untuk konsol, lihat [Membuat grup log di CloudWatch Log](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/Working-with-log-groups-and-streams.html#Create-Log-Group) di *Panduan Pengguna CloudWatch Log Amazon*.
+ Untuk API, lihat [CreateLogGroup](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_CreateLogGroup.html)di *Referensi API Amazon CloudWatch Logs.* 
+ Untuk SDKs dan CLI, lihat [Menggunakan `CreateLogGroup` dengan AWS SDK atau AWS CLI](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/example_cloudwatch-logs_CreateLogGroup_section.html) di Panduan Pengguna * CloudWatch Log Amazon*. 

**Tujuan pengiriman bucket Amazon S3**  
Gunakan salah satu dari berikut ini untuk membantu membuat ember.  
+ Untuk konsol, SDKs, dan CLI, lihat [Membuat bucket](https://docs.aws.amazon.com/AmazonS3/latest/userguide/create-bucket-overview.html) di *Panduan Pengguna Layanan Penyimpanan Sederhana Amazon*.
+ Untuk API, lihat [CreateBucket](https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateBucket.html)di *Referensi API Amazon Simple Storage Service*. 

**Tujuan pengiriman aliran Firehose**  
Untuk bantuan membuat stream, lihat [Membuat aliran Firehose dari konsol](https://docs.aws.amazon.com/firehose/latest/dev/basic-create.html) di Panduan Pengembang *Amazon Data Firehose*.

## Langkah 3: Aktifkan log vended untuk konfigurasi MediaTailor pemutaran
<a name="vended-logs-config"></a>

Buat atau perbarui konfigurasi pemutaran yang akan mengirim log ke tujuan pengiriman yang Anda buat pada langkah sebelumnya. Catat nama konfigurasi untuk digunakan dalam mengonfigurasi pengiriman log di langkah selanjutnya. 
+ Untuk mengaktifkan log vended melalui konsol, menggunakan [Membuat konfigurasi](configurations-create.md) atau [Mengedit pengaturan konfigurasi](configurations-edit.md) Mengedit konfigurasi untuk mengakses pengaturan **Logging**. Untuk **strategi Logging**, pilih **Vded logs**.
+ Untuk mengaktifkan log vended melalui API, Anda harus memiliki konfigurasi yang ada. Gunakan `ConfigureLogsForPlaybackConfiguration` untuk menambahkan strategi logging`Vended logs`.

Jika Anda menggunakan strategi MediaTailor pencatatan lama untuk mengirim log langsung ke Log dan ingin bermigrasi ke CloudWatch log vended, lihat. [Migrasi strategi logging](vended-logs-migrate.md)

**penting**  
 Jika Anda mengubah strategi log dari Legacy CloudWatch ke log vended, MediaTailor akan membuat perubahan ini segera setelah Anda menyimpan pembaruan. Anda akan berhenti menerima log sampai Anda telah sepenuhnya mengonfigurasi vended logging.

## Langkah 4: Konfigurasikan pengiriman log di CloudWatch Log
<a name="vended-logs-delivery"></a>

Di CloudWatch Log, Anda harus membuat tiga elemen untuk mewakili potongan-potongan pengiriman log. Elemen-elemen ini dijelaskan secara rinci [CreateDelivery](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_CreateDelivery.html)dalam *Referensi API Amazon CloudWatch Logs*. Langkah-langkah tingkat tinggi untuk mengonfigurasi pengiriman dengan CloudWatch Logs API adalah sebagai berikut. 

**Untuk mengonfigurasi pengiriman CloudWatch log di Log (API)**

1. Gunakan [https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_PutDeliverySource.html](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_PutDeliverySource.html)untuk menambahkan sumber log.

   A `DeliverySource` mewakili konfigurasi pemutaran yang menghasilkan log. Anda memerlukan nama konfigurasi pemutaran untuk membuat`DeliverySource`. 

1. Gunakan [https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_PutDeliveryDestination.html](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_PutDeliveryDestination.html)untuk menambahkan tujuan di mana log akan ditulis.

   A `DeliveryDestination` mewakili tujuan pengiriman. Anda memerlukan ARN dari grup log, bucket, atau aliran untuk membuat file. `DeliveryDestination`

1. Gunakan [https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_PutDeliveryDestinationPolicy.html](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_PutDeliveryDestinationPolicy.html)jika Anda mengirimkan log di seluruh akun. 

   Jika tujuan pengiriman berada di akun yang berbeda dari konfigurasi pemutaran, Anda memerlukan file`DeliveryDestinationPolicy`. Kebijakan ini memungkinkan CloudWatch Log untuk mengirimkan log ke file`DeliveryDestination`.

1. Gunakan [https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_CreateDelivery.html](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_CreateDelivery.html)untuk menautkan `DeliverySource` ke`DeliveryDestination`.

   A `Delivery` mewakili hubungan antara `DeliverySource` dan`DeliveryDestination`.

# Migrasi strategi AWS Elemental MediaTailor logging Anda
<a name="vended-logs-migrate"></a>

 Jika Anda mengubah strategi log dari Legacy CloudWatch ke log vended, MediaTailor akan membuat perubahan ini segera setelah Anda menyimpan pembaruan. Untuk menghindari gangguan dalam alur kerja logging Anda, gunakan langkah-langkah berikut untuk memigrasikan strategi logging Anda. 

1. Ikuti langkah-langkah seperti yang dijelaskan dalam[Menggunakan log vended](vended-logs.md). Untuk[Aktifkan log vended di MediaTailor](vended-logs.md#vended-logs-config), pilih *kedua* strategi logging (**Vending logs** dan **Legacy CloudWatch**). 

   MediaTailor akan mengirim log melalui kedua log yang dijual dan langsung ke CloudWatch Log. 

1. Buat perubahan yang diperlukan dalam alur kerja Anda yang bergantung pada strategi pencatatan dan tujuan pengiriman Anda.

1. Kunjungi kembali [Aktifkan log vended di MediaTailor](vended-logs.md#vended-logs-config) dan hapus **Legacy CloudWatch** dari strategi **Logging**.

# Menulis AWS Elemental MediaTailor log langsung ke Amazon CloudWatch Logs
<a name="monitoring-cw-logs"></a>

MediaTailor menghasilkan log yang berisi informasi terperinci tentang aktivitas sesi dan interaksi server keputusan iklan, dan menuliskannya ke Amazon CloudWatch. Log memberikan deskripsi berurutan aktivitas yang terjadi selama sesi.

MediaTailor juga dapat menggunakan vended logs untuk fleksibilitas dalam pengiriman log dan harga diskon volume. Untuk informasi tentang log penjual, lihat[Menggunakan log vended](vended-logs.md).

**Topics**
+ [Izin untuk Log Amazon CloudWatch](monitoring-permissions.md)
+ [Log “As Run” untuk Majelis AWS Elemental MediaTailor Saluran](as-run-log.md)
+ [AWS Elemental MediaTailor Analisis log ADS di Amazon CloudWatch Logs Insights](monitor-cloudwatch-ads-logs.md)

# Izin untuk Log Amazon CloudWatch
<a name="monitoring-permissions"></a>

Gunakan AWS Identity and Access Management (IAM) untuk membuat peran yang memberikan AWS Elemental MediaTailor akses ke Amazon CloudWatch. Anda harus melakukan langkah-langkah ini agar CloudWatch Log dipublikasikan untuk akun Anda. CloudWatch secara otomatis menerbitkan metrik untuk akun Anda.

**Untuk memungkinkan MediaTailor akses ke CloudWatch**

1. Buka konsol IAM di [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/).

1. Di panel navigasi konsol IAM, pilih **Peran**, dan lalu pilih **Buat peran**.

1. Pilih jenis peran ** AWS akun lain**.

1. Untuk **ID Akun**, masukkan ID AWS akun Anda.

1. Pilih **Memerlukan ID eksternal** dan masukkan**Midas**. Opsi ini secara otomatis menambahkan kondisi ke kebijakan kepercayaan yang memungkinkan layanan untuk mengambil peran hanya jika permintaan menyertakan yang benar`sts:ExternalId`.

1. Pilih **Berikutnya: Izin**.

1. Tambahkan kebijakan izin yang menentukan tindakan apa yang dapat diselesaikan peran ini. Pilih dari salah satu opsi berikut, lalu pilih **Berikutnya: Tinjau**:
   + **CloudWatchLogsFullAccess**untuk menyediakan akses penuh ke Amazon CloudWatch Logs
   + **CloudWatchFullAccess**untuk menyediakan akses penuh ke Amazon CloudWatch

1. Untuk **nama Peran****MediaTailorLogger**, masukkan, lalu pilih **Buat peran**.

1. Pada halaman **Peran**, pilih peran yang baru saja Anda buat. 

1. Untuk memperbarui kepala sekolah, edit hubungan kepercayaan:

   1. Pada halaman **Ringkasan** peran, pilih tab **Hubungan kepercayaan**.

   1. Pilih **Edit trust relationship** (Edit Hubungan Kepercayaan).

   1. Dalam dokumen kebijakan, ubah kepala sekolah ke MediaTailor layanan. Seharusnya terlihat seperti ini:

      ```
      "Principal": {
         "Service": "mediatailor.amazonaws.com"
      },
      ```

      Seluruh kebijakan harus berbunyi sebagai berikut:

   1. Pilih **Perbarui Kebijakan Kepercayaan**.

# Log “As Run” untuk Majelis AWS Elemental MediaTailor Saluran
<a name="as-run-log"></a>

Log *As Run*, di grup CloudWatch `MediaTailor/Channel/AsRunLog` log, menampilkan informasi tentang program dan jeda iklan saat diputar.

Saat Anda membuat saluran, log As Run dinonaktifkan secara default. Menggunakan Konsol atau AWS Command Line Interface (AWS CLI), Anda dapat mengaktifkan dan menonaktifkan status log As Run untuk setiap saluran di akun Anda.

Saat Anda mengaktifkan log As Run, MediaTailor secara otomatis membuat peran terkait layanan yang memungkinkan MediaTailor untuk menulis dan mengelola log As Run di akun CloudWatch Log Anda. Untuk mengetahui informasi selengkapnya tentang peran terkait layanan, lihat [Menggunakan peran terkait layanan untuk MediaTailor](using-service-linked-roles.md).

**catatan**  
As Run Log saat ini hanya mendukung program default. Untuk saat ini tidak mendukung alternateMedia yang dibuat oleh aturan program. Ini berarti bahwa saat ini tidak menghasilkan As Run Log untuk AlternateMedia.

**Topics**
+ [Mengaktifkan log As Run](enabling-as-run-log.md)
+ [Menonaktifkan log As Run](disabling-as-run-log.md)

# Mengaktifkan log As Run
<a name="enabling-as-run-log"></a>

Untuk mengaktifkan log As Run, tentukan nama saluran dan aktifkan jenis log *As Run* untuk saluran tersebut.

------
#### [ Console ]

**Untuk mengaktifkan log As Run saat membuat saluran**

1. Masuk ke Konsol Manajemen AWS dan buka MediaTailor konsol di [https://console.aws.amazon.com/mediatailor/](https://console.aws.amazon.com/mediatailor/).

1. Di panel navigasi, pilih **Perakitan saluran** > **Saluran**.

1. Pada bilah navigasi, pilih **Buat saluran**.

1. Di panel **Set channel details**, **Configure output**, dan **Access control**, konfigurasikan channel sesuai keinginan.

1. Di panel **kontrol akses**, pilih **Berikutnya**.

1. Di panel **Logging**, di bawah **Jenis log**, pilih **Aktifkan sebagai jalankan** untuk mengaktifkan log As Run.

**Untuk mengaktifkan log As Run saat memperbarui saluran**
**catatan**  
Jika saluran sedang berjalan, Anda harus terlebih dahulu menghentikan saluran itu sebelum Anda dapat memperbaruinya. Setelah menghentikan saluran, Anda dapat memilih **Tindakan** > **Edit** untuk mulai memperbarui saluran.

1. Masuk ke Konsol Manajemen AWS dan buka MediaTailor konsol di [https://console.aws.amazon.com/mediatailor/](https://console.aws.amazon.com/mediatailor/).

1. Di panel navigasi, pilih **Perakitan saluran** > **Saluran**.

1. Pilih saluran yang ingin Anda perbarui untuk mengaktifkan log As Run.

1. Pilih **Tindakan** > **Edit**.

1. Di panel **Setel detail saluran**, **Konfigurasikan output**, dan **kontrol Akses**, perbarui konfigurasi saluran sesuai keinginan.

1. Di panel **kontrol akses**, pilih **Berikutnya**.

1. Di panel **Logging**, di bawah **Jenis log**, pilih **Aktifkan sebagai jalankan** untuk mengaktifkan log As Run.

**Untuk mengaktifkan log As Run dari tab **Logging****
**catatan**  
Jika saluran sedang berjalan, Anda harus menggunakan tab **Logging** alih-alih memilih **Actions** > **Edit** untuk mengaktifkan log As Run.

1. Masuk ke Konsol Manajemen AWS dan buka MediaTailor konsol di [https://console.aws.amazon.com/mediatailor/](https://console.aws.amazon.com/mediatailor/).

1. Di panel navigasi, pilih **Perakitan saluran** > **Saluran**.

1. Pilih saluran yang ingin Anda aktifkan log As Run.

1. Di bilah navigasi di bawah nama saluran, pilih **Logging**.

1. Di bawah **Logging** > **Log types**, pilih **As run** untuk mengaktifkan log As Run.

------
#### [ AWS Command Line Interface (AWS CLI) ]

**Untuk mengaktifkan log As Run**

Jalankan [configure-logs-for-channel](https://docs.aws.amazon.com/cli/latest/reference/mediatailor/configure-logs-for-channel.html)perintah dan tentukan nilai yang sesuai untuk parameter yang diperlukan.

Contoh ini diformat untuk Linux, macOS, atau Unix, dan menggunakan karakter garis miring terbalik (\$1) untuk meningkatkan keterbacaan.

```
$ aws mediatailor configure-logs-for-channel \
--channel-name MyChannel \
--log-types AS_RUN
```

Contoh ini diformat untuk Microsoft Windows, dan menggunakan karakter lanjutan tanda sisipan (^) untuk meningkatkan keterbacaan.

```
C:\> aws mediatailor configure-logs-for-channel ^
--channel-name MyChannel ^
--log-types AS_RUN
```

Saat:
+ `MyChannel`adalah nama saluran yang Anda miliki dan ingin mengaktifkan log As Run untuk.

Jika perintah berjalan dengan berhasil, Anda menerima output yang mirip dengan berikut ini.

```
{
    "ChannelName": "MyChannel",
    "LogTypes": [
       "AS_RUN"
    ]
}
```

------

# Menonaktifkan log As Run
<a name="disabling-as-run-log"></a>

Untuk menonaktifkan log As Run untuk saluran yang mengaktifkannya, tentukan nama saluran dan nonaktifkan jenis log *As Run* untuk saluran tersebut.

------
#### [ Console ]

**Untuk menonaktifkan log As Run saat memperbarui saluran**
**catatan**  
Jika saluran sedang berjalan, Anda harus terlebih dahulu menghentikan saluran itu sebelum Anda dapat memperbaruinya. Setelah menghentikan saluran, Anda dapat memilih **Tindakan** > **Edit** untuk mulai memperbarui saluran.

1. Masuk ke Konsol Manajemen AWS dan buka MediaTailor konsol di [https://console.aws.amazon.com/mediatailor/](https://console.aws.amazon.com/mediatailor/).

1. Di panel navigasi, pilih **Perakitan saluran** > **Saluran**.

1. Pilih saluran yang ingin Anda perbarui untuk mengaktifkan log As Run.

1. Pilih **Tindakan** > **Edit**.

1. Di panel **Setel detail saluran**, **Konfigurasikan output**, dan **kontrol Akses**, perbarui konfigurasi saluran sesuai keinginan.

1. Di panel **kontrol akses**, pilih **Berikutnya**.

1. Di panel **Logging**, di bawah **Jenis log**, hapus **Enable as run** untuk menonaktifkan log As Run.

**Untuk menonaktifkan log As Run dari tab **Logging****
**catatan**  
Jika saluran sedang berjalan, Anda harus menggunakan tab **Logging** alih-alih memilih **Actions** > **Edit** untuk menonaktifkan log As Run.

1. Masuk ke Konsol Manajemen AWS dan buka MediaTailor konsol di [https://console.aws.amazon.com/mediatailor/](https://console.aws.amazon.com/mediatailor/).

1. Di panel navigasi, pilih **Perakitan saluran** > **Saluran**.

1. Pilih saluran yang ingin Anda nonaktifkan log As Run.

1. Di bilah navigasi di bawah nama saluran, pilih **Logging**.

1. Di bawah **Logging** > **Log types**, hapus **As run** untuk menonaktifkan log As Run.

------
#### [ AWS Command Line Interface (AWS CLI) ]

**Untuk menonaktifkan log As Run**

Jalankan [configure-logs-for-channel](https://docs.aws.amazon.com/cli/latest/reference/mediatailor/configure-logs-for-channel.html)perintah dan tentukan nilai yang sesuai untuk parameter yang diperlukan.

Contoh ini diformat untuk Linux, macOS, atau Unix, dan menggunakan karakter garis miring terbalik (\$1) untuk meningkatkan keterbacaan.

```
$ aws mediatailor configure-logs-for-channel \
--channel-name MyChannel \
--log-types
```

Contoh ini diformat untuk Microsoft Windows, dan menggunakan karakter lanjutan tanda sisipan (^) untuk meningkatkan keterbacaan.

```
C:\> aws mediatailor configure-logs-for-channel ^
--channel-name MyChannel ^
--log-types
```

Saat:
+ `MyChannel`adalah nama saluran yang Anda miliki dan ingin menonaktifkan log As Run untuk.

Jika perintah berjalan dengan berhasil, Anda menerima output yang mirip dengan berikut ini.

```
{
    "ChannelName": "MyChannel",
    "LogTypes": []
}
```

------

# AWS Elemental MediaTailor Analisis log ADS di Amazon CloudWatch Logs Insights
<a name="monitor-cloudwatch-ads-logs"></a>

Anda dapat melihat dan menanyakan log server keputusan AWS Elemental MediaTailor iklan (ADS) menggunakan Amazon CloudWatch Logs Insights. MediaTailor mengirimkan log peristiwa ke CloudWatch untuk pemrosesan normal dan kondisi kesalahan. Log mematuhi skema JSON. Melalui Wawasan CloudWatch Log, Anda dapat memilih log berdasarkan kerangka waktu, lalu menjalankan kueri terhadapnya. 

Untuk informasi umum, lihat [Menganalisis data CloudWatch log dengan wawasan Log](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/AnalyzingLogData.html). 

**catatan**  
Untuk mengakses log, Anda memerlukan izin untuk mengakses Amazon CloudWatch. Untuk petunjuk, lihat [Izin untuk Log Amazon CloudWatch](monitoring-permissions.md). 

**Untuk melihat dan menanyakan log ADS menggunakan CloudWatch konsol**

1. Buka CloudWatch konsol di[https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/).

1. Dalam panel navigasi, di bawah **Log**, pilih **Wawasan**.

1. Di bilah pencarian, masukkan**AdDec**, dan kemudian dari daftar drop-down, pilih`MediaTailor/AdDecisionServerInteractions`.

1. (Opsional) Sesuaikan periode waktu yang ingin Anda pelajari. 

1. (Opsional) Ubah kueri di kotak dialog. Untuk panduan umum, lihat [Sintaks kueri wawasan CloudWatch log](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/CWL_QuerySyntax.html). Untuk contoh kueri untuk MediaTailor ADS, lihat[Menanyakan log ADS](querying-the-ads-logs.md).

1. Pilih **Run query** (Jalankan kueri). Kueri mungkin memakan waktu beberapa detik, selama waktu itu **Batal** muncul sebagai pengganti **kueri Jalankan**. 

1. (Opsional) Untuk mengekspor hasil sebagai file CSV, pilih **Tindakan**, lalu pilih **Unduh hasil kueri (CSV**). 

**catatan**  
Konsol membatasi jumlah rekaman yang dikembalikan dalam hasil kueri dan yang diekspor, jadi untuk data massal, gunakan API, AWS Command Line Interface (AWS CLI), atau SDK.

**Topics**
+ [Menanyakan log ADS](querying-the-ads-logs.md)

# Menanyakan log ADS
<a name="querying-the-ads-logs"></a>

CloudWatch Logs Insights menyediakan serangkaian opsi yang kaya untuk menanyakan log Anda. Untuk informasi mendetail tentang sintaks kueri, lihat Sintaks kueri [wawasan CloudWatch Log](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/CWL_QuerySyntax.html). Bagian ini memberikan contoh kueri umum untuk memulai kueri log ADS. Semua kueri dijalankan terhadap log untuk pengaturan rentang waktu saat ini.

Kueri berikut mengambil semua informasi dari log ADS. 

```
fields @timestamp, eventType, sessionId, requestId, @message
| sort sessionId, @timestamp asc
```

Kueri berikut mengambil semua permintaan ke ADS. Kueri ini menunjukkan cara untuk mengambil konten header permintaan untuk MediaTailor log. 

```
fields @timestamp, adsRequestUrl, requestHeaders.0.value as @userAgent, requestHeaders.1.value as @xForwardedFor, sessionId, requestId
| filter eventType = "MAKING_ADS_REQUEST"
| sort @timestamp asc
```

Kueri berikut mengambil iklan yang MediaTailor disisipkan untuk sesi tertentu.

```
fields @timestamp, sessionId, requestId, @message
| filter eventType = "FILLED_AVAIL"
| sort @timestamp asc
```

Kueri berikut mengambil pelacakan URLs yang MediaTailor dipanggil atas nama pemain.

```
fields @timestamp, beaconInfo.trackingEvent, beaconInfo.beaconUri, beaconInfo.headers.0.value as @userAgent, beaconInfo.headers.1.value as @xForwardedFor, sessionId, requestId
| filter eventType = "BEACON_FIRED"
| sort @timestamp asc
```

Kueri berikut mengambil informasi untuk sesi pemutaran tertentu, dengan memfilter hasil menurut. `sessionId` 

```
fields @timestamp, eventType, sessionId, requestId, @message
| filter sessionId = "0aaf6507-c6f9-4884-bfe7-f2f841cb8195"
| sort @timestamp asc
```

Kueri berikut mengambil informasi untuk satu permintaan, dengan memfilter hasil oleh. `requestId`

```
fields @timestamp, eventType, sessionId, requestId, @message
| filter requestId = "f5d3cf39-6258-4cf1-b3f6-a34ff8bf641d"
| sort @timestamp asc
```

Kueri berikut mengambil hitungan entri log untuk setiap jenis peristiwa yang dicatat.

```
fields eventType
| stats count() as @eventCount by eventType
```

Kueri berikut mengambil ID yang tersedia dan daftar iklan yang dilewati untuk semua ketersediaan yang telah melewatkan iklan.

```
fields avail.availId
| parse @message '"skippedAds":[*]' as @skippedAdsList
| filter ispresent(@skippedAdsList)
```

# Mengontrol volume AWS Elemental MediaTailor log
<a name="log-configuration"></a>

MediaTailor log sesi penyisipan iklan terkadang bertele-tele. Untuk mengurangi biaya log, Anda dapat menentukan persentase log sesi yang MediaTailor dikirim ke Amazon CloudWatch Logs. Misalnya, jika konfigurasi pemutaran Anda memiliki 1000 sesi penyisipan iklan dan Anda menetapkan persentase nilai yang diaktifkan`60`, MediaTailor mengirimkan log untuk 600 sesi ke CloudWatch Log. MediaTailor memutuskan secara acak sesi mana yang akan dikirim log. Jika Anda ingin melihat log untuk sesi tertentu, Anda dapat menggunakan [mode log debug](debug-log-mode.md). 

Saat Anda menetapkan persentase pencatatan, MediaTailor secara otomatis membuat peran terkait layanan yang memberikan MediaTailor izin yang diperlukan untuk menulis CloudWatch Log ke akun Anda. Untuk informasi tentang cara MediaTailor menggunakan peran terkait layanan, lihat. [Menggunakan peran terkait layanan untuk MediaTailor](using-service-linked-roles.md)

## Membuat konfigurasi log
<a name="creating-log-configuration"></a>

Untuk mengontrol persentase log sesi yang MediaTailor menulis ke CloudWatch Log, Anda membuat *konfigurasi log untuk konfigurasi* pemutaran Anda. Saat membuat konfigurasi log, Anda menentukan *nama konfigurasi pemutaran*, dan nilai yang *diaktifkan persen*.

------
#### [ Console ]

**Untuk membuat konfigurasi log untuk konfigurasi pemutaran *yang ada***

1. Masuk ke Konsol Manajemen AWS dan buka MediaTailor konsol di [https://console.aws.amazon.com/mediatailor/](https://console.aws.amazon.com/mediatailor/).

1. Pada panel **konfigurasi Playback**, pilih konfigurasi pemutaran yang ingin Anda atur konfigurasi log.

1. Pilih **Edit**.

1. Di bawah **konfigurasi Log**, tentukan nilai yang **diaktifkan persen**.

**Untuk membuat konfigurasi log untuk konfigurasi pemutaran *baru***
+ Ikuti prosedur di [Konfigurasi log](configurations-create.md#configurations-log-configurations).

------
#### [ AWS Command Line Interface (AWS CLI) ]

**Untuk membuat konfigurasi log untuk konfigurasi pemutaran *yang ada***

Untuk membuat konfigurasi log dengan menggunakan AWS CLI, jalankan perintah [configure-logs-for-playback-configuration](https://docs.aws.amazon.com/cli/latest/reference/mediatailor/configure-logs-for-playback-configuration.html) dan tentukan nilai yang sesuai untuk parameter yang diperlukan.

Contoh ini diformat untuk Linux, macOS, atau Unix, dan menggunakan karakter garis miring terbalik (\$1) untuk meningkatkan keterbacaan.

```
$ aws mediatailor configure-logs-for-playback-configuration \
--percent-enabled 10 \
--playback-configuration-name MyPlaybackConfiguration
```

Contoh ini diformat untuk Microsoft Windows, dan menggunakan karakter lanjutan tanda sisipan (^) untuk meningkatkan keterbacaan.

```
C:\> aws mediatailor configure-logs-for-playback-configuration ^
--percent-enabled 10 ^
--playback-configuration-name MyPlaybackConfiguration
```

Saat:
+ `percent-enabled`adalah persentase log sesi konfigurasi pemutaran yang MediaTailor dikirim ke CloudWatch Log.
+ `playback-configuration-name`adalah nama konfigurasi pemutaran untuk mengatur pengaturan konfigurasi log untuk.

Jika perintah berjalan dengan berhasil, Anda menerima output yang mirip dengan berikut ini.

```
{
    "PercentEnabled": 10,
    "PlaybackConfigurationName": "MyPlaybackConfiguration"
}
```

**Untuk membuat konfigurasi log untuk konfigurasi pemutaran *baru***
+ Gunakan `configure-logs-for-playback-configuration` opsi untuk [put-playback-configuration](https://docs.aws.amazon.com/cli/latest/reference/mediatailor/put-playback-configuration.html)perintah.

------

## Menonaktifkan konfigurasi log
<a name="deactivating-logging-configuration"></a>

Setelah membuat konfigurasi log, Anda tidak dapat menghapusnya — Anda hanya dapat *menonaktifkannya*. Untuk menonaktifkan konfigurasi log, setel nilai **persen yang diaktifkan** ke **0** dengan MediaTailor konsol atau API. Ini mematikan semua pencatatan sesi untuk konfigurasi pemutaran itu.

Jika Anda ingin menghapus peran terkait layanan yang MediaTailor digunakan untuk konfigurasi log di akun Anda, Anda harus terlebih dahulu menonaktifkan semua konfigurasi log Anda. Untuk informasi tentang cara menghapus peran terkait layanan, lihat. [Menggunakan peran terkait layanan untuk MediaTailor](using-service-linked-roles.md)

------
#### [ Console ]

**Untuk menonaktifkan konfigurasi log pada konfigurasi pemutaran**

1. Masuk ke Konsol Manajemen AWS dan buka MediaTailor konsol di [https://console.aws.amazon.com/mediatailor/](https://console.aws.amazon.com/mediatailor/).

1. Pada panel **konfigurasi Playback**, pilih konfigurasi pemutaran yang ingin Anda nonaktifkan konfigurasi log.

1. Pilih **Edit**.

1. Di bawah **konfigurasi Log**, atur **persen nilai yang diaktifkan** ke`0`. Ini mematikan semua pencatatan sesi untuk konfigurasi pemutaran ini.

1. Pilih **Simpan**.

------
#### [ AWS Command Line Interface (AWS CLI) ]

**Untuk menonaktifkan konfigurasi log**
+ Tetapkan `percent-enabled` nilai untuk `0` menggunakan perintah [configure-logs-for-playback-configuration](https://docs.aws.amazon.com/cli/latest/reference/mediatailor/configure-logs-for-playback-configuration.html).

------

# Memfilter AWS Elemental MediaTailor log dan acara
<a name="logs-filter"></a>

Log yang dipancarkan dari konfigurasi pemutaran MediaTailor termasuk informasi tentang berbagai aktivitas yang terjadi selama sesi pemutaran. Kegiatan ini diidentifikasi dalam jenis peristiwa log. Banyak peristiwa dicatat secara default. Untuk membantu mengontrol biaya log di Amazon CloudWatch, Anda dapat menentukan log yang MediaTailor dipancarkan. 

MediaTailor memberi Anda kontrol atas pemfilteran log sehingga Anda dapat melakukan hal berikut:
+ Tentukan peristiwa log yang ingin Anda kecualikan dari log
+ Aktifkan pencatatan tanggapan mentah dari server keputusan iklan (ADS)

Anda dapat mengatur preferensi pemfilteran log ini secara independen untuk setiap sesi pemutaran, atau sebagai default untuk semua sesi pemutaran untuk konfigurasi pemutaran. 
+ Untuk memfilter log per sesi, sertakan parameter kueri dalam permintaan inisialisasi sesi pemutaran.
+ Untuk memfilter log berdasarkan konfigurasi per-pemutaran, gunakan MediaTailor konsol atau API untuk menunjukkan preferensi Anda dalam pengaturan konfigurasi pemutaran. 

Bagian berikut memberikan instruksi untuk mengaktifkan pemfilteran log pada sesi dan konfigurasi pemutaran.

# Filter log per sesi
<a name="logs-filter-session"></a>

Untuk menentukan tingkat detail log yang disesuaikan untuk setiap sesi, tambahkan parameter berikut ke permintaan sesi pemutaran sisi server atau sisi klien awal Anda. Tambahkan nilai ke parameter untuk mewakili peristiwa yang ingin Anda sertakan atau kecualikan, dalam format yang dibatasi koma:
+ `aws.adsInteractionLogPublishOptInEventTypes`untuk menerima log untuk interaksi server keputusan iklan (ADS) tertentu.
+ `aws.adsInteractionLogExcludeEventTypes`untuk berhenti menerima log untuk interaksi ADS tertentu.
+ `aws.manifestServiceLogExcludeEventTypes`untuk berhenti menerima log untuk interaksi layanan manifes tertentu. 

Untuk daftar jenis log dan peristiwa yang MediaTailor memancarkan, lihat [Log manifes](log-types.md)[Log ADS](ads-log-format.md), dan[Log transkode](tm-log-format.md).

Jika Anda tidak melewati parameter kueri apa pun untuk pemfilteran log, MediaTailor tulis semua log ke tujuan pengiriman Anda. 

**Example inisialisasi sesi sisi server dengan filter log**  
Untuk mengecualikan `GENERATED_MANIFEST` dan `PARSING_ERROR` peristiwa dari log manifes Anda dan `MAKING_ADS_REQUEST` dari log ADS, permintaan inisialisasi sesi akan terlihat seperti ini:  

```
GET <mediatailorURL>/v1/master/<hashed-account-id>/<origin-id>/index.m3u8?aws.logMode=DEBUG&aws.manifestServiceLogExcludeEventTypes=GENERATED_MANIFEST,PARSING_ERROR&aws.adsInteractionLogExcludeEventTypes=MAKING_ADS_REQUEST
```
Untuk mengaktifkan log mentah dari ADS Anda, sertakan `RAW_ADS_RESPONSE` nilai untuk `AdsInteractionPublishOptInEventType` parameter:  

```
GET <mediatailorURL>/v1/master/<hashed-account-id>/<origin-id>/index.m3u8?aws.adsInteractionPublishOptInEventType=RAW_ADS_RESPONSE
```

**Example inisialisasi sesi sisi klien dengan filter log**  
Untuk mengecualikan peristiwa log selama inisialisasi sesi sisi klien, sertakan `availSuppression` dan parameter tipe log dalam permintaan POST klien Anda. MediaTailor Untuk informasi selengkapnya tentang cara membuat permintaan sesi pemutaran sisi klien, lihat. [Pelacakan iklan sisi klien](ad-reporting-client-side.md) Contoh berikut mengecualikan `CONFIG_SECURITY_ERROR` dan `PARSING_ERROR` peristiwa dari log manifes Anda dan `MAKING_ADS_REQUEST` dari log ADS.  

```
POST parent.m3u8
   {
       "adsInteractionLog": {
           ...
           "excludeEventTypes": [
               "MAKING_ADS_REQUEST"
           ]
       },
       "manifestServiceLog": {
           ...
           "excludeEventTypes": [
               "GENERATED_MANIFEST",
               "PARSING_ERROR"
           ]
       },
      "logMode": "DEBUG"
   }
```
 Untuk mengaktifkan log mentah dari ADS Anda, sertakan `RAW_ADS_RESPONSE ` nilai untuk `publishOptInEventTypes` parameter:   

```
POST parent.m3u8
   {
       "adsInteractionLog": {
           "publishOptInEventTypes": ["RAW_ADS_RESPONSE"],
           "excludeEventTypes": [
               "MAKING_ADS_REQUEST"
           ]
       },
       "manifestServiceLog": {
           ...
           "excludeEventTypes": [
               "GENERATED_MANIFEST",
               "PARSING_ERROR"
           ]
       },
       "logMode": "DEBUG"
   }
```

# Filter log konfigurasi per pemutaran
<a name="logs-filter-config"></a>

Gunakan pengaturan konfigurasi pemutaran untuk menentukan jenis peristiwa log yang MediaTailor dipancarkan sebagai default dari konfigurasi pemutaran ini. MediaTailor menggunakan pengaturan penyaringan log default ini untuk semua sesi yang tidak menyertakan parameter kueri pemfilteran pada permintaan init sesi. 

Anda dapat memilih untuk melakukan hal berikut:
+ Menerima log untuk interaksi server keputusan iklan (ADS) tertentu.
+ Kecualikan log untuk interaksi ADS tertentu.
+ Kecualikan log untuk interaksi layanan manifes tertentu. 

Untuk mengatur pengaturan ini dari MediaTailor konsol, lihat[Membuat konfigurasi](configurations-create.md). Untuk MediaTailor API, lihat [https://docs.aws.amazon.com/mediatailor/latest/apireference/API_PutPlaybackConfiguration.html](https://docs.aws.amazon.com/mediatailor/latest/apireference/API_PutPlaybackConfiguration.html)di *Referensi AWS Elemental MediaTailor API*.

Untuk daftar jenis log dan peristiwa yang MediaTailor memancarkan, lihat [Log manifes](log-types.md)[Log ADS](ads-log-format.md), dan[Log transkode](tm-log-format.md).

# Menghasilkan AWS Elemental MediaTailor log debug
<a name="debug-log-mode"></a>

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](https://docs.aws.amazon.com/mediatailor/latest/ug/debug-log-mode.html#debug-log-mode-fields).
+ **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](logs-filter.md)

## Prasyarat
<a name="prerequisites"></a>

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](https://docs.aws.amazon.com/mediatailor/latest/ug/monitoring-permissions.html).

## Cara mengatur mode log ke debug
<a name="how-to-turn-on-debug-log-mode"></a>

Bagian ini menjelaskan cara mengatur mode log ke debug untuk pelaporan sisi server dan pelaporan sisi klien.

### Pelaporan sisi server
<a name="server-side-reporting"></a>

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.](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 menyertakan `?aws.logMode=DEBUG` terlihat seperti berikut:

**Example Permintaan pemutaran ke titik akhir HLS**  

```
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 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). 

### Pelaporan sisi klien
<a name="client-side-reporting"></a>

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](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, 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](#debug-active). 

## Sesi debug aktif maksimum
<a name="maximum-active-debug-log-sessions"></a>

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, lihat[Verify that the debug log mode is active for your playback session](#debug-active). 

## Bidang log debug
<a name="debug-log-mode-fields"></a>

 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:[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/mediatailor/latest/ug/debug-log-mode.html) | 
| 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 dari 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:`HLS`, `DASH` | 

## Baca log debug
<a name="read-the-debug-logs"></a>

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](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
<a name="query-examples"></a>

 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 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"
```

# Pemantauan AWS Elemental MediaTailor dengan CloudWatch metrik Amazon
<a name="monitoring-cloudwatch-metrics"></a>

Anda dapat memantau AWS Elemental MediaTailor metrik menggunakan CloudWatch. CloudWatch mengumpulkan data mentah tentang kinerja layanan dan memproses data tersebut menjadi metrik yang dapat dibaca, mendekati waktu nyata. Statistik ini disimpan untuk jangka waktu 15 bulan, sehingga Anda dapat mengakses informasi historis dan mendapatkan perspektif yang lebih baik tentang performa aplikasi atau layanan web Anda. Anda juga dapat mengatur alarm yang memperhatikan ambang batas tertentu dan mengirim notifikasi atau mengambil tindakan saat ambang batas tersebut terpenuhi. Untuk informasi selengkapnya, lihat [Panduan CloudWatch Pengguna Amazon](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/).

Metrik dapat berguna saat Anda menyelidiki manifes basi. Untuk informasi selengkapnya, lihat [Menggunakan metrik untuk mendiagnosis manifestasi basi](stale-manifest-diagnose.md).

Metrik dikelompokkan terlebih dahulu berdasarkan namespace layanan, lalu berdasarkan berbagai kombinasi dimensi dalam setiap namespace.

**Untuk melihat metrik menggunakan konsol CloudWatch**

1. Buka CloudWatch konsol di[https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/).

1. Pada panel navigasi, silakan pilih **Metrik**.

1. Di bawah **Semua metrik**, pilih **MediaTailor**namespace. 

1. Pilih dimensi metrik untuk melihat metrik (misalnya, **originId**).

1. Tentukan periode waktu yang ingin Anda lihat. 

**Untuk melihat metrik menggunakan AWS Command Line Interface ()AWS CLI**
+ Pada prompt perintah, gunakan perintah berikut:

  ```
  aws cloudwatch list-metrics --namespace "AWS/MediaTailor"
  ```

## AWS Elemental MediaTailor CloudWatch metrik
<a name="metrics"></a>

 AWS Elemental MediaTailor Namespace mencakup metrik berikut. Metrik ini dipublikasikan secara default ke akun Anda. 

### Metrik Perakitan Saluran (CA)
<a name="metrics.channel-assembly"></a>

Dalam tabel berikut, semua metrik tersedia berdasarkan saluran atau output saluran.


| Metrik | Deskripsi | 
| --- | --- | 
|  4xxErrorCount  |  Jumlah `4xx` kesalahan.  | 
|  5xxErrorCount  |  Jumlah `5xx` kesalahan.  | 
|  RequestCount  |  Jumlah total permintaan . Jumlah transaksi sangat tergantung pada seberapa sering pemain meminta manifes yang diperbarui, dan jumlah pemain. Setiap permintaan pemain dihitung sebagai transaksi.  | 
|  TotalTime  |  Jumlah waktu yang dibutuhkan server aplikasi untuk memproses permintaan, termasuk waktu yang digunakan untuk menerima byte dari dan menulis byte ke klien dan jaringan.   | 

#### Metrik penyisipan iklan sisi server (SSAI)
<a name="metrics.server-side-ad-insertion"></a>

Tabel berikut mencantumkan metrik penyisipan iklan sisi server.


| Metrik | Deskripsi | 
| --- | --- | 
|  AdDecisionServer.Ads  |  Jumlah iklan yang disertakan dalam respons server keputusan iklan (ADS) dalam jangka CloudWatch waktu yang Anda tentukan.  | 
|  AdDecisionServer.Duration  |  Total durasi, dalam milidetik, semua iklan yang MediaTailor diterima dari ADS dalam jangka CloudWatch waktu yang Anda tentukan. Durasi ini bisa lebih besar dari `Avail.Duration` yang Anda tentukan.  | 
|  AdDecisionServer.Errors  |  Jumlah respons kode status non-HTTP 200, respons kosong, dan respons waktu habis yang MediaTailor diterima dari ADS dalam jangka CloudWatch waktu yang Anda tentukan.  | 
|  AdDecisionServer.FillRate  |  Rata-rata sederhana dari tarif di mana tanggapan dari ADS mengisi iklan individual terkait yang tersedia untuk periode waktu yang Anda tentukan. Untuk mendapatkan rata-rata tertimbang, hitung `AdDecisionServer.Duration` sebagai persentase dari. `Avail.Duration` Untuk informasi lebih lanjut tentang rata-rata sederhana dan tertimbang, lihat. [Rata-rata sederhana dan tertimbang](#metrics-simple-average)  | 
|  AdDecisionServer.Latency  |  Waktu respons dalam milidetik untuk permintaan yang dibuat oleh MediaTailor ADS.  | 
|  AdDecisionServer.Timeouts  |  Jumlah permintaan waktu habis ke ADS dalam periode CloudWatch waktu yang Anda tentukan.  | 
|  AdNotReady  |  Berapa kali ADS menunjuk iklan yang belum ditranskode oleh layanan transcoder internal dalam periode waktu yang Anda tentukan. Nilai tinggi untuk metrik ini mungkin berkontribusi pada keseluruhan yang rendah`Avail.FillRate`.  | 
|  AdsBilled  |  Jumlah iklan yang MediaTailor menagih pelanggan berdasarkan penyisipan.  | 
|  Avail.Duration  |  Jumlah total milidetik iklan yang direncanakan tersedia dalam periode CloudWatch waktu tersebut. Total yang direncanakan didasarkan pada durasi penggunaan iklan dalam manifes asal.  | 
|  Avail.FilledDuration  |  Jumlah milidetik waktu penggunaan iklan yang direncanakan yang MediaTailor akan diisi dengan iklan dalam periode CloudWatch waktu tersebut.  | 
|  Avail.FillRate  |  Rata-rata sederhana yang direncanakan dari tarif yang MediaTailor akan mengisi ketersediaan iklan individu dalam periode CloudWatch waktu tersebut. Untuk mendapatkan rata-rata tertimbang, hitung `Avail.FilledDuration` sebagai persentase dari. `Avail.Duration` Untuk informasi lebih lanjut tentang rata-rata sederhana dan tertimbang, lihat. [Rata-rata sederhana dan tertimbang](#metrics-simple-average) Maksimum `Avail.FillRate` yang MediaTailor dapat dicapai dibatasi oleh. `AdDecisionServer.FillRate` Jika `Avail.FillRate` rendah, bandingkan dengan`AdDecisionServer.FillRate`. Jika rendah, ADS Anda mungkin tidak menampilkan iklan yang cukup untuk durasi penggunaan. `AdDecisionServer.FillRate`   | 
|  Avail.Impression  |  Jumlah iklan dengan peristiwa pelacakan tayangan yang MediaTailor terlihat selama beaconing sisi server (bukan jumlah tayangan).  | 
|  Avail.ObservedDuration  |  Jumlah total milidetik ketersediaan iklan yang diamati yang terjadi dalam periode CloudWatch waktu tersebut. `Avail.ObservedDuration`dipancarkan pada akhir iklan yang tersedia, dan didasarkan pada durasi segmen yang dilaporkan dalam manifes selama iklan tersedia.  | 
|  Avail.ObservedFilledDuration  |  Jumlah milidetik yang diamati dari waktu penggunaan iklan yang MediaTailor diisi dengan iklan dalam periode CloudWatch waktu tersebut.  | 
|  Avail.ObservedFillRate  |  Rata-rata sederhana yang diamati dari tarif di mana iklan individu yang MediaTailor diisi tersedia dalam periode CloudWatch waktu tersebut. Dipancarkan hanya untuk manifes HLS, pada tag pertama. `CUE-IN` Jika tidak ada `CUE-IN` tag, MediaTailor tidak memancarkan metrik ini.   | 
|  Avail.ObservedSlateDuration  |  Jumlah total milidetik batu tulis yang diamati yang dimasukkan dalam periode tersebut. CloudWatch   | 
|  GetManifest.Age  |  Total usia manifes dalam milidetik. Diukur dari saat asal membuat manifes, hingga saat MediaTailor mengirim manifes yang dipersonalisasi.  Untuk informasi selengkapnya tentang metrik untuk mengukur usia manifes, lihat[Menggunakan metrik untuk mendiagnosis manifestasi basi](stale-manifest-diagnose.md).  | 
|  GetManifest.Errors  |  Jumlah kesalahan yang MediaTailor diterima saat menghasilkan manifes dalam periode CloudWatch waktu yang Anda tentukan.  | 
|  GetManifest.Latency  |  Waktu MediaTailor respons dalam milidetik untuk permintaan menghasilkan manifes. Untuk informasi selengkapnya tentang metrik untuk mengukur usia manifes, lihat[Menggunakan metrik untuk mendiagnosis manifestasi basi](stale-manifest-diagnose.md).  | 
|  GetManifest.MediaTailorAge  |  Jumlah waktu manifes disimpan MediaTailor dalam milidetik. Diukur dari saat MediaTailor menerima respons asal, hingga saat MediaTailor mengirim manifes yang dipersonalisasi.  Untuk informasi selengkapnya tentang metrik untuk mengukur usia manifes, lihat[Menggunakan metrik untuk mendiagnosis manifestasi basi](stale-manifest-diagnose.md).  | 
|  Origin.Age  |  Jumlah waktu asal memiliki manifes dalam milidetik. Diukur dari saat asal membuat manifes, hingga saat MediaTailor mengirim permintaan asal.  Semua `origin.*` metrik dipancarkan untuk permintaan yang dipenuhi langsung dari asal. Mereka tidak dipancarkan untuk respons asal yang di-cache. Untuk informasi selengkapnya tentang metrik untuk mengukur usia manifes, lihat[Menggunakan metrik untuk mendiagnosis manifestasi basi](stale-manifest-diagnose.md).  | 
|  Origin.Errors  |  Jumlah respons kode status non-HTTP 200 dan respons waktu habis yang MediaTailor diterima dari server asal dalam periode CloudWatch waktu yang Anda tentukan. Semua `origin.*` metrik dipancarkan untuk permintaan yang dipenuhi langsung dari asal. Mereka tidak dipancarkan untuk respons asal yang di-cache.  | 
|  Origin.ManifestFileSizeBytes  |  Ukuran file dari manifes asal dalam byte untuk HLS dan DASH. Biasanya metrik ini digunakan bersamaan dengan`Origin.ManifestFileSizeTooLarge`. Semua `origin.*` metrik dipancarkan untuk permintaan yang dipenuhi langsung dari asal. Mereka tidak dipancarkan untuk respons asal yang di-cache.  | 
|  Origin.ManifestFileSizeTooLarge  |  Jumlah tanggapan dari asal yang memiliki ukuran manifes lebih besar dari jumlah yang dikonfigurasi. Biasanya metrik ini digunakan bersamaan dengan`Origin.ManifestFileSizeBytes`. Semua `origin.*` metrik dipancarkan untuk permintaan yang dipenuhi langsung dari asal. Mereka tidak dipancarkan untuk respons asal yang di-cache.  | 
|  Origin.Timeouts  |  Jumlah permintaan timed-out ke server asal dalam periode CloudWatch waktu yang Anda tentukan. Semua `origin.*` metrik dipancarkan untuk permintaan yang dipenuhi langsung dari asal. Mereka tidak dipancarkan untuk respons asal yang di-cache.  | 
|  Requests  |  Jumlah transaksi bersamaan per detik di semua jenis permintaan. Jumlah transaksi terutama tergantung pada jumlah pemain dan seberapa sering pemain meminta manifes yang diperbarui. Setiap permintaan pemain dihitung sebagai transaksi.  | 
|  SkippedReason.DurationExceeded  |  Jumlah iklan yang tidak dimasukkan ke dalam avail karena ADS menampilkan durasi iklan yang lebih besar dari durasi avail yang ditentukan. Nilai tinggi untuk metrik ini mungkin berkontribusi pada perbedaan antara metrik `Avail.Ads` dan `AdDecisionServer.Ads` metrik. Untuk informasi selengkapnya tentang alasan dilewati iklan, lihat[Pemecahan masalah melewatkan iklan](troubleshooting-ad-skipping-overview.md).  | 
|  SkippedReason.EarlyCueIn  |  Jumlah iklan yang dilewati karena awal`CUE-IN`.  | 
|  SkippedReason.ImportError  |  Jumlah iklan yang dilewati karena kesalahan dalam pekerjaan impor.  | 
|  SkippedReason.ImportInProgress  |  Jumlah iklan yang dilewati karena pekerjaan impor aktif yang ada.  | 
|  SkippedReason.InternalError  |  Jumlah iklan yang dilewati karena kesalahan MediaTailor internal.  | 
|  SkippedReason.NewCreative  |  Jumlah iklan yang tidak dimasukkan ke dalam avail karena ini adalah pertama kalinya aset diminta oleh klien. Nilai tinggi untuk metrik ini mungkin untuk sementara berkontribusi pada keseluruhan yang rendah`Avail.FillRate`, sampai aset dapat berhasil ditranskode.  | 
|  SkippedReason.NoVariantMatch  |  Jumlah iklan yang dilewati karena tidak ada varian kecocokan antara iklan dan konten.  | 
|  SkippedReason.PersonalizationThresholdExceeded  |  Durasi iklan melebihi setelan **Ambang Personalisasi** dalam konfigurasi ini.  | 
|  SkippedReason.ProfileNotFound  |  Jumlah iklan yang dilewati karena profil transcoding tidak ditemukan.  | 
|  SkippedReason.TranscodeError  |  Jumlah iklan yang dilewati karena kesalahan transkode.  | 
|  SkippedReason.TranscodeInProgress  |  Hitungan jumlah iklan yang tidak dimasukkan ke dalam berhasil karena iklan belum ditranskode. Nilai tinggi untuk metrik ini mungkin untuk sementara berkontribusi pada keseluruhan yang rendah`Avail.FillRate`, sampai aset dapat berhasil ditranskode.  | 
|  GetAssets.Requests  |  Jumlah permintaan Daftar Aset yang diterima untuk sesi Interstitials HLS dalam periode waktu tersebut. CloudWatch Gunakan metrik ini untuk memantau volume pengambilan keputusan iklan yang mengikat akhir dan memahami skala penggunaan Interstitial HLS.  | 
|  GetAssets.Latency  |  Waktu respons untuk permintaan Daftar Aset dalam milidetik untuk sesi Interstitial HLS. Pantau metrik ini untuk memastikan kinerja pengambilan keputusan iklan yang optimal dan mengidentifikasi potensi kemacetan dalam alur kerja yang mengikat akhir.  | 

**catatan**  
Untuk sesi Pengantara HLS, beberapa metrik berperilaku berbeda karena sifat pengambilan keputusan iklan yang mengikat terlambat:  
`Avail.ObservedFilledDuration`kecocokan `Avail.FilledDuration` karena MediaTailor tidak dapat mengamati perilaku pemutaran sisi klien yang sebenarnya.
`Avail.ObservedSlateDuration`melaporkan durasi slate yang direncanakan dari tanggapan Daftar Aset daripada pemutaran yang diamati.
Metrik yang diawali dengan “Diamati” memberikan nilai estimasi untuk sesi Interstitial HLS.

### Rata-rata sederhana dan tertimbang
<a name="metrics-simple-average"></a>

Anda dapat mengambil rata-rata sederhana dan rata-rata tertimbang untuk tanggapan dari ADS ke permintaan iklan dari MediaTailor dan cara MediaTailor mengisi ketersediaan iklan: 
+ *Rata-rata sederhana* disediakan di `AdDecisionServer.FillRate` dan. `Avail.FillRate` Ini adalah rata-rata persentase tingkat pengisian untuk individu yang tersedia untuk periode waktu tersebut. Rata-rata sederhana tidak memperhitungkan perbedaan antara durasi ketersediaan individu.
+ *Rata-rata tertimbang adalah persentase* tingkat pengisian untuk jumlah semua durasi yang tersedia. Ini dihitung sebagai (`AdDecisionServer.Duration`\$1100)/`Avail.Duration`dan (`Avail.FilledDuration`\$1100)/. `Avail.Duration` Rata-rata ini mencerminkan perbedaan durasi setiap iklan yang tersedia, memberikan bobot lebih bagi mereka yang memiliki durasi lebih lama. 

Untuk jangka waktu yang hanya berisi satu iklan, rata-rata sederhana yang disediakan oleh sama dengan rata-rata tertimbang yang disediakan oleh (`AdDecisionServer.Duration`\$1100)/. `AdDecisionServer.FillRate` `Avail.Duration` Rata-rata sederhana yang disediakan oleh sama dengan rata-rata tertimbang yang disediakan oleh (`Avail.FilledDuration`\$1 100)/. `Avail.FillRate` `Avail.Duration` 

**Contoh**

Asumsikan periode waktu yang Anda tentukan memiliki dua ketersediaan iklan berikut:
+ Iklan pertama yang tersedia memiliki durasi 90 detik:
  + Respons ADS untuk avail menyediakan 45 detik iklan (50% terisi). 
  + MediaTailor mengisi 45 detik dari waktu iklan yang tersedia (50% diisi).
+ Iklan kedua yang tersedia memiliki durasi 120 detik: 
  + Respons ADS untuk avail menyediakan 120 detik iklan (100% terisi). 
  + MediaTailor mengisi 90 detik dari waktu iklan yang tersedia (75% diisi).

Metriknya adalah sebagai berikut: 
+ `Avail.Duration`adalah 210, jumlah dari dua durasi penggunaan iklan: 90 \$1 120.
+ `AdDecisionServer.Duration`adalah 165, jumlah dari dua durasi respons: 45 \$1 120.
+ `Avail.FilledDuration`adalah 135, jumlah dari dua durasi yang diisi: 45 \$1 90. 
+ `AdDecisionServer.FillRate`adalah 75%, rata-rata persentase yang diisi untuk setiap keuntungan: (50% \$1 100%)/2. Ini adalah rata-rata sederhana.
+ Rata-rata tertimbang untuk tingkat pengisian ADS adalah 78,57%, yang merupakan `AdDecisionServer.Duration` persentase dari`Avail.Duration`: (165\$1100) /210. Perhitungan ini menjelaskan perbedaan durasi. 
+ `Avail.FillRate`adalah 62,5%, rata-rata persentase yang diisi untuk setiap keuntungan: (50% \$1 75%)/2. Ini adalah rata-rata sederhana.
+ Rata-rata tertimbang untuk tarif pengisian yang MediaTailor tersedia adalah 64,29%, yang merupakan persentase dari`Avail.Duration`: (135\$1 100) /210. `Avail.FilledDuration` Perhitungan ini menjelaskan perbedaan durasi. 

Yang tertinggi `Avail.FillRate` yang MediaTailor dapat dicapai untuk setiap iklan yang tersedia adalah 100%. ADS mungkin menampilkan lebih banyak waktu iklan daripada yang tersedia di avail, tetapi hanya MediaTailor dapat mengisi waktu yang tersedia. 

## AWS Elemental MediaTailor CloudWatch dimensi
<a name="dimensions"></a>

Anda dapat memfilter AWS Elemental MediaTailor data menggunakan dimensi berikut.


| Dimensi | Deskripsi | 
| --- | --- | 
|  `Configuration Name`  |  Menunjukkan konfigurasi yang dimiliki metrik.  | 

# Menggunakan metrik untuk mendiagnosis manifestasi basi dari AWS Elemental MediaTailor
<a name="stale-manifest-diagnose"></a>

Manifes basi adalah manifes yang belum diperbarui baru-baru ini. Alur kerja penyisipan iklan yang berbeda dapat memiliki toleransi yang bervariasi terhadap berapa lama harus berlalu sebelum manifes dianggap basi, berdasarkan berbagai faktor (seperti persyaratan untuk sistem hilir). Anda dapat menggunakan CloudWatch metrik Amazon untuk mengidentifikasi manifes yang melebihi toleransi kebuntuan untuk alur kerja Anda, dan membantu mengidentifikasi apa yang dapat menyebabkan penundaan dalam pembaruan manifes. 

Metrik berikut membantu mengidentifikasi manifestasi basi dan penyebabnya.

Untuk informasi tentang semua metrik yang MediaTailor dipancarkan, lihat. [AWS Elemental MediaTailor CloudWatch metrik](monitoring-cloudwatch-metrics.md#metrics)


| Metrik | Definisi | Gunakan | 
| --- | --- | --- | 
| GetManifest.Age |  Mengukur usia total manifes, termasuk keduanya `GetManifest.MediaTailorAge` dan `Origin.Age` untuk konfigurasi ini.   |  Anda dapat menggunakan metrik ini untuk mengidentifikasi manifes yang melewati ambang batas pembaruan Anda dan sudah basi.  Setel alarm pada metrik ini sehingga Anda diberi tahu saat manifes basi disajikan. *Untuk informasi tentang alarm, lihat [Mengkhawatirkan metrik di Panduan Pengguna](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/ConsoleAlarms.html) Amazon. CloudWatch * Ketika Anda menerima alarm, gunakan `Origin.Age` dan `GetManifest.MediaTailorAge` untuk mengidentifikasi apakah MediaTailor atau asal menyebabkan kebuntuan.   | 
| Origin.Age | Mengukur berapa lama asal memiliki manifes sebelum mengirimnya MediaTailor untuk konfigurasi ini.Metrik ini tidak dipancarkan ketika respons berasal dari jaringan pengiriman konten (CDN). Respons harus berasal dari asal `Origin.Age` untuk dipancarkan.  |  Saat Anda mengidentifikasi manifes basi dengan`GetManifest.Age`, Anda dapat menganalisis `Origin.Age` metrik dan `GetManifest.MediaTailorAge` metrik untuk menentukan mana yang berkontribusi pada kebuntuan nyata.  Jika Anda menemukan `Origin.Age` itu lebih lama dari waktu pemrosesan biasa Anda di tempat asal, kemungkinan sistem hulu menyebabkan masalah dan Anda harus memfokuskan diagnostik di sana.   | 
| GetManifest.MediaTailorAge | Mengukur berapa lama MediaTailor telah menyimpan manifes ini untuk konfigurasi ini. |  Saat Anda mengidentifikasi manifes basi dengan`GetManifest.Age`, Anda dapat menganalisis `GetManifest.MediaTailorAge` metrik dan `Origin.Age` metrik untuk menentukan mana yang berkontribusi pada kebuntuan nyata.  Jika `GetManifest.MediaTailorAge` lebih lama dari waktu personalisasi manifes biasa Anda MediaTailor, kemungkinan MediaTailor itu menyebabkan masalah dan Anda harus memfokuskan diagnostik di sana.  `GetManifest.Latency`selanjutnya dapat mengidentifikasi berapa lama waktu yang dibutuhkan MediaTailor untuk membuat manifes yang dipersonalisasi.  | 
| GetManifest.Latency | Mengukur jumlah waktu yang diperlukan MediaTailor untuk memproses permintaan dan membuat manifes yang dipersonalisasi untuk konfigurasi ini.  |  Saat Anda membandingkan `Origin.Age` dan `GetManifest.MediaTailorAge` dan menentukan bahwa MediaTailor penyebab pengiriman manifes tertunda, Anda dapat menganalisis `GetManifest.Latency` metrik untuk menentukan apakah proses personalisasi manifes berkontribusi pada kemacetan manifes.  `GetManifest.MediaTailorAge`mengukur total waktu penyimpanan manifes MediaTailor. `GetManifest.Latency`mengukur berapa banyak waktu penyimpanan yang MediaTailor mempersonalisasi manifes dalam menanggapi permintaan.  | 

# Merekam panggilan AWS Elemental MediaTailor API
<a name="logging-using-cloudtrail"></a>

AWS Elemental MediaTailor terintegrasi dengan AWS CloudTrail, layanan yang menyediakan catatan tindakan yang diambil oleh pengguna, peran, atau AWS layanan di MediaTailor. CloudTrail menangkap semua panggilan API untuk MediaTailor sebagai peristiwa. Panggilan yang diambil termasuk panggilan dari MediaTailor konsol dan panggilan kode ke operasi MediaTailor API. Jika Anda membuat jejak, Anda dapat mengaktifkan pengiriman CloudTrail acara secara berkelanjutan ke bucket Amazon S3, termasuk acara untuk. MediaTailor Jika Anda tidak mengonfigurasi jejak, Anda masih dapat melihat peristiwa terbaru di CloudTrail konsol dalam **Riwayat acara**. Dengan menggunakan informasi yang dikumpulkan oleh CloudTrail, Anda dapat menentukan permintaan yang dibuat MediaTailor, alamat IP dari mana permintaan dibuat, siapa yang membuat permintaan, kapan dibuat, dan detail tambahan. 

Untuk mempelajari selengkapnya CloudTrail, lihat [Panduan AWS CloudTrail Pengguna](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-user-guide.html).

## AWS Elemental MediaTailor informasi di CloudTrail
<a name="service-name-info-in-cloudtrail"></a>

CloudTrail diaktifkan di AWS akun Anda saat Anda membuat akun. Ketika aktivitas terjadi di AWS Elemental MediaTailor, aktivitas tersebut dicatat dalam suatu CloudTrail peristiwa bersama dengan peristiwa AWS layanan lainnya dalam **riwayat Acara**. Anda dapat melihat, mencari, dan mengunduh acara terbaru di AWS akun Anda. Untuk informasi selengkapnya, lihat [Melihat peristiwa dengan riwayat CloudTrail acara](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/view-cloudtrail-events.html). 

Untuk catatan peristiwa yang sedang berlangsung di AWS akun Anda, termasuk acara untuk AWS Elemental MediaTailor, buat jejak. *Jejak* memungkinkan CloudTrail untuk mengirimkan file log ke bucket Amazon S3. Secara default, saat Anda membuat jejak di konsol, jejak tersebut berlaku untuk semua AWS Wilayah. Jejak mencatat peristiwa dari semua Wilayah di AWS partisi dan mengirimkan file log ke bucket Amazon S3 yang Anda tentukan. Selain itu, Anda dapat mengonfigurasi AWS layanan lain untuk menganalisis lebih lanjut dan menindaklanjuti data peristiwa yang dikumpulkan dalam CloudTrail log. Untuk informasi selengkapnya, lihat berikut ini: 
+ [Membuat jejak untuk AWS akun Anda](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-create-and-update-a-trail.html)
+ [AWS integrasi layanan dengan log CloudTrail ](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-aws-service-specific-topics.html#cloudtrail-aws-service-specific-topics-integrations)
+ [Mengonfigurasi notifikasi Amazon SNS untuk CloudTrail](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/configure-sns-notifications-for-cloudtrail.html)
+ [Menerima file CloudTrail log dari beberapa wilayah](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/receive-cloudtrail-log-files-from-multiple-regions.html) dan [Menerima file CloudTrail log dari beberapa akun](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-receive-logs-from-multiple-accounts.html)

Semua AWS Elemental MediaTailor tindakan dicatat oleh CloudTrail dan didokumentasikan dalam [referensi AWS Elemental MediaTailor API](https://docs.aws.amazon.com/mediatailor/latest/apireference/Welcome.html). Misalnya, panggilan ke `PutPlaybackConfiguration` dan operasi `ListPlaybackConfigurations` membuat entri di file log CloudTrail. 

Setiap entri peristiwa atau log berisi informasi tentang entitas yang membuat permintaan tersebut. Informasi identitas membantu Anda menentukan hal berikut ini: 
+ Apakah permintaan dibuat dengan kredensi pengguna root atau AWS Identity and Access Management (IAM)
+ Baik permintaan tersebut dibuat dengan kredensial keamanan sementara untuk peran atau pengguna gabungan
+ Apakah permintaan itu dibuat oleh AWS layanan lain

Untuk informasi selengkapnya, lihat elemen [CloudTrail UserIdentity](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-event-reference-user-identity.html).

## Memahami entri file AWS Elemental MediaTailor log
<a name="understanding-service-name-entries"></a>

Trail adalah konfigurasi yang memungkinkan pengiriman peristiwa sebagai file log ke bucket Amazon S3 yang Anda tentukan. CloudTrail file log berisi satu atau lebih entri log. Sebuah kejadian mewakili permintaan tunggal dari sumber apa pun dan mencakup informasi tentang tindakan yang diminta, tanggal dan waktu tindakan, parameter permintaan, dan sebagainya. Berkas log CloudTrail bukan merupakan jejak tumpukan terurut dari panggilan API publik, sehingga tidak muncul dalam urutan tertentu. 

Contoh berikut menunjukkan entri CloudTrail log yang menunjukkan `PutPlaybackConfiguration` tindakan:

```
{
    "eventVersion": "1.05",
    "userIdentity": {
        "type": "IAMUser",
        "principalId": "AIDAEXAMPLE",
        "arn": "arn:aws:iam::111122223333:user/testuser",
        "accountId": "111122223333",
        "accessKeyId": "AIDAEXAMPLE",
        "userName": "testuser"
    },
    "eventTime": "2018-12-28T22:53:46Z",
    "eventSource": "mediatailor.amazonaws.com",
    "eventName": "PutPlaybackConfiguration",
    "awsRegion": "us-west-2",
    "sourceIPAddress": "1.2.3.4",
    "userAgent": "PostmanRuntime/7.4.0",
    "requestParameters": {
        "VideoContentSourceUrl": "http://examplevideo.com",
        "Name": "examplename",
        "AdDecisionServerUrl": "http://exampleads.com"
    },
    "responseElements": {
        "SessionInitializationEndpointPrefix": "https://777788889999.mediatailor.us-east-1.amazonaws.com/v1/session/AKIAIOSFODNN7EXAMPLE/examplename/",
        "DashConfiguration": {
            "ManifestEndpointPrefix": "https://777788889999.mediatailor.us-east-1.amazonaws.com/v1/dash/AKIAIOSFODNN7EXAMPLE/examplename/",
            "MpdLocation": "EMT_DEFAULT"
        },
        "AdDecisionServerUrl": "http://exampleads.com",
        "CdnConfiguration": {},
        "PlaybackEndpointPrefix": "https://777788889999.mediatailor.us-east-1.amazonaws.com",
        "HlsConfiguration": {
            "ManifestEndpointPrefix": "https://777788889999.mediatailor.us-east-1.amazonaws.com/v1/master/AKIAIOSFODNN7EXAMPLE/examplename/"
        },
        "VideoContentSourceUrl": "http://examplevideo.com",
        "Name": "examplename"
    },
    "requestID": "1a2b3c4d-1234-5678-1234-1a2b3c4d5e6f",
    "eventID": "987abc65-1a2b-3c4d-5d6e-987abc654def",
    "readOnly": false,
    "eventType": "AwsApiCall",
    "recipientAccountId": "111122223333"
}
```

Contoh berikut menunjukkan entri CloudTrail log yang menunjukkan `GetPlaybackConfiguration` tindakan:

```
{
    "eventVersion": "1.05",
    "userIdentity": {
        "type": "IAMUser",
        "principalId": "AIDAEXAMPLE",
        "arn": "arn:aws:iam::111122223333:user/testuser",
        "accountId": "111122223333",
        "accessKeyId": "AIDAEXAMPLE",
        "userName": "testuser"
    },
    "eventTime": "2018-12-28T22:52:37Z",
    "eventSource": "mediatailor.amazonaws.com",
    "eventName": "GetPlaybackConfiguration",
    "awsRegion": "us-west-2",
    "sourceIPAddress": "1.2.3.4",
    "userAgent": "PostmanRuntime/7.4.0",
    "requestParameters": {
        "Name": "examplename"
    },
    "responseElements": null,
    "requestID": "0z1y2x3w-0123-4567-9876-6q7r8s9t0u1v",
    "eventID": "888ddd77-3322-eeww-uuii-abc123jkl343",
    "readOnly": true,
    "eventType": "AwsApiCall",
    "recipientAccountId": "111122223333"
}
```

# Menerima peringatan perakitan AWS Elemental MediaTailor saluran
<a name="channel-assembly-alerts"></a>

MediaTailor membuat peringatan untuk masalah atau potensi masalah yang terjadi dengan sumber daya perakitan saluran Anda. Peringatan menjelaskan masalah, kapan masalah terjadi, dan sumber daya yang terpengaruh.

Anda dapat melihat peringatan di Konsol Manajemen AWS, the AWS Command Line Interface (AWS CLI) AWS SDKs, atau secara terprogram menggunakan API. MediaTailor [ListAlerts](https://docs.aws.amazon.com/mediatailor/latest/apireference/API_ListAlerts.html)

**penting**  
Peringatan hanya tersedia untuk sumber daya perakitan saluran yang dibuat pada atau setelah 14 Juli 2021.


**Peringatan Perakitan Saluran**  
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/mediatailor/latest/ug/channel-assembly-alerts.html)

## Memecahkan masalah peringatan terkait manifes
<a name="channel-assembly-troubleshooting-manifest-alerts"></a>

Saat Anda menemukan peringatan terkait manifes seperti`UNPARSABLE_MANIFEST`,, atau `VARIANT_DURATION_MISMATCH``TARGET_DURATION_MISMATCH`, periksa hal berikut:

1. **Verifikasi persyaratan sumber**: Pastikan konten Anda memenuhi persyaratan yang diuraikan. [Mengintegrasikan sumber konten untuk penyisipan MediaTailor iklan](integrating-origin.md)

1. **Periksa log manifes**: Untuk analisis kesalahan manifes terperinci dan jenis peristiwa, lihat[AWS Elemental MediaTailor deskripsi log manifes dan jenis acara](log-types.md).

1. **Periksa kode kesalahan**: Untuk analisis kesalahan terperinci, lihat[Pemecahan masalah MediaTailor](troubleshooting.md).

1. **Tinjau format manifes**: Verifikasi bahwa manifes Anda mengikuti spesifikasi format yang benar untuk protokol streaming Anda (HLS atau DASH).

## Melihat peringatan
<a name="channel-assembly-viewing-alerts-procedure"></a>

Anda dapat melihat peringatan untuk sumber daya perakitan MediaTailor saluran apa pun. Saat Anda melihat peringatan untuk saluran dan program, MediaTailor sertakan semua sumber daya terkait yang terdapat dalam saluran atau program. Misalnya, ketika Anda melihat peringatan untuk program tertentu, Anda juga melihat peringatan untuk lokasi sumber dan sumber VOD yang berisi program.

Untuk melihat peringatan, lakukan prosedur berikut.

------
#### [ Console ]

**Untuk melihat peringatan di konsol**

1. Buka MediaTailor konsol di [https://console.aws.amazon.com/mediatailor/](https://console.aws.amazon.com/mediatailor/).

1. Pilih sumber daya yang ingin Anda lihat lansiran.

1. Pilih tab **Alerts** untuk melihat lansiran.

------
#### [ AWS Command Line Interface (AWS CLI) ]

Untuk membuat daftar peringatan untuk sumber daya perakitan saluran, Anda memerlukan [Nama Sumber Daya Amazon (ARN) sumber daya](https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html) tersebut. Anda dapat menggunakan `describe-resource_type` perintah di AWS Command Line Interface (AWS CLI) untuk mendapatkan ARN sumber daya. Misalnya, jalankan [perintah deskripsikan saluran](https://docs.aws.amazon.com/cli/latest/reference/mediatailor/describe-channel.html) untuk mendapatkan ARN saluran tertentu:

```
aws mediatailor describe-channel --channel-name MyChannelName
```

Kemudian gunakan perintah [aws mediatailor list-alerts untuk membuat daftar peringatan yang](https://docs.aws.amazon.com/cli/latest/reference/mediatailor/list-alerts.html) terkait dengan sumber daya:

```
aws mediatailor list-alerts --resource-arn arn:aws:mediatailor:region:aws-account-id:resource-type/resource-name
```

------
#### [ API ]

Untuk membuat daftar peringatan untuk sumber daya perakitan saluran, Anda memerlukan [Nama Sumber Daya Amazon (ARN) sumber daya](https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html) tersebut. Anda dapat menggunakan `DescribeResource` operasi di MediaTailor API untuk mendapatkan ARN sumber daya. Misalnya, gunakan [DescribeChannel](https://docs.aws.amazon.com/mediatailor/latest/apireference/API_DescribeChannel.html)operasi untuk mendapatkan ARN saluran tertentu.

Kemudian gunakan [ListAlerts](https://docs.aws.amazon.com/mediatailor/latest/apireference/API_ListAlerts.html)API untuk membuat daftar peringatan untuk sumber daya.

------

## Menangani peringatan
<a name="channel-assembly-handling-alerts"></a>

Saat peringatan terjadi, lihat peringatan di Konsol Manajemen AWS, atau gunakan AWS Command Line Interface (AWS CLI) AWS SDKs, atau API MediaTailor Peringatan untuk menentukan kemungkinan sumber masalah.

Setelah Anda menyelesaikan masalah, MediaTailor hapus peringatan.

# Sumber daya penandaan AWS Elemental MediaTailor
<a name="tagging"></a>

*Tag* adalah label metadata yang Anda tetapkan atau yang ditetapkan ke sumber AWS daya. AWS Setiap tanda terdiri dari *kunci* dan *nilai*. Untuk tanda yang Anda tetapkan, Anda menentukan kunci dan nilai. Misalnya, Anda dapat menentukan kunci sebagai `stage` dan nilai untuk satu sumber daya sebagai `test`.

Tanda membantu Anda melakukan hal berikut:
+ Identifikasi dan atur AWS sumber daya Anda. Banyak AWS layanan mendukung penandaan, sehingga Anda dapat menetapkan tag yang sama ke sumber daya dari layanan yang berbeda untuk menunjukkan bahwa sumber daya terkait. Misalnya, Anda dapat menetapkan tag yang sama ke AWS Elemental MediaPackage saluran dan titik akhir yang Anda tetapkan ke konfigurasi. AWS Elemental MediaTailor 
+ Lacak AWS biaya Anda. Anda mengaktifkan tag ini di AWS Manajemen Penagihan dan Biaya dasbor. AWS menggunakan tag untuk mengkategorikan biaya Anda dan mengirimkan laporan alokasi biaya bulanan kepada Anda. Untuk informasi selengkapnya, lihat [Menggunakan tag alokasi biaya](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/cost-alloc-tags.html) di [Panduan AWS Billing Pengguna](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/).
+ Kontrol akses ke AWS sumber daya Anda. Untuk informasi selengkapnya, lihat [Mengontrol akses menggunakan tag](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_tags.html) di [Panduan Pengguna IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/introduction.html). 

Bagian berikut memberikan informasi lebih lanjut tentang tag untuk AWS Elemental MediaTailor.

## Sumber daya yang didukung di AWS Elemental MediaTailor
<a name="supported-resources"></a>

Sumber daya berikut dalam AWS Elemental MediaTailor mendukung penandaan:
+ Saluran
+ Konfigurasi
+ SourceLocations
+ VodSources

## Pembatasan tag
<a name="tagging-restrictions"></a>

Pembatasan dasar berikut berlaku untuk tag pada AWS Elemental MediaTailor sumber daya:
+ Jumlah tanda maksimum yang dapat Anda tetapkan ke sumber daya — 50 
+ Panjang kunci maksimum – 128 karakter Unicode 
+ Panjang nilai maksimum – 256 karakter Unicode 
+ Karakter yang valid untuk kunci dan nilai – a-z, A-Z, 0-9, spasi, dan karakter berikut: \$1 . : / = \$1 - dan @
+ Kunci dan nilai tanda peka huruf besar-kecil
+ Jangan gunakan `aws:` sebagai awalan untuk kunci; itu dicadangkan untuk penggunaan AWS

## Mengelola tag di AWS Elemental MediaTailor
<a name="tagging-add-edit-delete"></a>

Anda mengatur tag sebagai Properti di sumber daya. Anda dapat menambahkan, mengedit, dan menghapus tag melalui AWS Elemental MediaTailor API atau AWS Command Line Interface (AWS CLI). Untuk informasi selengkapnya, lihat [referensi AWS Elemental MediaTailor API](https://docs.aws.amazon.com/mediatailor/latest/apireference/Welcome.html).

# Memantau layanan AWS media dengan monitor alur kerja
<a name="monitor-with-workflow-monitor"></a>

Monitor alur kerja adalah alat untuk penemuan, visualisasi, dan pemantauan alur kerja AWS media. Monitor alur kerja tersedia di AWS konsol dan API. *Anda dapat menggunakan monitor alur kerja untuk menemukan dan membuat pemetaan visual sumber daya alur kerja Anda, yang disebut peta sinyal.* Anda dapat membuat dan mengelola CloudWatch alarm Amazon dan template EventBridge aturan Amazon untuk memantau sumber daya yang dipetakan. Templat pemantauan yang Anda buat diubah menjadi AWS CloudFormation templat yang dapat diterapkan untuk memungkinkan pengulangan. AWS template alarm yang direkomendasikan menyediakan pemantauan praktik terbaik yang telah ditentukan sebelumnya. 

 **Temukan**

Manfaatkan peta sinyal untuk secara otomatis menemukan AWS sumber daya yang saling berhubungan yang terkait dengan alur kerja media Anda. Penemuan dapat dimulai di sumber daya layanan apa pun yang didukung dan membuat end-to-end pemetaan alur kerja. Peta sinyal dapat digunakan sebagai alat visualisasi yang berdiri sendiri atau ditingkatkan dengan templat pemantauan.

![\[Alur kerja memantau komponen penemuan.\]](http://docs.aws.amazon.com/id_id/mediatailor/latest/ug/images/workflowmonitor-discovery.png)


**Monitor**

Anda dapat membuat templat CloudWatch alarm dan EventBridge aturan khusus untuk memantau kesehatan dan status alur kerja media Anda. Templat alarm praktik terbaik tersedia untuk diimpor ke lingkungan monitor alur kerja Anda. Anda dapat menggunakan templat alarm praktik terbaik apa adanya, atau mengeditnya agar lebih sesuai dengan alur kerja Anda. Template apa pun yang Anda buat diubah menjadi CloudFormation template untuk penerapan berulang.

![\[Komponen pemantauan monitor alur kerja.\]](http://docs.aws.amazon.com/id_id/mediatailor/latest/ug/images/workflowmonitor-monitoring.png)


**catatan**  
Tidak ada biaya langsung untuk menggunakan monitor alur kerja. Namun, ada biaya yang terkait dengan sumber daya yang dibuat dan digunakan untuk memantau alur kerja Anda.  
Saat pemantauan diterapkan, EventBridge sumber daya Amazon CloudWatch dan Amazon dibuat. Saat menggunakan Konsol AWS Manajemen, sebelum menerapkan pemantauan ke peta sinyal, Anda akan diberi tahu berapa banyak sumber daya yang akan dibuat. Untuk informasi lebih lanjut tentang harga, lihat: [CloudWatchharga](https://aws.amazon.com/cloudwatch/pricing/) dan [EventBridge harga](https://aws.amazon.com/eventbridge/pricing/).  
Monitor alur kerja menggunakan AWS CloudFormation templat untuk menyebarkan CloudWatch dan EventBridge sumber daya. Template ini disimpan dalam bucket Amazon Simple Storage Service kelas standar yang dibuat atas nama Anda, oleh monitor alur kerja, selama proses penerapan dan akan dikenakan biaya penyimpanan dan penarikan objek. Untuk informasi selengkapnya tentang harga, lihat: Harga [Amazon S3](https://aws.amazon.com/s3/pricing/).   
Pratinjau yang dihasilkan di peta sinyal monitor alur kerja untuk AWS Elemental MediaPackage saluran dikirim dari Titik Akhir MediaPackage Asal dan akan dikenakan biaya Transfer Keluar Data. Untuk harga, lihat: [MediaPackageharga](https://aws.amazon.com/mediapackage/pricing/).

## Komponen monitor alur kerja
<a name="monitor-with-workflow-monitor-components"></a>

Monitor alur kerja memiliki empat komponen utama:
+ CloudWatch template alarm - Tentukan kondisi yang ingin Anda pantau menggunakan CloudWatch. Anda dapat membuat templat alarm Anda sendiri, atau mengimpor templat yang telah ditentukan sebelumnya yang dibuat oleh AWS. Untuk informasi lebih lanjut, lihat: [CloudWatch grup alarm dan template untuk memantau alur kerja AWS media Anda](monitor-with-workflow-monitor-configure-alarms.md)
+ EventBridge template aturan - Tentukan cara EventBridge mengirim pemberitahuan saat alarm dipicu. Untuk informasi lebih lanjut, lihat: [EventBridge grup aturan dan templat untuk memantau alur kerja AWS media Anda](monitor-with-workflow-monitor-configure-notifications.md)
+ Peta sinyal - Gunakan proses otomatis untuk membuat peta alur kerja AWS Elemental menggunakan sumber daya yang ada AWS . Peta sinyal dapat digunakan untuk menemukan sumber daya dalam alur kerja Anda dan menerapkan pemantauan ke sumber daya tersebut. Untuk informasi lebih lanjut, lihat: [Peta sinyal monitor alur kerja](monitor-with-workflow-monitor-configure-signal-maps.md)
+ Ikhtisar - Halaman ikhtisar memungkinkan Anda untuk secara langsung memantau status beberapa peta sinyal dari satu lokasi. Tinjau metrik, log, dan alarm untuk alur kerja Anda. Untuk informasi lebih lanjut, lihat: [Ikhtisar monitor alur kerja](monitor-with-workflow-monitor-operate-overview.md)

## Layanan yang didukung
<a name="monitor-with-workflow-monitor-supported-services"></a>

Monitor alur kerja mendukung penemuan otomatis dan pemetaan sinyal sumber daya yang terkait dengan layanan berikut: 
+ AWS Elemental MediaConnect
+ AWS Elemental MediaLive
+ AWS Elemental MediaPackage
+ AWS Elemental MediaTailor
+ Amazon S3
+ Amazon CloudFront

**Topics**
+ [Komponen monitor alur kerja](#monitor-with-workflow-monitor-components)
+ [Layanan yang didukung](#monitor-with-workflow-monitor-supported-services)
+ [Mengkonfigurasi monitor alur kerja untuk memantau layanan media AWS](monitor-with-workflow-monitor-configure.md)
+ [Menggunakan monitor alur kerja](monitor-with-workflow-monitor-operate.md)

# Mengkonfigurasi monitor alur kerja untuk memantau layanan media AWS
<a name="monitor-with-workflow-monitor-configure"></a>

Untuk mengatur monitor alur kerja untuk pertama kalinya; Anda membuat template alarm dan acara, dan menemukan peta sinyal yang digunakan untuk memantau alur kerja media Anda. Panduan berikut berisi langkah-langkah yang diperlukan untuk mengatur peran IAM tingkat Administrator dan Operator, membuat sumber daya monitor alur kerja, dan menerapkan pemantauan ke alur kerja Anda. 

**Topics**
+ [Memulai dengan monitor alur kerja](monitor-with-workflow-monitor-configure-getting-started.md)
+ [Grup dan templat monitor alur kerja](monitor-with-workflow-monitor-configure-templates.md)
+ [Peta sinyal monitor alur kerja](monitor-with-workflow-monitor-configure-signal-maps.md)
+ [Kuota monitor alur kerja](monitor-with-workflow-monitor-configure-quotas.md)

# Memulai dengan monitor alur kerja
<a name="monitor-with-workflow-monitor-configure-getting-started"></a>

Langkah-langkah berikut memberikan ikhtisar dasar menggunakan monitor alur kerja untuk pertama kalinya. 

1. Pengaturan alur kerja memantau izin IAM untuk peran tingkat administrator dan operator: [Alur kerja memantau kebijakan IAM](monitor-with-workflow-monitor-configure-getting-started-IAM.md) 

1. Membangun template alarm atau mengimpor template standar yang dibuat oleh AWS: [Alarm CloudWatch](monitor-with-workflow-monitor-configure-alarms.md)

1. Buat acara notifikasi yang akan dikirimkan oleh EventBridge: [EventBridge aturan ](monitor-with-workflow-monitor-configure-notifications.md)

1. Temukan peta sinyal menggunakan sumber daya AWS Elemental yang ada: [Peta sinyal ](monitor-with-workflow-monitor-configure-signal-maps.md)

1. Lampirkan templat alarm dan aturan notifikasi ke peta sinyal Anda: [Melampirkan template](monitor-with-workflow-monitor-configure-signal-maps-attach.md)

1. Terapkan templat untuk mulai memantau peta sinyal: [Menerapkan templat pemantauan](monitor-with-workflow-monitor-configure-deploy.md)

1. Pantau dan tinjau sumber daya monitor alur kerja Anda menggunakan bagian ikhtisar AWS konsol: [Ikhtisar](monitor-with-workflow-monitor-operate-overview.md)

![\[Langkah-langkah individual menyiapkan monitor alur kerja. Mulailah dengan membuat peran IAM. Selanjutnya, buat template untuk alarm dan acara. Selanjutnya, temukan peta sinyal dan lampirkan templat Anda ke peta. Setelah peta sinyal memiliki templat yang dilampirkan, templat harus digunakan. Langkah terakhir adalah pemantauan menggunakan template dan sumber daya ikhtisar.\]](http://docs.aws.amazon.com/id_id/mediatailor/latest/ug/images/workflowmonitor-overview-steps.png)


# Alur kerja memantau kebijakan IAM
<a name="monitor-with-workflow-monitor-configure-getting-started-IAM"></a>

 Monitor alur kerja berinteraksi dengan beberapa AWS layanan untuk membuat peta sinyal, membangun CloudWatch dan EventBridge sumber daya, dan CloudFormation templat. Karena monitor alur kerja berinteraksi dengan berbagai layanan, kebijakan spesifik AWS Identity and Access Management (IAM) harus ditetapkan untuk layanan ini. Contoh berikut menunjukkan kebijakan IAM yang diperlukan untuk peran IAM administrator dan operator.

## Kebijakan IAM Administrator
<a name="monitor-with-workflow-monitor-configure-getting-started-IAM-administrator"></a>

Contoh kebijakan berikut adalah untuk kebijakan IAM monitor alur kerja tingkat administrator. Peran ini memungkinkan pembuatan dan pengelolaan sumber daya monitor alur kerja dan sumber daya layanan yang didukung yang berinteraksi dengan monitor alur kerja. 

------
#### [ JSON ]

****  

```
{
  
  "Version":"2012-10-17",		 	 	 
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "cloudwatch:List*",
        "cloudwatch:Describe*",
        "cloudwatch:Get*",
        "cloudwatch:PutAnomalyDetector",
        "cloudwatch:PutMetricData",
        "cloudwatch:PutMetricAlarm",
        "cloudwatch:PutCompositeAlarm",
        "cloudwatch:PutDashboard",
        "cloudwatch:DeleteAlarms",
        "cloudwatch:DeleteAnomalyDetector",
        "cloudwatch:DeleteDashboards",
        "cloudwatch:TagResource",
        "cloudwatch:UntagResource"
      ],
      "Resource": "*"
    },
    {
      "Effect": "Allow",
      "Action": [
        "cloudformation:List*",
        "cloudformation:Describe*",
        "cloudformation:CreateStack",
        "cloudformation:UpdateStack",
        "cloudformation:DeleteStack",
        "cloudformation:TagResource",
        "cloudformation:UntagResource"
      ],
      "Resource": "*"
    },
    {
      "Effect": "Allow",
      "Action": [
        "cloudfront:List*",
        "cloudfront:Get*"
      ],
      "Resource": "*"
    },
    {
      "Effect": "Allow",
      "Action": [
        "ec2:DescribeNetworkInterfaces"
      ],
      "Resource": "*"
    },
    {
      "Effect": "Allow",
      "Action": [
        "events:List*",
        "events:Describe*",
        "events:CreateEventBus",
        "events:PutRule",
        "events:PutTargets",
        "events:EnableRule",
        "events:DisableRule",
        "events:DeleteRule",
        "events:RemoveTargets",
        "events:TagResource",
        "events:UntagResource"
      ],
      "Resource": "*"
    },
    {
      "Effect": "Allow",
      "Action": [
        "logs:Describe*",
        "logs:Get*",
        "logs:TagLogGroup",
        "logs:TagResource",
        "logs:UntagLogGroup",
        "logs:UntagResource"
      ],
      "Resource": "*"
    },
    {
      "Effect": "Allow",
      "Action": [
        "mediaconnect:List*",
        "mediaconnect:Describe*"
      ],
      "Resource": "*"
    },
    {
      "Effect": "Allow",
      "Action": [
        "medialive:*"
      ],
      "Resource": "*"
    },
    {
      "Effect": "Allow",
      "Action": [
        "mediapackage:List*",
        "mediapackage:Describe*"
      ],
      "Resource": "*"
    },
    {
      "Effect": "Allow",
      "Action": [
        "mediapackagev2:List*",
        "mediapackagev2:Get*"
      ],
      "Resource": "*"
    },
    {
      "Effect": "Allow",
      "Action": [
        "mediapackage-vod:List*",
        "mediapackage-vod:Describe*"
      ],
      "Resource": "*"
    },
    {
      "Effect": "Allow",
      "Action": [
        "mediatailor:List*",
        "mediatailor:Describe*",
        "mediatailor:Get*"
      ],
      "Resource": "*"
    },
    {
      "Effect": "Allow",
      "Action": [
        "resource-groups:ListGroups",
        "resource-groups:GetGroup",
        "resource-groups:GetTags",
        "resource-groups:GetGroupQuery",
        "resource-groups:GetGroupConfiguration",
        "resource-groups:CreateGroup",
        "resource-groups:UngroupResources",
        "resource-groups:GroupResources",
        "resource-groups:DeleteGroup",
        "resource-groups:UpdateGroupQuery",
        "resource-groups:UpdateGroup",
        "resource-groups:Tag",
        "resource-groups:Untag"
      ],
      "Resource": "*"
    },
    {
      "Effect": "Allow",
      "Action": [
        "s3:*"
      ],
      "Resource": "arn:aws:s3:::workflow-monitor-templates*"
    },
    {
      "Effect": "Allow",
      "Action": [
        "sns:TagResource",
        "sns:UntagResource"
      ],
      "Resource": "*"
    },
    {
      "Effect": "Allow",
      "Action": [
        "tag:Get*",
        "tag:Describe*",
        "tag:TagResources",
        "tag:UntagResources"
      ],
      "Resource": "*"
    }
  ]
}
```

------

## Kebijakan IAM operator
<a name="monitor-with-workflow-monitor-configure-getting-started-IAM-operator"></a>

Contoh kebijakan berikut adalah untuk kebijakan IAM monitor alur kerja tingkat operator. Peran ini memungkinkan akses terbatas dan hanya-baca ke sumber daya monitor alur kerja dan sumber daya layanan yang didukung yang berinteraksi dengan monitor alur kerja.

------
#### [ JSON ]

****  

```
{
  "Version":"2012-10-17",		 	 	 
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "cloudwatch:List*",
        "cloudwatch:Describe*",
        "cloudwatch:Get*"
      ],
      "Resource": "*"
    },
    {
      "Effect": "Allow",
      "Action": [
        "cloudformation:List*",
        "cloudformation:Describe*"
      ],
      "Resource": "*"
    },
    {
      "Effect": "Allow",
      "Action": [
        "cloudfront:List*",
        "cloudfront:Get*"
      ],
      "Resource": "*"
    },
    {
      "Effect": "Allow",
      "Action": [
        "ec2:DescribeNetworkInterfaces"
      ],
      "Resource": "*"
    },
    {
      "Effect": "Allow",
      "Action": [
        "events:List*",
        "events:Describe*"
      ],
      "Resource": "*"
    },
    {
      "Effect": "Allow",
      "Action": [
        "logs:Describe*",
        "logs:Get*"
      ],
      "Resource": "*"
    },
    {
      "Effect": "Allow",
      "Action": [
        "mediaconnect:List*",
        "mediaconnect:Describe*"
      ],
      "Resource": "*"
    },
    {
      "Effect": "Allow",
      "Action": [
        "medialive:List*",
        "medialive:Get*",
        "medialive:Describe*"
      ],
      "Resource": "*"
    },
    {
      "Effect": "Allow",
      "Action": [
        "mediapackage:List*",
        "mediapackage:Describe*"
      ],
      "Resource": "*"
    },
    {
      "Effect": "Allow",
      "Action": [
        "mediapackagev2:List*",
        "mediapackagev2:Get*"
      ],
      "Resource": "*"
    },
    {
      "Effect": "Allow",
      "Action": [
        "mediapackage-vod:List*",
        "mediapackage-vod:Describe*"
      ],
      "Resource": "*"
    },
    {
      "Effect": "Allow",
      "Action": [
        "mediatailor:List*",
        "mediatailor:Describe*",
        "mediatailor:Get*"
      ],
      "Resource": "*"
    },
    {
      "Effect": "Allow",
      "Action": [
        "s3:Get*",
        "s3:List*"
      ],
      "Resource": "arn:aws:s3:::workflow-monitor-templates*"
    },
    {
      "Effect": "Allow",
      "Action": [
        "tag:Get*",
        "tag:Describe*"
      ],
      "Resource": "*"
    }
  ]
}
```

------

# Grup dan templat monitor alur kerja
<a name="monitor-with-workflow-monitor-configure-templates"></a>

Sebelum Anda dapat menerapkan pemantauan alur kerja ke peta sinyal, Anda harus membuat grup dan templat untuk CloudWatch alarm dan notifikasi. EventBridge CloudWatch Template menentukan skenario dan ambang batas apa yang akan digunakan untuk memicu alarm. EventBridge Template akan menentukan bagaimana alarm ini dilaporkan kepada Anda. 

Jika Anda hanya ingin pemetaan sumber daya yang terhubung dan tidak ingin menggunakan kemampuan template pemantauan monitor alur kerja, peta sinyal dapat digunakan tanpa CloudWatch dan template. EventBridge Untuk informasi selengkapnya tentang penggunaan peta sinyal, lihat: [Peta sinyal ](monitor-with-workflow-monitor-configure-signal-maps.md)

**Topics**
+ [CloudWatch grup alarm dan template untuk memantau alur kerja AWS media Anda](monitor-with-workflow-monitor-configure-alarms.md)
+ [EventBridge grup aturan dan templat untuk memantau alur kerja AWS media Anda](monitor-with-workflow-monitor-configure-notifications.md)

# CloudWatch grup alarm dan template untuk memantau alur kerja AWS media Anda
<a name="monitor-with-workflow-monitor-configure-alarms"></a>

Alarm monitor alur kerja memungkinkan Anda menggunakan CloudWatch metrik yang ada sebagai dasar alarm untuk peta sinyal Anda. Anda dapat membuat grup template alarm untuk mengurutkan dan mengklasifikasikan jenis alarm yang penting bagi alur kerja Anda. Dalam setiap grup template alarm, Anda membuat template alarm dengan CloudWatch metrik dan parameter tertentu yang ingin Anda pantau. Anda dapat membuat templat alarm Anda sendiri atau mengimpor templat alarm yang direkomendasikan yang dibuat oleh AWS. Setelah membuat grup templat alarm dan templat alarm dalam grup itu, Anda dapat melampirkan satu atau beberapa grup templat alarm ini ke peta sinyal.

 Anda harus membuat grup template alarm terlebih dahulu. Setelah Anda membuat grup templat alarm, Anda dapat membuat templat sendiri atau menggunakan templat yang direkomendasikan yang dibuat oleh AWS. Jika Anda ingin membuat templat alarm Anda sendiri, lanjutkan di halaman ini. Untuk informasi selengkapnya tentang mengimpor templat yang direkomendasikan, lihat: [Template yang direkomendasikan](monitor-with-workflow-monitor-configure-alarms-recommended-templates.md) 

Bagian ini mencakup pembuatan CloudWatch alarm menggunakan monitor alur kerja. Untuk informasi selengkapnya tentang cara CloudWatch layanan menangani alarm dan detail komponen alarm, lihat: [Menggunakan CloudWatch alarm](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/AlarmThatSendsEmail.html) di Panduan Pengguna *Amazon CloudWatch * 

## Membuat grup template alarm
<a name="monitor-with-workflow-monitor-alarms-groups-create"></a>

Grup template alarm memungkinkan Anda untuk mengurutkan dan mengklasifikasikan jenis alarm yang penting untuk alur kerja Anda.

**Untuk membuat grup template alarm**

1. Dari panel navigasi konsol monitor alur kerja, pilih templat **CloudWatchalarm**.

1. Pilih **Buat grup templat alarm**.

1. Berikan grup template alarm **nama Grup** yang unik dan **Deskripsi** opsional.

1. Pilih **Buat**, Anda akan dibawa ke halaman detail grup template alarm yang baru dibuat.

## Membuat template alarm
<a name="monitor-with-workflow-monitor-configure-alarms-templates-create"></a>

Anda dapat membuat template alarm dengan CloudWatch metrik dan parameter yang ingin Anda pantau.

**Untuk membuat template alarm**

1. Dari halaman detail grup templat alarm, pilih **Buat templat alarm**.

1. Berikan template alarm **nama Template** yang unik dan **Deskripsi** opsional.

1. Di bagian **Pilih metrik**:

   1. Pilih **Jenis Sumber Daya Target**. Jenis sumber daya target adalah sumber daya untuk layanan masing-masing, seperti saluran untuk MediaLive dan MediaPackage atau aliran untuk MediaConnect.

   1. Pilih **Nama Metrik**. Ini adalah CloudWatch metrik yang bertindak sebagai dasar untuk alarm. Daftar metrik akan berubah tergantung pada **Jenis Sumber Daya Target** yang dipilih.

1. Di bagian **Pengaturan alarm**: 
**catatan**  
Untuk informasi selengkapnya tentang cara CloudWatch layanan menangani alarm dan detail komponen alarm, lihat: [Menggunakan CloudWatch alarm](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/AlarmThatSendsEmail.html) di Panduan Pengguna *Amazon CloudWatch *

   1. Pilih **Statistiknya**. Ini adalah nilai seperti **Jumlah** atau **Rata-rata** yang akan digunakan untuk memantau metrik.

   1. Pilih **Operator Perbandingan**. Bidang ini mereferensikan **Ambang batas** yang Anda tetapkan pada langkah berikutnya. 

   1. Tetapkan **Ambang Batas**. Ini adalah nilai numerik yang digunakan **Operator Perbandingan** untuk menentukan lebih besar dari, kurang dari, atau sama dengan status.

   1. Tetapkan **Periode**. Ini adalah nilai waktu, dalam hitungan detik. **Periode** adalah lamanya waktu **Statistik**, **Operator Perbandingan**, dan **Ambang Batas** berinteraksi untuk menentukan apakah alarm dipicu.

   1. Mengatur **Datapoints**. Nilai ini menentukan berapa banyak titik data yang diperlukan untuk memicu alarm.

   1. Pilih Cara **Mengobati Data yang Hilang**. Pilihan ini menentukan bagaimana alarm ini bereaksi terhadap data yang hilang.

1. Pilih **Buat** untuk menyelesaikan proses. 

Contoh template alarm yang sudah selesai dapat memiliki parameter berikut: **Jenis Sumber Daya Target MediaConnect ** aliran dipantau untuk Nama **Metrik** Pemutusan. Nilai **Statistik** diatur ke Jumlah dengan **Operator Perbandingan** “lebih besar dari atau sama dengan” dan **Ambang** 10. **Periode** diatur ke 60 detik, dan hanya membutuhkan 1 dari 1 **Datapoint**. **Perlakukan Data yang Hilang** diatur ke “abaikan.” 

Hasil dari pengaturan ini adalah: monitor alur kerja akan memantau pemutusan pada aliran. Jika 10 atau lebih pemutusan terjadi dalam 60 detik, alarm akan dipicu. 10 atau lebih pemutusan dalam 60 detik hanya perlu terjadi satu kali agar alarm dipicu. 

# Templat alarm yang direkomendasikan untuk memantau alur kerja AWS media Anda
<a name="monitor-with-workflow-monitor-configure-alarms-recommended-templates"></a>

Templat yang direkomendasikan monitor alur kerja adalah pilihan metrik layanan AWS Elemental yang dikuratori dengan pengaturan alarm yang telah ditentukan yang sesuai untuk metrik. Jika Anda tidak ingin membuat templat alarm yang disesuaikan, templat yang direkomendasikan memberi Anda templat pemantauan praktik terbaik yang dibuat oleh AWS.

Monitor alur kerja berisi grup templat yang direkomendasikan untuk setiap layanan yang didukung. Kelompok-kelompok ini dirancang untuk menerapkan pemantauan praktik terbaik untuk jenis alur kerja tertentu. Setiap grup template berisi pilihan alarm yang dikuratori yang dikonfigurasi dari metrik khusus layanan. Misalnya, grup template yang direkomendasikan untuk alur kerja MediaLive multipleks akan memiliki kumpulan metrik yang telah dikonfigurasi sebelumnya yang berbeda dari alur kerja CDI. MediaConnect 

**Untuk menggunakan template alarm yang direkomendasikan**

1. Ikuti langkah-langkah untuk [membuat grup templat alarm](monitor-with-workflow-monitor-configure-alarms.md#monitor-with-workflow-monitor-alarms-groups-create), atau pilih yang sudah ada.

1. Di bagian **Template alarm**, pilih **Impor**. Anda perlu mengimpor template yang AWS direkomendasikan ke dalam grup template Anda.

1. Gunakan dropdown **grup templat CloudWatch alarm** untuk memilih grup yang AWS direkomendasikan. Kelompok-kelompok ini berisi alarm yang dikuratori untuk layanan tertentu.

1. Pilih templat yang akan diimpor menggunakan kotak centang. Setiap template akan mencantumkan metriknya, nilai pemantauan yang telah dikonfigurasi sebelumnya, dan memberikan deskripsi metrik. Setelah selesai memilih template, pilih tombol **Add**.

1. Template yang dipilih akan pindah ke **template Alarm untuk mengimpor** bagian. Tinjau pilihan Anda dan pilih **Impor**.

1. Setelah impor selesai, template yang dipilih akan ditambahkan ke grup template. Jika Anda ingin menambahkan lebih banyak templat, ulangi proses impor.

1. Template yang diimpor dapat disesuaikan setelah impor. Pengaturan alarm dapat dimodifikasi agar sesuai dengan kebutuhan Anda yang mengkhawatirkan. 

    

# EventBridge grup aturan dan templat untuk memantau alur kerja AWS media Anda
<a name="monitor-with-workflow-monitor-configure-notifications"></a>

CloudWatch menggunakan EventBridge aturan Amazon untuk mengirim pemberitahuan. Anda mulai dengan membuat grup template acara. Dalam grup templat acara tersebut, Anda membuat templat acara yang menentukan kondisi apa yang membuat notifikasi dan siapa yang diberi tahu.

Bagian ini mencakup pembuatan EventBridge aturan menggunakan monitor alur kerja. Untuk informasi selengkapnya tentang cara EventBridge layanan menggunakan aturan, lihat: [EventBridge aturan](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-rules.html) di *Panduan EventBridge Pengguna Amazon*

## Membuat grup template acara
<a name="monitor-with-workflow-monitor-configure-notifications-group-create"></a>

Grup template acara memungkinkan Anda untuk mengurutkan dan mengklasifikasikan peristiwa berdasarkan kasus penggunaan Anda.

**Untuk membuat grup template acara**

1. Dari panel navigasi konsol monitor alur kerja, pilih templat **EventBridge aturan**.

1. Pilih **Buat grup templat acara**.

1. Berikan grup template alarm **nama Grup** yang unik dan **Deskripsi** opsional.

1. Pilih **Buat**, Anda akan dibawa ke halaman detail grup template alarm yang baru dibuat.

## Membuat template acara
<a name="monitor-with-workflow-monitor-configure-notifications-template-create"></a>

 Anda dapat mengirim notifikasi berdasarkan template acara yang Anda buat.

**Untuk membuat template acara**

1. Dari halaman detail grup templat acara, pilih **Buat templat acara**.

1. Berikan template acara **nama Template** yang unik dan **Deskripsi** opsional.

1. Di bagian **Pengaturan aturan**:

   1. Pilih **jenis Acara**. Saat memilih jenis acara, Anda dapat memilih di antara beberapa peristiwa yang dibuat oleh AWS atau memilih **Alarm aktif peta sinyal** untuk menggunakan alarm yang dibuat oleh templat alarm.

   1. Pilih **layanan Target**. Ini menentukan bagaimana Anda ingin diberitahu tentang acara ini. Anda dapat memilih Amazon Simple Notification Service atau CloudWatch log.

   1. Setelah memilih layanan target, pilih **Target**. Ini akan menjadi topik Amazon SNS atau grup CloudWatch log, tergantung pada pilihan layanan target Anda. 

1. Pilih **Buat** untuk menyelesaikan proses. 

# Peta sinyal monitor alur kerja
<a name="monitor-with-workflow-monitor-configure-signal-maps"></a>

Peta sinyal adalah pemetaan visual AWS sumber daya dalam alur kerja media Anda. Anda dapat menggunakan monitor alur kerja untuk memulai penemuan peta sinyal pada salah satu jenis sumber daya yang didukung. Selama proses penemuan, monitor alur kerja akan secara otomatis dan rekursif memetakan semua sumber daya yang terhubung AWS . Setelah peta sinyal dibuat, Anda dapat menggunakan konsol monitor alur kerja untuk melakukan hal-hal seperti menerapkan templat pemantauan, melihat metrik, dan melihat detail sumber daya yang dipetakan.

**Topics**
+ [Membuat peta sinyal untuk alur kerja AWS media](monitor-with-workflow-monitor-configure-signal-maps-create.md)
+ [Melihat peta sinyal alur kerja AWS media](monitor-with-workflow-monitor-configure-signal-maps-view.md)
+ [Melampirkan template alarm dan acara ke peta sinyal alur kerja AWS media Anda](monitor-with-workflow-monitor-configure-signal-maps-attach.md)
+ [Menyebarkan template ke peta sinyal alur kerja AWS media Anda](monitor-with-workflow-monitor-configure-deploy.md)
+ [Memperbarui peta sinyal alur kerja AWS media Anda](monitor-with-workflow-monitor-configure-signal-maps-update.md)
+ [Menghapus peta sinyal alur kerja AWS media Anda](monitor-with-workflow-monitor-configure-signal-maps-delete.md)

# Membuat peta sinyal untuk alur kerja AWS media
<a name="monitor-with-workflow-monitor-configure-signal-maps-create"></a>

Anda dapat menggunakan peta sinyal monitor alur kerja untuk membuat pemetaan visual dari semua AWS sumber daya yang terhubung dalam alur kerja media Anda. 

**Untuk membuat peta sinyal**

1. Dari panel navigasi konsol monitor alur kerja, pilih Peta **sinyal**.

1. Pilih **Buat peta sinyal**.

1. Berikan peta sinyal **Nama** dan **Deskripsi**.

1. Di bagian **Temukan peta sinyal baru**, sumber daya di akun saat ini dan wilayah yang dipilih ditampilkan. Pilih sumber daya untuk memulai penemuan peta sinyal. Sumber daya yang dipilih akan menjadi titik awal untuk penemuan.

1. Pilih **Buat**. Biarkan beberapa saat agar proses penemuan selesai. Setelah proses selesai, Anda akan disajikan dengan peta sinyal baru.
**catatan**  
Pratinjau yang dihasilkan di peta sinyal monitor alur kerja untuk AWS Elemental MediaPackage saluran dikirim dari Titik Akhir MediaPackage Asal dan akan dikenakan biaya Transfer Keluar Data. Untuk harga, lihat: [MediaPackageharga](https://aws.amazon.com/mediapackage/pricing/).

# Melihat peta sinyal alur kerja AWS media
<a name="monitor-with-workflow-monitor-configure-signal-maps-view"></a>

Peta sinyal monitor alur kerja memungkinkan Anda melihat pemetaan visual dari semua AWS sumber daya yang terhubung dalam alur kerja media Anda. 

**Tampilan peta sinyal**

Setelah memilih peta sinyal, Anda memiliki dua tampilan yang dapat digunakan untuk memantau atau mengkonfigurasi peta sinyal. **Monitor peta sinyal** dan **Konfigurasi peta sinyal** adalah tombol peka konteks yang ditemukan di kanan atas bagian konsol peta sinyal.

Jika Anda memilih peta sinyal menggunakan bagian **Peta sinyal** pada panel navigasi, peta sinyal Anda akan ditampilkan dalam tampilan konfigurasi. Tampilan konfigurasi memungkinkan Anda membuat perubahan pada grup templat yang dilampirkan ke peta sinyal ini, menyebarkan templat terlampir, dan melihat detail dasar dan tag peta sinyal.

Jika Anda memilih peta sinyal menggunakan bagian **Ikhtisar** panel navigasi, peta sinyal Anda akan ditampilkan dalam tampilan pemantauan. Tampilan pemantauan menampilkan CloudWatch alarm, EventBridge aturan, peringatan, log, dan metrik untuk peta sinyal ini. 

Tampilan dapat diubah kapan saja dengan memilih tombol **Monitor/Konfigurasi peta sinyal** di kanan atas. Tampilan konfigurasi memerlukan izin IAM tingkat administrator. Izin IAM yang diperlukan dapat dilihat di sini: [Alur kerja memantau kebijakan IAM](monitor-with-workflow-monitor-configure-getting-started-IAM.md) 

**Menavigasi peta sinyal**

Peta sinyal akan berisi node untuk setiap sumber daya AWS yang didukung yang ditemukan oleh monitor alur kerja. Sumber daya tertentu, seperti MediaLive saluran dan MediaPackage titik akhir dapat menampilkan pratinjau thumbnail konten, jika pratinjau thumbnail tersedia.

Memilih simpul sumber daya, dan memilih **Lihat detail sumber daya yang dipilih** dari menu tarik-turun **Tindakan** akan membawa Anda ke halaman detail layanan terkait. Misalnya, memilih MediaLive saluran dan memilih **Lihat detail sumber daya yang dipilih** akan membuka halaman detail MediaLive konsol untuk saluran tersebut. 

Memilih node sumber daya akan memfilter daftar alarm aktif hanya untuk node itu. Jika Anda memilih **ARN Target** sumber daya di alarm aktif, Anda akan dibawa ke halaman detail layanan terkait, dengan sumber daya yang dipilih terbuka.

# Melampirkan template alarm dan acara ke peta sinyal alur kerja AWS media Anda
<a name="monitor-with-workflow-monitor-configure-signal-maps-attach"></a>

Setelah Anda membuat template alarm dan acara, Anda harus melampirkannya ke peta sinyal. Template alarm dan acara apa pun yang telah Anda buat dapat dilampirkan ke peta sinyal yang ditemukan. 

**Untuk melampirkan template alarm dan acara ke peta sinyal Anda**

1. Dari panel navigasi konsol monitor alur kerja, pilih **Peta sinyal** dan pilih peta sinyal yang ingin Anda gunakan.

1. Di kanan atas halaman peta sinyal, di tab **grup templat CloudWatch alarm, pilih Lampirkan grup templat CloudWatch ** **alarm**.

   1. Di bagian baru yang terbuka, pilih semua grup templat alarm yang ingin Anda terapkan ke peta sinyal ini, lalu pilih **Tambah**. Ini akan menyebabkan grup template alarm yang dipilih pindah ke bagian **grup templat CloudWatch alarm Terlampir**. 

   1. Memilih **Simpan** akan menyimpan perubahan Anda dan mengembalikan Anda ke halaman peta sinyal.

1. Di sebelah kanan halaman peta sinyal, pilih tab **grup templat EventBridge aturan** lalu pilih **Lampirkan grup templat EventBridge aturan**.

   1. Di bagian baru yang terbuka, pilih semua grup templat acara yang ingin Anda terapkan ke peta sinyal ini, lalu pilih **Tambah**. Ini akan menyebabkan grup templat aturan yang dipilih pindah ke bagian **Kelompok templat EventBridge aturan Terlampir**. 

   1. Memilih **Simpan** akan menyimpan perubahan Anda dan mengembalikan Anda ke halaman peta sinyal.

1. Anda telah menetapkan template CloudWatch alarm dan EventBridge aturan ke peta sinyal, tetapi pemantauan belum diterapkan. Bagian selanjutnya akan mencakup penyebaran sumber daya pemantauan.

# Menyebarkan template ke peta sinyal alur kerja AWS media Anda
<a name="monitor-with-workflow-monitor-configure-deploy"></a>

Setelah Anda melampirkan alarm dan template acara ke peta sinyal Anda, Anda harus menerapkan pemantauan. Sampai penyebaran selesai, pemantauan peta sinyal Anda tidak akan aktif.

Monitor alur kerja hanya akan menyebarkan alarm yang relevan dengan peta sinyal yang dipilih. Misalnya, grup templat alarm terlampir mungkin berisi alarm untuk beberapa layanan, seperti MediaLive, MediaPackage, dan MediaConnect. Jika peta sinyal yang dipilih hanya berisi MediaLive sumber daya, tidak ada MediaPackage atau MediaConnect alarm yang akan digunakan. 

**Untuk menyebarkan template pemantauan**

1. Setelah melampirkan alarm dan grup template acara ke peta sinyal Anda dan menyimpan perubahan Anda, pilih **Deploy monitor** di menu dropdown **Tindakan**.

1. Anda akan diminta untuk mengkonfirmasi penyebaran dan disajikan dengan jumlah CloudWatch dan sumber EventBridge daya yang akan dibuat. Jika Anda ingin melanjutkan, pilih **Deploy**.
**catatan**  
Tidak ada biaya langsung untuk menggunakan monitor alur kerja. Namun, ada biaya yang terkait dengan sumber daya yang dibuat dan digunakan untuk memantau alur kerja Anda.  
Saat pemantauan diterapkan, EventBridge sumber daya Amazon CloudWatch dan Amazon dibuat. Saat menggunakan Konsol AWS Manajemen, sebelum menerapkan pemantauan ke peta sinyal, Anda akan diberi tahu berapa banyak sumber daya yang akan dibuat. Untuk informasi lebih lanjut tentang harga, lihat: [CloudWatchharga](https://aws.amazon.com/cloudwatch/pricing/) dan [EventBridge harga](https://aws.amazon.com/eventbridge/pricing/).  
Monitor alur kerja menggunakan AWS CloudFormation templat untuk menyebarkan CloudWatch dan EventBridge sumber daya. Template ini disimpan dalam bucket Amazon Simple Storage Service kelas standar yang dibuat atas nama Anda, oleh monitor alur kerja, selama proses penerapan dan akan dikenakan biaya penyimpanan dan penarikan objek. Untuk informasi selengkapnya tentang harga, lihat: Harga [Amazon S3](https://aws.amazon.com/s3/pricing/). 

1. Status penyebaran ditampilkan di sebelah nama peta sinyal. Status penerapan juga terlihat di bagian **Tumpukan** konsol. CloudFormation Setelah beberapa saat pembuatan dan penyebaran sumber daya, pemantauan peta sinyal Anda akan dimulai. 

# Memperbarui peta sinyal alur kerja AWS media Anda
<a name="monitor-with-workflow-monitor-configure-signal-maps-update"></a>

Jika perubahan dilakukan pada alur kerja Anda, Anda mungkin perlu menemukan kembali peta sinyal dan menerapkan kembali sumber daya pemantauan. Monitor alur kerja adalah alat visualisasi dan pemantauan yang tidak memiliki kemampuan untuk membuat perubahan apa pun pada alur kerja Anda. Peta sinyal mewakili point-in-time visualisasi alur kerja Anda. Jika Anda menambahkan, menghapus, atau memodifikasi secara signifikan bagian dari alur kerja media Anda, sebaiknya Anda menemukan kembali peta sinyal. Jika Anda memiliki sumber daya pemantauan yang terpasang pada peta sinyal, kami sarankan Anda menerapkan kembali pemantauan setelah proses penemuan kembali.

**Untuk menemukan kembali peta sinyal**

1. Dari panel navigasi konsol monitor alur kerja, pilih **Peta sinyal** dan pilih peta sinyal yang ingin Anda gunakan.

1. Verifikasi bahwa Anda berada di tampilan **Konfigurasi peta sinyal**. Untuk informasi selengkapnya tentang mengubah tampilan, lihat: [Melihat peta sinyal ](monitor-with-workflow-monitor-configure-signal-maps-view.md)

1. Di kanan atas halaman peta sinyal, pilih menu tarik-turun **Tindakan**. Pilih **Temukan Kembali**.

1. Anda akan disajikan dengan layar penemuan kembali. Pilih sumber daya yang merupakan bagian dari alur kerja yang Anda temukan kembali. Pilih tombol **Temukan Kembali**.

1. Peta sinyal akan dibangun kembali sesuai dengan alur kerja saat ini. Jika Anda perlu menerapkan kembali sumber daya pemantauan, tetap di halaman peta sinyal ini. Template pemantauan yang dilampirkan sebelumnya akan tetap dilampirkan, tetapi perlu digunakan kembali.

**Untuk menerapkan ulang template pemantauan setelah penemuan kembali peta sinyal**

1. Setelah penemuan kembali, Anda akan diarahkan ke peta sinyal yang diperbarui. Untuk menerapkan ulang template pemantauan, pilih **Deploy monitor** dari menu dropdown **Actions**.

1. Anda akan diminta untuk mengkonfirmasi penyebaran dan disajikan dengan jumlah EventBridge sumber daya apa pun CloudWatch yang akan dibuat. Jika Anda ingin melanjutkan, pilih **Deploy**.

1. Status penyebaran ditampilkan di sebelah nama peta sinyal. Setelah beberapa saat pembuatan dan penyebaran sumber daya, pemantauan peta sinyal Anda akan dimulai.

    

# Menghapus peta sinyal alur kerja AWS media Anda
<a name="monitor-with-workflow-monitor-configure-signal-maps-delete"></a>

Jika Anda tidak lagi membutuhkan peta sinyal, itu dapat dihapus. Jika Anda memiliki templat pemantauan yang disebarkan di peta sinyal, proses penghapusan akan meminta Anda untuk menghapus EventBridge sumber daya apa pun CloudWatch yang telah digunakan ke peta sinyal ini. Menghapus sumber daya yang digunakan tidak memengaruhi templat yang membuatnya. Penghapusan sumber daya ini untuk memastikan bahwa Anda tidak memiliki CloudWatch dan EventBridge sumber daya yang digunakan tetapi tidak digunakan. 

**Untuk menghapus peta sinyal**

1. Dari panel navigasi konsol monitor alur kerja, pilih **Peta sinyal** dan pilih tombol radio di sebelah peta sinyal yang ingin Anda hapus.

1. Pilih tombol **Hapus**. Anda akan diminta untuk mengkonfirmasi penghapusan sumber daya pemantauan. Pilih **Hapus** untuk memulai proses penghapusan sumber daya pemantauan.

1. Kolom **penyebaran Monitor** akan menampilkan status saat ini. Ketika status telah berubah menjadi **DELETE\$1COMPLETE**, pilih tombol **Delete** lagi.

1. Anda akan diminta untuk mengkonfirmasi penghapusan peta sinyal. Pilih **Hapus** untuk melanjutkan dan menghapus peta sinyal.

 

# Kuota monitor alur kerja
<a name="monitor-with-workflow-monitor-configure-quotas"></a>

Bagian berikut berisi kuota untuk sumber daya monitor alur kerja. Setiap kuota berdasarkan “per akun”. Jika Anda perlu menambah kuota untuk akun Anda, Anda dapat menggunakan konsol [AWS Service Quotas](https://console.aws.amazon.com/servicequotas/home) untuk meminta kenaikan, kecuali dinyatakan lain dalam tabel berikut. 


**Kuota**  

| Tipe sumber daya | Kuota | 
| --- | --- | 
| CloudWatch grup template alarm | 20 | 
| CloudWatch template alarm | 200 | 
| EventBridge kelompok template aturan | 20 | 
| EventBridge template aturan | 200 | 
| Peta sinyal | 30 | 
| Peta sinyal: grup templat CloudWatch alarm yang dilampirkan ke peta sinyal tunggal | 5Anda tidak dapat menambah kuota ini. | 
| Peta sinyal: grup templat EventBridge aturan yang dilampirkan ke peta sinyal tunggal | 5Anda tidak dapat menambah kuota ini. | 

# Menggunakan monitor alur kerja
<a name="monitor-with-workflow-monitor-operate"></a>

Gunakan bagian **ikhtisar** dan **peta sinyal** pada konsol monitor alur kerja untuk meninjau status alur kerja saat ini dan alarm, metrik, dan log terkait. 

**Topics**
+ [Ikhtisar monitor alur kerja](monitor-with-workflow-monitor-operate-overview.md)
+ [Log ikhtisar dan metrik untuk monitor alur kerja](monitor-with-workflow-monitor-operate-logs-metrics.md)
+ [Menggunakan peta sinyal monitor alur kerja](monitor-with-workflow-monitor-operate-signal-maps.md)

# Ikhtisar monitor alur kerja
<a name="monitor-with-workflow-monitor-operate-overview"></a>

Bagian **Ikhtisar** pada konsol monitor alur kerja adalah dasbor yang menyediakan at-a-glance informasi tentang peta sinyal Anda. Di bagian ikhtisar, Anda dapat melihat status saat ini dari setiap pemantauan peta sinyal, serta CloudWatch metrik dan CloudWatch log terkait. Anda dapat memilih peta sinyal apa pun yang akan dibawa ke halaman konsol peta sinyal itu.

**Ikhtisar penyaringan**

Menggunakan bilah **Pencarian** di bagian ikhtisar, Anda dapat memfilter daftar peta sinyal menggunakan batasan sensitif konteks. Setelah memilih bilah pencarian, Anda akan disajikan dengan daftar **Properti** untuk difilter. Memilih properti akan menampilkan **Operator** seperti Sama, Berisi, Tidak sama, dan Tidak mengandung. Memilih operator akan membuat daftar sumber daya dari jenis properti yang dipilih. Memilih salah satu sumber daya ini akan menyebabkan daftar peta sinyal hanya menampilkan peta sinyal yang sesuai dengan batasan yang Anda tentukan. 

# Log ikhtisar dan metrik untuk monitor alur kerja
<a name="monitor-with-workflow-monitor-operate-logs-metrics"></a>

Untuk melihat CloudWatch metrik dan log untuk peta sinyal, pilih tombol radio di sebelah nama peta sinyal. Antarmuka tab untuk metrik dan log akan muncul di bawah daftar peta sinyal. 

**CloudWatch Metrik-metrik**

CloudWatch metrik untuk peta sinyal yang dipilih akan peka konteks dan hanya menampilkan metrik yang terkait dengan layanan yang digunakan dalam alur kerja peta sinyal tersebut. Anda dapat menggunakan alat metrik di layar untuk menyesuaikan periode metrik dan rentang waktu yang ditampilkan.

**CloudWatch Log**

Jika Anda mengaitkan grup CloudWatch log dengan peta sinyal, grup itu akan ditampilkan di sini.

# Menggunakan peta sinyal monitor alur kerja
<a name="monitor-with-workflow-monitor-operate-signal-maps"></a>

Dari bagian **ikhtisar** konsol, Anda dapat memilih peta sinyal tertentu untuk melihat informasi lebih lanjut tentang peta sinyal itu dan sumber daya pemantauan terlampir.

Setelah memilih peta sinyal, Anda akan disajikan dengan peta sinyal dan sejumlah bagian tab yang berisi informasi lebih lanjut:
+ CloudWatch alarm
+ EventBridge aturan
+ AWS Peringatan elemen
+ Metrik-metrik
+ Beberapa catatan
+ Detail dasar

**Menavigasi peta sinyal**

Peta sinyal akan berisi node untuk setiap sumber daya AWS yang didukung yang ditemukan oleh monitor alur kerja. Sumber daya tertentu, seperti MediaLive saluran dan MediaPackage titik akhir dapat menampilkan pratinjau thumbnail konten, jika pratinjau thumbnail tersedia.

Memilih simpul sumber daya, dan memilih **Lihat detail sumber daya yang dipilih** dari menu tarik-turun **Tindakan** akan membawa Anda ke halaman detail layanan terkait. Misalnya, memilih MediaLive saluran dan memilih **Lihat detail sumber daya yang dipilih** akan membuka halaman detail MediaLive konsol untuk saluran tersebut. 

Memilih node sumber daya akan memfilter daftar alarm aktif hanya untuk node itu. Jika Anda memilih **ARN Target** sumber daya di alarm aktif, Anda akan dibawa ke halaman detail layanan terkait, dengan sumber daya yang dipilih terbuka.