トラブルシューティング
このドキュメントでは、NetFUNNEL CloudFront Agent使用中に発生する可能性のある一般的な問題と解決方法を提供します。
インストールと初期化
Lambda関数デプロイ失敗
症状: Lambda関数バージョン作成またはデプロイが失敗します。
解決方法:
package.jsonファイルの形式が正しいか確認- Lambda関数コードに構文エラーがないか確認
- IAMロールの権限が正しく設定されているか確認
- Lambda関数がus-east-1リージョンで作成されているか確認
IAMロール設定エラー
症状: Lambda関数作成時にIAMロールエラーが発生します。
解決方法:
- Trust Entityに
edgelambda.amazonaws.comとlambda.amazonaws.comが含まれているか確認 - IAMポリシーが正しく添付されているか確認
- CloudWatchログ権限が含まれているか確認
動作問題
待機列が適用されない
症状: トリガールールを設定したが待機列が適用されません。
解決方法:
- NetFUNNELコンソールでセグメントトリガールールが正しく設定されているか確認
- URLがトリガールールと一致するか確認
- Lambda関数の
clientID設定が正しいか確認 - CloudFront DistributionにLambda@Edgeが正しく接続されているか確認
- CloudFront無効化が完了しているか確認
待機室にリダイレクトされない
症状: 待機応答を受信したが待機室にリダイレクトされません。
解決方法:
- Lambda関数の
vwrPageDomain設定確認 - CloudFront DistributionのLambda@Edge接続確認
- CloudFront無効化状態確認
ネットワーク問題
Lambda@Edge実行失敗
症状: Lambda@Edgeが実行されない、またはエラーが発生します。
解決方法:
- Lambda関数コードにエラーがないか確認
- Lambda関数がus-east-1リージョンで作成されているか確認
- IAMロールとポリシー設定確認
- CloudWatchログでエラーメッセージ確認
設定問題
Lambda config値が適用されない
症状: Lambda configを設定したが値が反映されません。
解決方法:
- Lambda関数で[Deploy]ボタンをクリックしたか確認
- [バージョン]タブで[新しいバージョンを発行]をクリックしたか確認
- CloudFront DistributionでLambda関数バージョンを更新したか確認
- CloudFront無効化を実行したか確認
- CloudFront無効化完了後、十分な時間(数分)待機
CloudFront無効化が完了しない
症状: CloudFront無効化が長くかかる、または完了しません。
解決方法:
- 無効化状態を確認し、完了するまで待機
- 無効化が失敗した場合、再試行
- CloudFrontサービス状態確認
関連ドキュメント
- インストールと初期化: インストールと設定ガイド
- 初期化設定: Lambda config設定
- FAQ: 追加FAQとヘルプ