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

トラブルシューティング

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


インストールと初期化

Fastly CLIインストール失敗

症状: Fastly CLIインストールが失敗する、またはコマンドが見つかりません。

解決方法:

  • Homebrewがインストールされているか確認
  • brew install fastly/tap/fastly コマンドを再実行
  • ターミナルを再起動して再試行

Compute Service作成失敗

症状: Compute Service作成が失敗します。

解決方法:

  • FastlyアカウントでCompute Servicesサポートが有効化されているか確認
  • Service nameが有効か確認
  • ドメインが正しく入力されているか確認

CNAME登録失敗

症状: CNAME登録が失敗する、またはTLS証明書が発行されません。

解決方法:

  • DNS providerでCNAMEレコードが正しく設定されているか確認
  • CNAME値がFastlyから提供された値と一致するか確認
  • DNS伝播時間を考慮して十分な時間待機

動作問題

待機列が適用されない

症状: トリガールールを設定したが待機列が適用されません。

解決方法:

  • NetFUNNELコンソールでセグメントトリガールールが正しく設定されているか確認
  • URLがトリガールールと一致するか確認
  • Config StoreのCLIENT_ID設定が正しいか確認
  • Compute Serviceにエージェントが正しくデプロイされているか確認
  • Compute Purgeを実行して変更を適用

待機室にリダイレクトされない

症状: 待機応答を受信したが待機室にリダイレクトされません。

解決方法:

  • Config StoreのVWR_PAGE_DOMAIN設定確認
  • Compute Serviceのhost設定確認
  • Compute Purge状態確認

デプロイ問題

エージェントデプロイ失敗

症状: fastly compute deploy コマンドが失敗します。

解決方法:

  • Fastly APIトークンが正しく設定されているか確認
  • fastly.tomlファイルのservice_idが正しいか確認
  • Fastly CLIが最新バージョンか確認
  • ネットワーク接続状態確認

tomlファイルエラー

症状: tomlファイルを修正したがデプロイが失敗します。

解決方法:

  • tomlファイルの構文が正しいか確認
  • service_idcloned_from値が一致するか確認
  • 必須フィールドがすべて入力されているか確認

設定問題

Config Store値が適用されない

症状: Config Storeを設定したが値が反映されません。

解決方法:

  • Config StoreがCompute Serviceに正しく接続されているか確認
  • KeyとValueが正しく入力されているか確認
  • Compute Purgeを実行したか確認
  • Compute Purge完了後、十分な時間(数分)待機

Compute Purgeが完了しない

症状: Compute Purgeが長くかかる、または完了しません。

解決方法:

  • Purge状態を確認し、完了するまで待機
  • Purgeが失敗した場合、再試行
  • Fastlyサービス状態確認

関連ドキュメント