AWS mediatailor documentation change
Summary
Added new CloudWatch metrics for Functions feature including hook-level and function-level invocations, errors, and latency. Expanded dimensions for function monitoring.
Security assessment
Metrics provide operational insights into function performance but contain no security-specific indicators or vulnerability mitigations. Focuses on performance monitoring rather than security capabilities.
Diff
diff --git a/mediatailor/latest/ug/monitoring-cloudwatch-metrics.md b/mediatailor/latest/ug/monitoring-cloudwatch-metrics.md index 5ef9c6077..cc4bba90b 100644 --- a//mediatailor/latest/ug/monitoring-cloudwatch-metrics.md +++ b//mediatailor/latest/ug/monitoring-cloudwatch-metrics.md @@ -114,0 +115,23 @@ For HLS Interstitials sessions, some metrics behave differently due to the late- +### Functions metrics + +The following metrics are published when you use [Functions](monetization-functions.html) with your playback configurations. These metrics are always emitted when a function is configured on a lifecycle hook. No opt-in or log configuration is required. + +**Hook-level metrics** — one data point per lifecycle hook execution: + +Metric | Description +---|--- +`PreSessionInitHook.Invocations` | The number of times the pre-session initialization hook was invoked. +`PreSessionInitHook.Errors` | The number of pre-session initialization hook executions that resulted in an error. +`PreSessionInitHook.Latency` | The execution time in milliseconds for the pre-session initialization hook. +`PreAdsRequestHook.Invocations` | The number of times the pre-ads request hook was invoked. +`PreAdsRequestHook.Errors` | The number of pre-ads request hook executions that resulted in an error. +`PreAdsRequestHook.Latency` | The execution time in milliseconds for the pre-ads request hook. + +**Function-level metrics** — one data point per individual function execution. These metrics include additional dimensions (`FunctionId`, `FunctionType`, `HookType`) so you can identify which specific function is slow or failing: + +Metric | Description +---|--- +`Function.Invocations` | The number of times an individual function was executed. +`Function.Errors` | The number of individual function executions that resulted in an error. +`Function.Latency` | The execution time in milliseconds for an individual function. + @@ -170 +193 @@ The highest `Avail.FillRate` that MediaTailor can attain for any ad avail is 100 -You can filter the AWS Elemental MediaTailor data using the following dimension. +You can filter the AWS Elemental MediaTailor data using the following dimensions. @@ -174 +197,4 @@ Dimension | Description -`Configuration Name` | Indicates the configuration that the metric belongs to. +`ConfigurationName` | Indicates the configuration that the metric belongs to. Available on all metrics. +`FunctionId` | The identifier of the function. Available on `Function.*` metrics only. +`FunctionType` | The type of function: `CUSTOM_OUTPUT`, `HTTP_REQUEST`, `SEQUENTIAL_EXECUTOR`, or `CONCURRENT_EXECUTOR`. Available on `Function.*` metrics only. +`HookType` | The lifecycle hook that triggered the function: `PRE_SESSION_INITIALIZATION` or `PRE_ADS_REQUEST`. Available on `Function.*` metrics only.