本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

故障排除和监控功能

该页面可帮助您诊断常见的功能错误并监控生产中的功能性能。疑难解答部分按症状组织——从您观察到的内容开始，然后按照原因进行修复。

监控

CloudWatch 指标

MediaTailor 向 Amazon 发布函数执行指标 CloudWatch。无需选择加入。

Hook-level metrics — 每次生命周期挂钩执行一个数据点：

Function-level metrics — 每个函数执行一个数据点：

有关设置警报和使用这些指标的更多详细信息，请参阅监控 AWS Elemental MediaTailor 使用亚马逊 CloudWatch 指标。

日志事件

MediaTailor 为函数执行发出日志事件。默认情况下会发出错误事件。已完成事件和摘要事件是可选的。

要启用选择加入日志事件，请参阅监控 AWS Elemental MediaTailor 使用亚马逊 CloudWatch 指标。

使用该eventId字段将钩子级别和函数级事件关联起来，以实现相同的执行。

以下 Amaz CloudWatch on Logs Insights 查询筛选函数错误事件eventId以跟踪单次执行：

fields @timestamp, eventType, functionId, errorType, cause
| filter eventId = "5dc6f040-0f72-4e8c-a64e-25eeef62708c"
| sort @timestamp asc

问题排查

当函数失败时，会在错误事件中 MediaTailor 记录一个errorType字段。使用此字段来标识故障类别：

这些条目按症状组织，并在适用的情况下引用这些错误类型。

表达式意外返回空值

症状：您期望填充的输出值在播放器参数中存在null或缺失。

可能的原因：

R@@ ESOURCE_LIMIT_ERROR：堆栈溢出

症状：函数在出现errorType: "RESOURCE_LIMIT_ERROR"和时失败cause: "Stack overflow error"。

原因：表达式超过了 100 个等级的最大堆栈深度。这种情况通常发生在深度嵌套的条件 (if/then/else) 表达式或复杂的变量赋值中。

这意味着表达式的嵌套层次太多 MediaTailor ，无法处理。

修复：简化表达式。将复杂的逻辑分解为多个输出条目或顺序执行器中的多个步骤。

R@@ ESOURCE_LIMIT_ERROR：CPU 超时

症状：函数在出现errorType: "RESOURCE_LIMIT_ERROR"和时失败cause: "Expression evaluation timeout: Check for infinite loop"。

原因：表达式超过了 100 毫秒的 CPU 时间限制。在大型数据结构上执行昂贵计算的表达式可能会发生这种情况。

修复：降低表达式的复杂性。如果您正在处理大型数组，请考虑将该逻辑移至外部服务并使用HTTP_REQUEST函数调用它。

限制错误：不允许使用函数

症状：函数在出现errorType: "RESTRICTION_ERROR"和时失败cause: "Function '<name>' is not allowed"。

原因：该表达式调用的 jsonata 函数不在允许的 38 个函数列表中。常见的示例包括$filter$reduce、$eval、$split、和$join。

修复：检查cause字段中是否有被屏蔽的函数名称。将其替换为允许的替代方案。有关允许jsonata 表达式参考的 38 个函数的完整列表，请参阅。

允许使用的常用函数包括$string$number、$substring、$contains、和$encodeUrlComponent。

RESTR@@ ICTION_ERROR：表达式太长

症状：无法使用创建或更新函数cause: "Expression length <actual> exceeds limit <limit>"。

原因：单个表达式超过 1,000 个字符。

修复：将表达式分成较小的部分。使用多个输出条目，或者在顺序执行器中将逻辑分成多个步骤。使用变量绑定 (:=) 来避免重复长子表达式。

HTTP 错误：状态码为空

症状：在HTTP_REQUEST函数的输出中，response.statusCode是null。

原因：无法访问外部 API、连接超时或出现网络错误。发生这种情况时， MediaTailor 将设置response.statusCode为null、设置response.body为null、设置response.text为"Internal Error"。

修复：response.statusCode在访问响应数据之前请务必进行检查：

{%response.statusCode = 200 ? response.body.value : 'default'%}

此表达式检查 HTTP 调用是否返回了 200 状态码。如果是，则使用响应值。否则，它将回退到默认值。

如果这种情况经常发生，请检查外部 API 是否正常。RequestTimeoutMilliseconds如果 API 很慢，可以考虑增加，或者如果你想快速失败，可以考虑减少它。

HTTP 错误：响应正文为空

症状：response.statusCode是 200 但response.body确实如此null。

原因：响应正文要么是无效的 JSON，要么超过 20,000 个字符。 MediaTailor 只能将最多 20,000 个字符的 JSON 响应解析为response.body。

修复：response.text用作后备。该response.text字段包含截断为 20,000 个字符的原始响应正文：

{%response.statusCode = 200 ? ($exists(response.body.id) ? response.body.id : $substring(response.text, 0, 100)) : 'error'%}

如果您需要的数据超过 20,000 个字符的限制，可以考虑要求外部 API 返回较小的响应（例如，通过请求特定字段）。

HTTP 错误：网址验证失败

症状：函数在运行时失败，并显示一条关于 URL 格式错误、使用无效方案或超过最大长度的消息。

可能的原因：

VALIDATION_ERROR

症状：函数失败errorType: "VALIDATION_ERROR"。此错误可能发生在创作时（创建或更新函数时），也可能发生在执行时（函数在会话期间运行时）。

可能的原因：

检查错误日志事件中的cause字段，它会识别哪个字段或表达式未通过验证。

INTERNAL_ERROR

症状：函数失败errorType: "INTERNAL_ERROR"。

原因：发生了与您的功能配置无关的基础设施故障。

修复：重试请求。如果错误仍然存在，请联系 Supp AWS ort。