tencent cloud

Tencent Cloud EdgeOne

セルフデバッグ

Download
Focus Mode
Font Size
Last updated: 2026-10-16 11:38:33
AI-Translated & Reviewed

機能概要

現在EdgeOne内で設定したノードキャッシュルール、カスタムCache Keyなどの設定がお客様のリソースに対して有効になっているかどうかを確認する必要がある場合、EdgeOneはセルフデバッグツールを提供しており、ノードキャッシュTTL、リソースがキャッシュ可能かどうか、Cache keyなどの情報を取得するのに役立ちます。業務設定のデバッグに便利です。セルフデバッグを有効にした後、指定したクライアントIPを使用してURLリクエストを開始し、リクエストにEO-Debug-Headers: all ヘッダーを含めることで、返されたレスポンスヘッダーに基づいて、該当リソースがノード内でキャッシュされているかどうか、対応するCache Key値、キャッシュ時間を確認できます。




使用シナリオ

コンソールのルールエンジンで複雑なキャッシュポリシーやカスタムcache keyを設定した場合、設定が有効になっているかどうかを確認する必要があるときは、この機能を使用して検証できます。

操作手順

例えば、現在のサイトexample.comのドメイン名www.example.comでは、.jpgサフィックスファイルに対してEdgeOneノード内で600秒間キャッシュするように設定されています。キャッシュCache Keyは指定パラメータaをキャッシュキーとして保持するように設定されています。設定完了後、現在の設定が有効になっているかどうかを確認する必要があります。以下の手順に従って検証できます:
1. EdgeOneコンソールにログインし、左側のメニューバーで「サービス概要」に入り、「SCDN」内で設定が必要なサイトをクリックします。
2. サイト詳細ページでサイト加速をクリックし、サイト全体設定ページに入り、右側のナビゲーションバーでセルフデバッグをクリックします。
3. セルフデバッグ設定カードを見つけ、「スイッチ」をクリックして、セルフデバッグ機能を有効にします。



4. デバッグモードを有効にした後、有効期間とアクセスを許可するクライアントソースを設定する必要があります。時間範囲は1~365日で、デフォルトは7日です。クライアントIPは100個入力でき、IPv4およびIPv6のIP/IPセグメントの入力に対応しています。0.0.0.0/0はすべてのIPv4クライアントによるデバッグを許可することを示し、::/0はすべてのIPv6クライアントによるデバッグを許可することを示します。



5. 保存をクリックすると、設定で許可されたクライアントIPは有効期間内にdebugデバッグを実行できます。
6. 上記で指定したクライアントIPソースを使用して、Mac/Linux環境でcurlリクエストを発行して検証します。例えば:
curl -voa 'http://www.example.com/test.jpg?a=1' -H 'EO-Debug-Headers: all'。リクエスト結果は以下の通りです:



レスポンスヘッダーで、該当リクエストに対応するCache Key、キャッシュ状態、キャッシュ時間を確認できます。これらは例の設定と一致しており、現在の設定が有効になっていることを示します。

関連参考

セルフデバッグモードを有効にしている場合、レスポンスのdebugヘッダーの説明は以下の通りです:
ヘッダー名
機能説明
戻り値の意味の説明
EO-Debug-Status
セルフデバッグモードが有効かどうかを示します。
on:有効状態であり、かつリクエストクライアントIPが許可リスト内にあり、リクエスト時間が有効期間内であること。
off:無効状態、または有効状態だがリクエスト時間が有効期間を超えていること。
forbidden:有効状態ですが、リクエストクライアントIPが許可リスト内にありません。
EO-Debug-ClientIp
Debugリクエストを開始したClientIpです。
Debugリクエストを開始したクライアントIPです。セルフデバッグを有効にしているがEO-Debug-Statusの値がforbiddenの場合、リクエストしたクライアントIPが許可されたIP/IPレンジ内にないかどうかを確認できます。
EO-Debug-Cacheable
今回のリクエストURLが、ノードキャッシュTTLの設定に従って、最終的にEdgeOneノード内でキャッシュ可能かどうかを示すステータスです。
yes:キャッシュ可能なコンテンツ
no:キャッシュ不可のコンテンツ
EO-Debug-CacheKey
今回のリクエストURLが、カスタムCache keyに従って、最終的にEdgeOneノード内で生成されたCache keyです。
例えば、www.example.com/test.jpg a=1は、このリクエストURLリソースがEdgeOne内で生成したCache Keyを指します。
EO-Debug-CacheTTL
今回のリクエストURLが、ノードキャッシュTTLの設定に従って、最終的にEdgeOneノードでキャッシュされるTTL時間です。
リスト値であり、数字と時間単位を含みます。dは日、hは時間、mは分、sは秒を表します。例えば:
3d0h0m0sはキャッシュTTLが3日であることを示します。
0d0h5m0sはキャッシュが5分であることを示します。
0d0h0m5sはキャッシュが5秒であることを示します。


Help and Support

Was this page helpful?

Help us improve! Rate your documentation experience in 5 mins.

Feedback