メインコンテンツまでスキップ
バージョン: 4.6.1-saas

トラブルシューティング

このドキュメントでは、NetFUNNEL CloudFront Agent使用中に発生する可能性のある一般的な問題と解決方法を提供します。


インストールと初期化

Lambda関数デプロイ失敗

症状: Lambda関数バージョン作成またはデプロイが失敗します。

解決方法:

  • package.jsonファイルの形式が正しいか確認
  • Lambda関数コードに構文エラーがないか確認
  • IAMロールの権限が正しく設定されているか確認
  • Lambda関数がus-east-1リージョンで作成されているか確認

IAMロール設定エラー

症状: Lambda関数作成時にIAMロールエラーが発生します。

解決方法:

  • Trust Entityにedgelambda.amazonaws.comlambda.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サービス状態確認

関連ドキュメント