AWS mediatailor documentation change
Summary
Expanded log filtering documentation with cost control guidance and configuration options
Security assessment
Focuses on cost optimization through log management rather than addressing security vulnerabilities or describing security-specific features
Diff
diff --git a/mediatailor/latest/ug/logs-filter.md b/mediatailor/latest/ug/logs-filter.md index 0b60a87be..85b55ff1a 100644 --- a/mediatailor/latest/ug/logs-filter.md +++ b/mediatailor/latest/ug/logs-filter.md @@ -5 +5 @@ -# Filtering AWS Elemental MediaTailor per-session logs and events +# Filtering AWS Elemental MediaTailor logs and events @@ -7 +7 @@ -Logs emitted from a playback configuration in MediaTailor include information about a variety of activities that happen during the playback session. These activities are identified in the event type of the logs, and many events are logged by default. Because the volume of logs might impact your costs in Amazon CloudWatch, and you might want a different level of detail between sessions, MediaTailor provides controls over which event types are logged. With query parameters at session initialization, you can do the following: +Logs emitted from a playback configuration in MediaTailor include information about a variety of activities that happen during the playback session. These activities are identified in the event type of the logs. Many events are logged by default. To help control the cost of logs in Amazon CloudWatch, you can specify the logs that MediaTailor emits. @@ -9 +9,3 @@ Logs emitted from a playback configuration in MediaTailor include information ab - * Specify the log events that you want to opt in to +MediaTailor provides you control over log filtering so you can do the following: + + * Specify the log events that you want to exclude from logs @@ -15,0 +18,11 @@ Logs emitted from a playback configuration in MediaTailor include information ab +You can set these log filtering preferences independently for each playback session, or as a default for all playback sessions for a playback configuration. + + * To filter logs on a per-session basis, include query parameters in the playback session initialization request. + + * To filter logs on a per-playback configuration basis, use the MediaTailor console or API to indicate your preferences in the playback configuration settings. + + + + +The following sections provide instruction for enabling log filtering on sessions and playback configurations. + @@ -27,5 +40 @@ To define a customized level of log detail for each session, append the followin -###### Note - -You must have debug mode enabled to receive any ManifestService logs. For information about debug log mode, including how to enable it, see [Generating debug logs](./debug-log-mode.html). - -For a list of log and event types that MediaTailor emits, see [Manifest logs](./log-types.html). +For a list of log and event types that MediaTailor emits, see [Manifest logs](./log-types.html), [ADS logs](./ads-log-format.html), and [Transcode logs](./tm-log-format.html). @@ -90,0 +100,17 @@ To enable raw logs from your ADS, include the `RAW_ADS_RESPONSE `value for the ` +Use the playback configuration's settings to define the log event types that MediaTailor emits as a default from this playback configuration. MediaTailor uses these default log filtering settings for all sessions that don't include filtering query parameters on the session init request. + +You can choose to do the following: + + * Receive logs for specific ad decision server (ADS) interactions. + + * Exclude logs for specific ADS interactions. + + * Exclude logs for specific manifest service interactions. + + + + +To set these settings from the MediaTailor console, see [Creating a configuration](./configurations-create.html). For the MediaTailor API, see [PutPlaybackConfiguration](https://docs.aws.amazon.com/mediatailor/latest/apireference/API_PutPlaybackConfiguration.html) in the _AWS Elemental MediaTailor API Reference_. + +For a list of log and event types that MediaTailor emits, see [Manifest logs](./log-types.html), [ADS logs](./ads-log-format.html), and [Transcode logs](./tm-log-format.html). +