Skip to content

Commit c9c18c1

Browse files
committed
Updates
1 parent a8214b1 commit c9c18c1

File tree

3 files changed

+20
-13
lines changed

3 files changed

+20
-13
lines changed

articles/frontdoor/front-door-caching.md

Lines changed: 18 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -17,23 +17,23 @@ zone_pivot_groups: front-door-tiers
1717

1818
In this article, you'll learn how Azure Front Door Standard and Premium tier routes and rule sets behave when you have caching enabled. Azure Front Door is a modern Content Delivery Network (CDN) with dynamic site acceleration and load balancing.
1919

20-
## Caching architecture
20+
::: zone-end
2121

22-
When caching is configured on your route, Front Door uses a multi-tier caching architecture. When a request is received, the edge site that receives the request checks its cache for a valid response. If none is available, it also checks a regional cache. This approach helps to reduce the amount of traffic sent to your origin server. If no cached response is available, the request is forwarded to the origin.
22+
::: zone pivot="front-door-classic"
2323

24-
Each Front Door edge site manages its own cache, and requests might be served by different edge sites. As a result, you might still see some traffic reach your origin, even if you served cached responses.
24+
The following document specifies behaviors for Azure Front Door (classic) with routing rules that have enabled caching. Front Door is a modern Content Delivery Network (CDN) with dynamic site acceleration and load balancing, it also supports caching behaviors just like any other CDN.
2525

26-
## Request methods
26+
::: zone-end
2727

28-
Only requests that use the `GET` request method are cacheable. All other request methods are always proxied through the network.
28+
## Caching architecture
2929

30-
::: zone-end
30+
When caching is configured on your route, the edge site that receives each request checks its cache for a valid response. Caching helps to reduce the amount of traffic sent to your origin server. If no cached response is available, the request is forwarded to the origin.
3131

32-
::: zone pivot="front-door-classic"
32+
Each Front Door edge site manages its own cache, and requests might be served by different edge sites. As a result, you might still see some traffic reach your origin, even if you served cached responses.
3333

34-
The following document specifies behaviors for Azure Front Door (classic) with routing rules that have enabled caching. Front Door is a modern Content Delivery Network (CDN) with dynamic site acceleration and load balancing, it also supports caching behaviors just like any other CDN.
34+
## Request methods
3535

36-
::: zone-end
36+
Only requests that use the `GET` request method are cacheable. All other request methods are always proxied through the network.
3737

3838
## Delivery of large files
3939

@@ -202,12 +202,19 @@ If the origin response is cacheable, then the `Set-Cookie` header is removed bef
202202

203203
In addition, Front Door attaches the `X-Cache` header to all responses. The `X-Cache` response header includes one of the following values:
204204

205-
- `TCP_HIT`: The first byte of the request is a cache hit in the Front Door edge.
206-
- `TCP_REMOTE_HIT`: The first byte of the request is a cache hit in the regional cache (origin shield layer) but a miss in the edge cache.
205+
- `TCP_HIT` or `TCP_REMOTE_HIT`: The first byte of the request is a cache hit, and content is served from the Front Door cache.
207206
- `TCP_MISS`: The first byte of the request is a cache miss, and the content is served from the origin.
208207
- `PRIVATE_NOSTORE`: Request can't be cached because the *Cache-Control* response header is set to either *private* or *no-store*.
209208
- `CONFIG_NOCACHE`: Request is configured to not cache in the Front Door profile.
210209

210+
::: zone pivot="front-door-standard-premium"
211+
212+
## Logs and reports
213+
214+
The [Front Door Access Log](how-to-logs.md#access-log) includes the cache status for each request. Also, [reports](standard-premium/how-to-reports.md#caching) include information about how Front Door's cache is used in your application.
215+
216+
::: zone-end
217+
211218
## Cache behavior and duration
212219

213220
::: zone pivot="front-door-standard-premium"

articles/frontdoor/standard-premium/how-to-logs.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -78,7 +78,7 @@ Azure Front Door currently provides individual API requests with each entry havi
7878
| Endpoint | The domain name of AFD endpoint, for example, contoso.z01.azurefd.net |
7979
| HttpStatusCode | The HTTP status code returned from Azure Front Door. If a request to the the origin timeout, the value for HttpStatusCode is set to **0**.|
8080
| Pop | The edge pop, which responded to the user request. |
81-
| Cache Status | Provides the status code of how the request gets handled by the CDN service when it comes to caching. Possible values are HIT: The HTTP request was served from AFD edge POP cache. <br> **MISS**: The HTTP request was served from origin. <br/> **PARTIAL_HIT**: Some of the bytes from a request got served from AFD edge POP cache while some of the bytes got served from origin for object chunking scenarios. <br> **CACHE_NOCONFIG**: Forwarding requests without caching settings, including bypass scenario. <br/> **PRIVATE_NOSTORE**: No cache configured in caching settings by customers. <br> **REMOTE_HIT**: The request was served by parent node cache. <br/> **N/A**:** Request that was denied by Signed URL and Rules Set. |
81+
| Cache Status | Provides the status code of how the request gets handled by the CDN service when it comes to caching. Possible values are:<ul><li>`HIT` and `REMOTE_HIT`: The HTTP request was served from the Front Door cache.</ul><ul>`MISS`: The HTTP request was served from theorigin.</li><li> `PARTIAL_HIT`: Some of the bytes from a request were served from the Front Door cache, and some of the bytes were served from origin. This status occurs in [object chunking](../front-door-caching.md#delivery-of-large-files) scenarios.</li><li>`CACHE_NOCONFIG`: Request was forwarded without caching settings, including bypass scenario.</li><li>`PRIVATE_NOSTORE`: No cache configured in caching settings by customers.</li><li>`N/A`: The request was denied by a signed URL and rules engine. |
8282
| MatchedRulesSetName | The names of the rules that were processed. |
8383
| RouteName | The name of the route that the request matched. |
8484
| ClientPort | The IP port of the client that made the request. |

articles/frontdoor/standard-premium/how-to-reports.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -171,7 +171,7 @@ Cache Hits/Misses describe the request number cache hits and cache misses for cl
171171

172172
This report takes caching scenarios into consideration and requests that met the following requirements are taken into calculation.
173173

174-
* The requested content was cached on the POP closest to the requester or origin shield.
174+
* The requested content was cached on a Front Door PoP.
175175

176176
* Partial cached contents for object chunking.
177177

0 commit comments

Comments
 (0)