对返回的播放错误进行故障排除 MediaTailor - AWS Elemental MediaTailor

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

对返回的播放错误进行故障排除 MediaTailor

本节提供有关您在测试播放器软件和正常处理玩家请求时可能收到的HTTP错误代码的信息。

注意

您可能还会收到来自的错误 AWS Elemental MediaTailor API,在PutPlaybackConfiguration和之类的配置操作中GetPlaybackConfiguration。有关这些错误类型的信息,请参阅 AWS Elemental MediaTailor API参考

当你的玩家向发送请求时 AWS Elemental MediaTailor直接或通过CDN,使用状态码进行 MediaTailor 响应。如果 MediaTailor 成功处理了请求,它将返回HTTP状态码200 OK(表示成功)以及已填充的清单。如果请求失败,则 MediaTailor 返回HTTP状态码、异常名称和错误消息。

AWS Elemental MediaTailor 返回两类错误:

  • 客户端错误 — 通常由请求本身的问题引起的错误,例如请求格式不正确、参数无效或参数错误。URL这些错误有HTTP4xx响应码。

  • 服务器错误 — 通常由依赖项问题 MediaTailor 或依赖项之一引起的错误,例如广告决策服务器 (ADS) 或源服务器。这些错误有HTTP5xx响应码。

返回的客户端播放错误 AWS Elemental MediaTailor

一般指导:

  • 您可以在响应的标题和正文中找到大多数错误的详细信息。

  • 对于某些错误,您需要检查您的配置设置。您可以从中检索播放配置的设置 AWS Elemental MediaTailor。 对于API,资源是GetPlaybackConfiguration/Name。有关详细信息,请参阅 AWS Elemental MediaTailor API参考

下表列出了清单操作活动返回的客户端错误代码 AWS Elemental MediaTailor、可能的原因以及为解决这些问题可以采取的措施。

代码 异常名称 含义 操作
400 BadRequestException MediaTailor 由于格式或内容存在一个或多个错误,无法为请求提供服务。参数可能格式不正确,或者请求可能包含无效的播放配置或会话 ID。 检查您的请求格式是否正确,是否包含准确的信息。确保播放器上的播放终端节点设置与 GetPlaybackConfiguration 返回的 ManifestEndpointPrefix 设置相匹配。重试您的请求。
403 AccessDeniedException 请求中提供的主机标头与 MediaTailor播放中配置的清单端点前缀不匹配URL。您的配置CDN可能不正确。 检查您的CDN设置,并确保使用正确的清单端点前缀 MediaTailor。重试您的请求。
404 NotFoundException MediaTailor 找不到指定的信息。可能的原因包括未映射到服务中的任何内容、未定义的配置或会话不可用。URL 检查您的配置和请求的有效性,然后重新初始化此会话。
409 ConflictException 播放器尝试同时为单个会话加载多个播放列表。结果, MediaTailor 检测到会话一致性冲突。这个问题发生在HLS玩家身上。 确保您的播放器一次请求一个播放列表。这符合HLS规范。
410 Gone 网络 ACL 和安全组都允许 (因此可到达您的实例) 的发起 ping 的 AWS Support 操作员已屏蔽玩家会话或客户配置。 AWS 当我们检测到来自单个会话或配置的错误流量的大量 4xx 请求时,Support 会在极少数情况下执行此操作。 如果您认为不应阻止该请求,请联系 Su AWSpport。他们可以调查问题并删除阻止筛选器(如果适用)。

如果您需要进一步的帮助,请联系 Supp AWSort

返回的服务器播放错误 AWS Elemental MediaTailor

一般指导:

  • 您可以在响应的标题和正文中找到大多数错误的详细信息。

  • 对于某些错误,您需要检查您的配置设置。您可以从中检索播放配置的设置 AWS Elemental MediaTailor。 对于API,资源是GetPlaybackConfiguration/Name。有关详细信息,请参阅 AWS Elemental MediaTailor API参考

下表列出了清单操作活动返回的服务器错误代码 AWS Elemental MediaTailor、可能的原因以及为解决这些问题可以采取的措施。

代码 异常名称 含义 操作
500 InternalServiceError 未处理的异常。 重试 请求。如果问题仍然存在,请检查您报告的 MediaTailor 运行状况 AWS 地区位于https://status.aws.amazon.com/.
502 BadGatewayException 源服务器地址或广告决策服务器 (ADS) 地址无效。无效地址如私有 IP 地址和 localhost 请确保您的配置ADS与源服务器的设置正确,然后重试请求。
502 UnsupportedManifestException 要么源清单已更改, MediaTailor无法对其进行个性化设置,要么 MediaTailor 不支持来源的清单格式。 这可能仅影响单个会话。重新初始化会话。您通常可以通过在查看器中刷新页面来完成此操作。如果问题仍然存在,请验证是否 MediaTailor支持来源的清单格式。有关信息,请参阅集成内容源
503 LoadShed MediaTailor 在处理您的请求时遇到了资源限制。 重试 请求。如果问题仍然存在,请检查您报告的 MediaTailor 运行状况 AWS 地区位于https://status.aws.amazon.com/.
503 ThrottlingException 您的每秒交易量已达到您的配额,并且 MediaTailor 正在限制您的使用。 重试 请求。你也可以查看你报告的 MediaTailor 生命值 AWS 地区位于https://status.aws.amazon.com/. 您可能希望提高每秒交易数的配额。有关更多信息,请参阅 广告投放配额
504 GatewayTimeoutException 联系源服务器 MediaTailor 时出现超时。 重试 请求。如果问题仍然存在,请检查源服务器的运行状况,并确保源服务器在广告投放配额中列出的内容源服务器超时内做出响应。

如果您需要进一步的帮助,请联系 Supp AWSort

播放错误示例

本节列出了在命令行交互中可能看到的播放错误的一些示例 AWS Elemental MediaTailor.

以下示例显示了两者之间发生超时时的结果 AWS Elemental MediaTailor 以及广告决策服务器 (ADS) 或源服务器。

~[]> curl -vvv https://111122223333444455556666123456789012.mediatailor.us-west-2.amazonaws.com/v1/master/123456789012/Multiperiod_DASH_Demo/index.mpd * Trying 54.186.133.224... * Connected to 111122223333444455556666123456789012.mediatailor.us-west-2.amazonaws.com (11.222.333.444) port 555 (#0) * TLS 1.2 connection using TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256 * Server certificate: mediatailor.us-west-2.amazonaws.com * Server certificate: Amazon * Server certificate: Amazon Root CA 1 * Server certificate: Starfield Services Root Certificate Authority - G2 > GET /v1/master/123456789012/Multiperiod_DASH_Demo/index.mpd HTTP/1.1 > Host: 111122223333444455556666123456789012.mediatailor.us-west-2.amazonaws.com > User-Agent: curl/7.43.0 > Accept: */* > < HTTP/1.1 504 Gateway Timeout < Date: Thu, 29 Nov 2018 18:43:14 GMT < Content-Type: application/json < Content-Length: 338 < Connection: keep-alive < x-amzn-RequestId: 123456789012-123456789012 < x-amzn-ErrorType: GatewayTimeoutException:http://internal.amazon.com/coral/com.amazon.elemental.midas.mms.coral/ < * Connection #0 to host 111122223333444455556666123456789012.mediatailor.us-west-2.amazonaws.com left intact {"message":"failed to generate manifest: Unable to obtain template playlist. origin URL:[https://777788889999.mediapackage.us-west-2.amazonaws.com/out/v1/444455556666111122223333/index.mpd], asset path: [index.mpd], sessionId:[123456789012123456789012] customerId:[123456789012]"}%