トラブルシューティング
このドキュメントでは、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_idとcloned_from値が一致するか確認- 必須フィールドがすべて入力されているか確認
設定問題
Config Store値が適用されない
症状: Config Storeを設定したが値が反映されません。
解決方法:
- Config StoreがCompute Serviceに正しく接続されているか確認
- KeyとValueが正しく入力されているか確認
- Compute Purgeを実行したか確認
- Compute Purge完了後、十分な時間(数分)待機
Compute Purgeが完了しない
症状: Compute Purgeが長くかかる、または完了しません。
解決方法:
- Purge状態を確認し、完了するまで待機
- Purgeが失敗した場合、再試行
- Fastlyサービス状態確認
関連ドキュメント
- インストールと初期化: インストールと設定ガイド
- 初期化設定: Config Store設定
- FAQ: 追加FAQとヘルプ