C3 CloudFront Cache Controller

日本語

English

日本語

English

Appearance

トラブルシューティング ​

このガイドでは、C3 CloudFront Cache Controllerの一般的な問題を診断し、解決する方法について説明します。

一般的な問題 ​

プラグインが動作しない ​

症状 ​

  • 投稿を公開してもキャッシュ無効化が発生しない
  • 管理画面にアクティビティが表示されない
  • エラーメッセージがない

診断 ​

  1. プラグインの有効化をチェック：

    bash
    wp plugin list | grep c3-cloudfront

  2. WordPressパーマリンク構造を確認：

    • 設定 > パーマリンク に移動
    • 「プレーン」に設定されていないことを確認

  3. PHPエラーログをチェック：

    bash
    tail -f /path/to/wp-content/debug.log

解決策 ​

パーマリンク構造の問題:

php
// wp-config.phpに追加して現在の構造をチェック
echo get_option('permalink_structure');

// 空の場合、プレーンパーマリンクの問題です

プラグインの競合:

bash
# 最小限のプラグインでテスト
wp plugin deactivate --all
wp plugin activate c3-cloudfront-clear-cache

PHPバージョン:

bash
# PHPバージョンをチェック（最小7.4が必要、8.2まで対応）
php -v

PHP 8.2 対応

プラグインにはセキュリティ強化機能とXMLパースィング改善が含まれており、PHP 8.2と完全に互換性があります。XML関連の問題が発生した場合は、最新バージョン（7.0.1以上）を使用していることを確認してください。

AWS認証情報の問題 ​

症状 ​

  • 「無効な認証情報」エラーメッセージ
  • 403 Forbiddenエラー
  • 認証失敗

診断 ​

  1. 認証情報設定をチェック：

    bash
    wp c3 flush 1

  2. 環境変数を確認：

    bash
    echo $AWS_ACCESS_KEY_ID
echo $AWS_SECRET_ACCESS_KEY
echo $C3_DISTRIBUTION_ID

  3. AWS CLIアクセスをテスト（利用可能な場合）：

    bash
    aws sts get-caller-identity
aws cloudfront list-distributions

解決策 ​

環境変数が設定されていない:

bash
# .bashrc、.zshrc、またはサーバー設定に追加
export AWS_ACCESS_KEY_ID="your_access_key"
export AWS_SECRET_ACCESS_KEY="your_secret_key"
export C3_DISTRIBUTION_ID="your_distribution_id"

IAM権限の問題:

IAMユーザー/ロールに以下のポリシーがあることを確認：

json
{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "cloudfront:CreateInvalidation",
                "cloudfront:GetInvalidation",
                "cloudfront:ListInvalidations"
            ],
            "Resource": "arn:aws:cloudfront::*:distribution/YOUR_DISTRIBUTION_ID"
        }
    ]
}

EC2インスタンスロールの問題:

bash
# インスタンスメタデータサービスをテスト
curl http://169.254.169.254/latest/meta-data/iam/security-credentials/

CloudFront Distributionの問題 ​

症状 ​

  • 「Distribution not found」エラー
  • 無効化リクエストが失敗
  • 404エラー

診断 ​

  1. Distribution IDを確認：

    bash
    # WordPress管理画面で確認
wp option get c3_distribution_id

  2. AWSコンソールでディストリビューションの存在を確認

  3. ディストリビューションのステータスをチェック：

    bash
    aws cloudfront get-distribution --id YOUR_DISTRIBUTION_ID

解決策 ​

無効なDistribution ID:

bash
# 正しいDistribution IDを設定
wp c3 update distribution_id E1234567890123

ディストリビューションが削除されている:

  • AWSコンソールで新しいディストリビューションを作成
  • 新しいDistribution IDでプラグインを更新

ネットワーク接続の問題 ​

症状 ​

  • タイムアウトエラー
  • 接続エラー
  • 遅いレスポンス

診断 ​

  1. 基本的な接続性をテスト：

    bash
    curl -I https://cloudfront.amazonaws.com

  2. ファイアウォール設定を確認：

    bash
    # アウトバウンドHTTPSトラフィックが許可されているか確認
telnet cloudfront.amazonaws.com 443

  3. DNS解決をテスト：

    bash
    nslookup cloudfront.amazonaws.com

解決策 ​

タイムアウト設定の調整:

php
// wp-config.phpに追加
define('C3_HTTP_TIMEOUT', 60); // 60秒に増加

プロキシ設定（必要な場合）:

php
// wp-config.phpに追加
define('C3_HTTP_PROXY', 'http://proxy.example.com:8080');

パフォーマンスの問題 ​

症状 ​

  • 無効化が遅い
  • 大量の無効化リクエストが失敗
  • メモリ使用量が高い

診断 ​

  1. 現在の設定を確認：

    bash
    wp option get c3_invalidation_item_limits
wp option get c3_invalidation_interval

  2. サーバーリソースを監視：

    bash
    # メモリ使用量をチェック
free -h

# CPU使用量をチェック
top

  3. WordPress cronの状態を確認：

    bash
    wp cron event list

解決策 ​

バッチサイズの調整:

php
// 高トラフィックサイト用にバッチサイズを増加
add_filter('c3_invalidation_item_limits', function($limits) {
    return 500; // バッチあたり500パス
});

無効化頻度の調整:

php
// 無効化頻度を調整
add_filter('c3_invalidation_interval', function($interval_minutes) {
    return 5; // 5分ごとに処理
});

メモリ制限の増加:

php
// wp-config.phpに追加
define('WP_MEMORY_LIMIT', '256M');

ログとデバッグ ​

ログの有効化 ​

php
// wp-config.phpに追加
define('WP_DEBUG', true);
define('WP_DEBUG_LOG', true);

// C3ログを有効化
add_filter('c3_log_invalidation_list', '__return_true');

ログの確認 ​

  1. C3無効化ログ：

    • WordPress管理画面で 設定 > C3 CloudFront Cache
    • 無効化ログセクションを確認

  2. サーバーログ：

    bash
    # Apache
tail -f /var/log/apache2/error.log

# Nginx
tail -f /var/log/nginx/error.log

一般的なエラーメッセージ ​

エラーメッセージ原因解決策
Invalid credentialsAWS認証情報が無効認証情報を確認・更新
Distribution not foundDistribution IDが無効正しいDistribution IDを設定
Permission deniedIAM権限が不足IAMポリシーを確認・更新
Network timeoutネットワーク接続の問題タイムアウト設定を調整
Rate limit exceededAPI制限に達した無効化頻度を調整

予防的メンテナンス ​

定期的なチェック ​

  1. 週次チェック:

    bash
    # プラグインの状態を確認
wp plugin status c3-cloudfront-clear-cache

# 設定を確認
wp option get c3_distribution_id

  2. 月次チェック:

    • AWS CloudFrontコストを確認
    • 無効化ログを確認
    • パフォーマンスメトリクスを確認

バックアップと復元 ​

bash
# 設定のバックアップ
wp option get c3_distribution_id > c3_backup.txt
wp option get c3_access_key >> c3_backup.txt
wp option get c3_secret_key >> c3_backup.txt

# 設定の復元
wp c3 update distribution_id $(grep distribution_id c3_backup.txt | cut -d' ' -f2)

XMLセキュリティとパースィング問題 ​

症状 ​

  • CloudFrontレスポンスでのXMLパースィングエラー
  • XML処理に関するセキュリティ警告
  • PHP 8.1以上での互換性問題

背景 ​

バージョン7.0.1以降、プラグインにはXXE（XML外部エンティティ）攻撃を防ぐセキュアなXMLパースィング機能が強化され、PHP 8.2との互換性が向上しています。

解決策 ​

最新バージョンに更新:

bash
# バージョン7.0.1以上を使用していることを確認
wp plugin update c3-cloudfront-clear-cache

XML処理をチェック:

php
// XML問題のデバッグのためにwp-config.phpに追加
define('WP_DEBUG', true);
define('WP_DEBUG_LOG', true);

libxml設定を確認:

bash
# libxmlバージョンを確認（セキュアパースィングをサポートしている必要があります）
php -m | grep libxml
php -r "phpinfo();" | grep -i libxml

次のステップ ​

問題が解決しない場合は、以下を試してください：

  1. GitHub Issuesで問題を報告
  2. WordPress.org Supportでサポートを受ける
  3. 開発者ドキュメントで高度な設定を確認

Released under the GPL License.

Copyright © 2025 DigitalCube Co., Ltd.