Skip to content

Commit 576a8f9

Browse files
author
AWS
committed
AWS MediaTailor Update: Add support for log filtering which allow customers to filter out selected event types from logs.
1 parent 3d44c49 commit 576a8f9

File tree

2 files changed

+154
-1
lines changed

2 files changed

+154
-1
lines changed

‎.changes/next-release/feature-AWSMediaTailor-104a736.json

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,6 @@
1+
{
2+
"type": "feature",
3+
"category": "AWS MediaTailor",
4+
"contributor": "",
5+
"description": "Add support for log filtering which allow customers to filter out selected event types from logs."
6+
}

‎services/mediatailor/src/main/resources/codegen-resources/service-2.json

Lines changed: 148 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -611,7 +611,7 @@
611611
"members":{
612612
"StreamingMediaFileConditioning":{
613613
"shape":"StreamingMediaFileConditioning",
614-
"documentation":"<p>For ads that have media files with streaming delivery and supported file extensions, indicates what transcoding action MediaTailor takes when it first receives these ads from the ADS. <code>TRANSCODE</code> indicates that MediaTailor must transcode the ads. <code>NONE</code> indicates that you have already transcoded the ads outside of MediaTailor and don't need them transcoded as part of the ad insertion workflow. For more information about ad conditioning see <a href=\"https://docs.aws.amazon.com/precondition-ads.html\">https://docs.aws.amazon.com/precondition-ads.html</a>.</p>"
614+
"documentation":"<p>For ads that have media files with streaming delivery and supported file extensions, indicates what transcoding action MediaTailor takes when it first receives these ads from the ADS. <code>TRANSCODE</code> indicates that MediaTailor must transcode the ads. <code>NONE</code> indicates that you have already transcoded the ads outside of MediaTailor and don't need them transcoded as part of the ad insertion workflow. For more information about ad conditioning see <a href=\"https://docs.aws.amazon.com/mediatailor/latest/ug/precondition-ads.html\">Using preconditioned ads</a> in the Elemental MediaTailor user guide.</p>"
615615
}
616616
},
617617
"documentation":"<p>The setting that indicates what conditioning MediaTailor will perform on ads that the ad decision server (ADS) returns.</p>"
@@ -633,6 +633,70 @@
633633
"SCTE35_ENHANCED"
634634
]
635635
},
636+
"AdsInteractionExcludeEventType":{
637+
"type":"string",
638+
"enum":[
639+
"AD_MARKER_FOUND",
640+
"NON_AD_MARKER_FOUND",
641+
"MAKING_ADS_REQUEST",
642+
"MODIFIED_TARGET_URL",
643+
"VAST_REDIRECT",
644+
"EMPTY_VAST_RESPONSE",
645+
"EMPTY_VMAP_RESPONSE",
646+
"VAST_RESPONSE",
647+
"REDIRECTED_VAST_RESPONSE",
648+
"FILLED_AVAIL",
649+
"FILLED_OVERLAY_AVAIL",
650+
"BEACON_FIRED",
651+
"WARNING_NO_ADVERTISEMENTS",
652+
"WARNING_VPAID_AD_DROPPED",
653+
"WARNING_URL_VARIABLE_SUBSTITUTION_FAILED",
654+
"ERROR_UNKNOWN",
655+
"ERROR_UNKNOWN_HOST",
656+
"ERROR_DISALLOWED_HOST",
657+
"ERROR_ADS_IO",
658+
"ERROR_ADS_TIMEOUT",
659+
"ERROR_ADS_RESPONSE_PARSE",
660+
"ERROR_ADS_RESPONSE_UNKNOWN_ROOT_ELEMENT",
661+
"ERROR_ADS_INVALID_RESPONSE",
662+
"ERROR_VAST_REDIRECT_EMPTY_RESPONSE",
663+
"ERROR_VAST_REDIRECT_MULTIPLE_VAST",
664+
"ERROR_VAST_REDIRECT_FAILED",
665+
"ERROR_VAST_MISSING_MEDIAFILES",
666+
"ERROR_VAST_MISSING_CREATIVES",
667+
"ERROR_VAST_MISSING_OVERLAYS",
668+
"ERROR_VAST_MISSING_IMPRESSION",
669+
"ERROR_VAST_INVALID_VAST_AD_TAG_URI",
670+
"ERROR_VAST_MULTIPLE_TRACKING_EVENTS",
671+
"ERROR_VAST_MULTIPLE_LINEAR",
672+
"ERROR_VAST_INVALID_MEDIA_FILE",
673+
"ERROR_FIRING_BEACON_FAILED",
674+
"ERROR_PERSONALIZATION_DISABLED",
675+
"VOD_TIME_BASED_AVAIL_PLAN_VAST_RESPONSE_FOR_OFFSET",
676+
"VOD_TIME_BASED_AVAIL_PLAN_SUCCESS",
677+
"VOD_TIME_BASED_AVAIL_PLAN_WARNING_NO_ADVERTISEMENTS",
678+
"INTERSTITIAL_VOD_SUCCESS",
679+
"INTERSTITIAL_VOD_FAILURE"
680+
]
681+
},
682+
"AdsInteractionLog":{
683+
"type":"structure",
684+
"members":{
685+
"PublishOptInEventTypes":{
686+
"shape":"__adsInteractionPublishOptInEventTypesList",
687+
"documentation":"<p>Indicates that MediaTailor emits <code>RAW_ADS_RESPONSE</code> logs for playback sessions that are initialized with this configuration.</p>"
688+
},
689+
"ExcludeEventTypes":{
690+
"shape":"__adsInteractionExcludeEventTypesList",
691+
"documentation":"<p>Indicates that MediaTailor won't emit the selected events in the logs for playback sessions that are initialized with this configuration.</p>"
692+
}
693+
},
694+
"documentation":"<p>Settings for customizing what events are included in logs for interactions with the ad decision server (ADS).</p> <p>For more information about ADS logs, inlcuding descriptions of the event types, see <a href=\"https://docs.aws.amazon.com/mediatailor/latest/ug/ads-log-format.html\">MediaTailor ADS logs description and event types</a> in Elemental MediaTailor User Guide.</p>"
695+
},
696+
"AdsInteractionPublishOptInEventType":{
697+
"type":"string",
698+
"enum":["RAW_ADS_RESPONSE"]
699+
},
636700
"Alert":{
637701
"type":"structure",
638702
"required":[
@@ -961,6 +1025,14 @@
9611025
"EnabledLoggingStrategies":{
9621026
"shape":"__listOfLoggingStrategies",
9631027
"documentation":"<p>The method used for collecting logs from AWS Elemental MediaTailor. To configure MediaTailor to send logs directly to Amazon CloudWatch Logs, choose <code>LEGACY_CLOUDWATCH</code>. To configure MediaTailor to send logs to CloudWatch, which then vends the logs to your destination of choice, choose <code>VENDED_LOGS</code>. Supported destinations are CloudWatch Logs log group, Amazon S3 bucket, and Amazon Data Firehose stream.</p> <p>To use vended logs, you must configure the delivery destination in Amazon CloudWatch, as described in <a href=\"https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/AWS-logs-and-resource-policy.html#AWS-vended-logs-permissions-V2\">Enable logging from AWS services, Logging that requires additional permissions [V2]</a>.</p>"
1028+
},
1029+
"AdsInteractionLog":{
1030+
"shape":"AdsInteractionLog",
1031+
"documentation":"<p>The event types that MediaTailor emits in logs for interactions with the ADS.</p>"
1032+
},
1033+
"ManifestServiceInteractionLog":{
1034+
"shape":"ManifestServiceInteractionLog",
1035+
"documentation":"<p>The event types that MediaTailor emits in logs for interactions with the origin server.</p>"
9641036
}
9651037
},
9661038
"documentation":"<p>Configures Amazon CloudWatch log settings for a playback configuration.</p>"
@@ -980,6 +1052,14 @@
9801052
"EnabledLoggingStrategies":{
9811053
"shape":"__listOfLoggingStrategies",
9821054
"documentation":"<p>The method used for collecting logs from AWS Elemental MediaTailor. <code>LEGACY_CLOUDWATCH</code> indicates that MediaTailor is sending logs directly to Amazon CloudWatch Logs. <code>VENDED_LOGS</code> indicates that MediaTailor is sending logs to CloudWatch, which then vends the logs to your destination of choice. Supported destinations are CloudWatch Logs log group, Amazon S3 bucket, and Amazon Data Firehose stream. </p>"
1055+
},
1056+
"AdsInteractionLog":{
1057+
"shape":"AdsInteractionLog",
1058+
"documentation":"<p>The event types that MediaTailor emits in logs for interactions with the ADS.</p>"
1059+
},
1060+
"ManifestServiceInteractionLog":{
1061+
"shape":"ManifestServiceInteractionLog",
1062+
"documentation":"<p>The event types that MediaTailor emits in logs for interactions with the origin server.</p>"
9831063
}
9841064
}
9851065
},
@@ -2651,6 +2731,14 @@
26512731
"EnabledLoggingStrategies":{
26522732
"shape":"__listOfLoggingStrategies",
26532733
"documentation":"<p>The method used for collecting logs from AWS Elemental MediaTailor. <code>LEGACY_CLOUDWATCH</code> indicates that MediaTailor is sending logs directly to Amazon CloudWatch Logs. <code>VENDED_LOGS</code> indicates that MediaTailor is sending logs to CloudWatch, which then vends the logs to your destination of choice. Supported destinations are CloudWatch Logs log group, Amazon S3 bucket, and Amazon Data Firehose stream. </p>"
2734+
},
2735+
"AdsInteractionLog":{
2736+
"shape":"AdsInteractionLog",
2737+
"documentation":"<p>Settings for customizing what events are included in logs for interactions with the ad decision server (ADS).</p>"
2738+
},
2739+
"ManifestServiceInteractionLog":{
2740+
"shape":"ManifestServiceInteractionLog",
2741+
"documentation":"<p>Settings for customizing what events are included in logs for interactions with the origin server.</p>"
26542742
}
26552743
},
26562744
"documentation":"<p>Defines where AWS Elemental MediaTailor sends logs for the playback configuration.</p>"
@@ -2694,6 +2782,53 @@
26942782
},
26952783
"documentation":"<p>The configuration for manifest processing rules. Manifest processing rules enable customization of the personalized manifests created by MediaTailor.</p>"
26962784
},
2785+
"ManifestServiceExcludeEventType":{
2786+
"type":"string",
2787+
"enum":[
2788+
"GENERATED_MANIFEST",
2789+
"ORIGIN_MANIFEST",
2790+
"SESSION_INITIALIZED",
2791+
"TRACKING_RESPONSE",
2792+
"CONFIG_SYNTAX_ERROR",
2793+
"CONFIG_SECURITY_ERROR",
2794+
"UNKNOWN_HOST",
2795+
"TIMEOUT_ERROR",
2796+
"CONNECTION_ERROR",
2797+
"IO_ERROR",
2798+
"UNKNOWN_ERROR",
2799+
"HOST_DISALLOWED",
2800+
"PARSING_ERROR",
2801+
"MANIFEST_ERROR",
2802+
"NO_MASTER_OR_MEDIA_PLAYLIST",
2803+
"NO_MASTER_PLAYLIST",
2804+
"NO_MEDIA_PLAYLIST",
2805+
"INCOMPATIBLE_HLS_VERSION",
2806+
"SCTE35_PARSING_ERROR",
2807+
"INVALID_SINGLE_PERIOD_DASH_MANIFEST",
2808+
"UNSUPPORTED_SINGLE_PERIOD_DASH_MANIFEST",
2809+
"LAST_PERIOD_MISSING_AUDIO",
2810+
"LAST_PERIOD_MISSING_AUDIO_WARNING",
2811+
"ERROR_ORIGIN_PREFIX_INTERPOLATION",
2812+
"ERROR_ADS_INTERPOLATION",
2813+
"ERROR_LIVE_PRE_ROLL_ADS_INTERPOLATION",
2814+
"ERROR_CDN_AD_SEGMENT_INTERPOLATION",
2815+
"ERROR_CDN_CONTENT_SEGMENT_INTERPOLATION",
2816+
"ERROR_SLATE_AD_URL_INTERPOLATION",
2817+
"ERROR_PROFILE_NAME_INTERPOLATION",
2818+
"ERROR_BUMPER_START_INTERPOLATION",
2819+
"ERROR_BUMPER_END_INTERPOLATION"
2820+
]
2821+
},
2822+
"ManifestServiceInteractionLog":{
2823+
"type":"structure",
2824+
"members":{
2825+
"ExcludeEventTypes":{
2826+
"shape":"__manifestServiceExcludeEventTypesList",
2827+
"documentation":"<p>Indicates that MediaTailor won't emit the selected events in the logs for playback sessions that are initialized with this configuration.</p>"
2828+
}
2829+
},
2830+
"documentation":"<p>Settings for customizing what events are included in logs for interactions with the origin server.</p> <p>For more information about manifest service logs, including descriptions of the event types, see <a href=\"https://docs.aws.amazon.com/mediatailor/latest/ug/log-types.html\">MediaTailor manifest logs description and event types</a> in Elemental MediaTailor User Guide.</p>"
2831+
},
26972832
"MaxResults":{
26982833
"type":"integer",
26992834
"box":true,
@@ -3998,6 +4133,14 @@
39984133
},
39994134
"documentation":"<p>VOD source configuration parameters.</p>"
40004135
},
4136+
"__adsInteractionExcludeEventTypesList":{
4137+
"type":"list",
4138+
"member":{"shape":"AdsInteractionExcludeEventType"}
4139+
},
4140+
"__adsInteractionPublishOptInEventTypesList":{
4141+
"type":"list",
4142+
"member":{"shape":"AdsInteractionPublishOptInEventType"}
4143+
},
40014144
"__boolean":{
40024145
"type":"boolean",
40034146
"box":true
@@ -4085,6 +4228,10 @@
40854228
"type":"long",
40864229
"box":true
40874230
},
4231+
"__manifestServiceExcludeEventTypesList":{
4232+
"type":"list",
4233+
"member":{"shape":"ManifestServiceExcludeEventType"}
4234+
},
40884235
"__mapOf__string":{
40894236
"type":"map",
40904237
"key":{"shape":"__string"},

0 commit comments

Comments
 (0)