翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

Functions のトラブルシューティングとモニタリング

このページは、一般的な関数エラーを診断し、本番環境で関数のパフォーマンスをモニタリングするのに役立ちます。トラブルシューティングセクションは症状別に整理されています。観察した内容から始めて、原因と修正に従ってください。

モニタリング

CloudWatch メトリクス

MediaTailor は、関数実行のメトリクスを Amazon CloudWatch に発行します。オプトインは必要ありません。

フックレベルのメトリクス — ライフサイクルフック実行ごとに 1 つのデータポイント:

関数レベルのメトリクス — 関数実行ごとに 1 つのデータポイント:

アラームの設定とこれらのメトリクスの操作の詳細については、「」を参照してくださいAmazon CloudWatch メトリクス AWS Elemental MediaTailor によるモニタリング。

ログイベント

MediaTailor は、関数実行のログイベントを発行します。エラーイベントはデフォルトで出力されます。完了したイベントと概要イベントはオプトインされます。

オプトインログイベントを有効にするには、「」を参照してくださいAmazon CloudWatch メトリクス AWS Elemental MediaTailor によるモニタリング。

eventId フィールドを使用して、同じ実行のフックレベルイベントと関数レベルのイベントを関連付けます。

次の Amazon CloudWatch Logs Insights クエリは、関数エラーイベントを でフィルタリングeventIdして、単一の実行をトレースします。

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

トラブルシューティング

関数が失敗すると、MediaTailor はエラーイベントに errorTypeフィールドを記録します。このフィールドを使用して、障害のクラスを特定します。

エントリは症状別に整理され、必要に応じてこれらのエラータイプを参照します。

式が予期せず null を返す

症状: 入力されるはずの出力値がプレイヤーパラメータであるか、null不足しています。

考えられる原因:

RESOURCE_LIMIT_ERROR: スタックオーバーフロー

症状: 関数は errorType: "RESOURCE_LIMIT_ERROR"と で失敗しますcause: "Stack overflow error"。

原因: 式がスタックの最大深度である 100 レベルを超えました。これは通常、深くネストされた条件式 (if/then/else) または複雑な変数割り当てで発生します。

つまり、式には MediaTailor が処理するネストのレベルが多すぎます。

修正: 式を簡素化します。複雑なロジックを複数の出力エントリまたはシーケンシャルエグゼキュター内の複数のステップに分割します。

RESOURCE_LIMIT_ERROR: CPU タイムアウト

症状: 関数は errorType: "RESOURCE_LIMIT_ERROR"と で失敗しますcause: "Expression evaluation timeout: Check for infinite loop"。

原因: 式が 100 ミリ秒の CPU 時間制限を超えました。これは、大規模なデータ構造に対して高価な計算を実行する式で発生する可能性があります。

修正: 式の複雑さを軽減します。大きな配列を処理する場合は、そのロジックを外部サービスに移動し、 HTTP_REQUEST関数を使用して呼び出すことを検討してください。

RESTRICTION_ERROR: 関数は許可されていません

症状: 関数は errorType: "RESTRICTION_ERROR"と で失敗しますcause: "Function '<name>' is not allowed"。

原因: 式は、38 個の関数の許可されたリストに含まれていない JSONata 関数を呼び出します。一般的な例には、$filter、$reduce、$eval、$split、および があります$join。

修正: ブロックされた関数名の causeフィールドを確認します。許可された代替手段に置き換えます。38 個の許可された関数の完全なリストJSONata 式リファレンスについては、「」を参照してください。

一般的に使用される許可された関数には$string、、$number、$substring、$contains、および が含まれます$encodeUrlComponent。

RESTRICTION_ERROR: 式が長すぎます

症状: 関数は での作成または更新に失敗しますcause: "Expression length <actual> exceeds limit <limit>"。

原因: 単一の式が 1,000 文字を超えています。

修正: 式を小さな部分に分割します。複数の出力エントリを使用するか、シーケンシャルエグゼキュター内の複数のステップにロジックを分割します。変数バインディング (:=) を使用して、長い部分式が繰り返されないようにします。

HTTP エラー: ステータスコードが null

症状: 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 が正常かどうかを確認します。API が遅いRequestTimeoutMilliseconds場合は を増やし、高速に失敗する場合は減らすことを検討してください。

HTTP エラー: レスポンス本文が null

症状: 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 検証の失敗

症状: 関数は実行時に失敗し、URL の形式が正しくないか、無効なスキームを使用しているか、最大長を超えています。

考えられる原因:

VALIDATION_ERROR

症状: 関数は で失敗しますerrorType: "VALIDATION_ERROR"。このエラーは、作成時 (関数を作成または更新するとき) または実行時 (セッション中に関数を実行するとき) に発生する可能性があります。

考えられる原因:

エラーログイベントの cause フィールドを確認します。どのフィールドまたは式が検証に失敗したかを識別します。

INTERNAL_ERROR

症状: 関数は で失敗しますerrorType: "INTERNAL_ERROR"。

原因: 関数設定に関連しないインフラストラクチャの障害が発生しました。

修正: リクエストを再試行します。エラーが解決しない場合は、 AWS サポートにお問い合わせください。