Changelog: Inspect Cache Keys with Cloudflare Trace (#27001)

* Changelog: Inspect Cache Keys with Cloudflare Trace

* Update src/content/changelog/cache/2025-11-07-cache-keys-for-cloudflare-trace.mdx

* Apply suggestions from code review

---------

Co-authored-by: angelampcosta <[email protected]>

Author: tkornhammar

src/content/changelog/cache/2025-11-07-cache-keys-for-cloudflare-trace.mdx

@@ -0,0 +1,41 @@
+---
+title: Inspect Cache Keys with Cloudflare Trace
+description: View the specific cache key generated for requests to troubleshoot caching behavior and rules configuration.
+products:
+  - cache
+date: 2025-11-07
+---
+
+You can now see the exact cache key generated for any request directly in Cloudflare Trace. This visibility helps you troubleshoot cache hits and misses, and verify that your Custom Cache Keys — configured via Cache Rules or Page Rules — are working as intended.
+
+Previously, diagnosing caching behavior required inferring the key from configuration settings. Now, you can confirm that your custom logic for headers, query strings, and device types is correctly applied.
+
+Access Trace via the [dashboard](/rules/trace-request/how-to/#use-trace-in-the-dashboard) or [API](/api/resources/request_tracer/methods/trace/), either manually for ad-hoc debugging or automated as part of your quality-of-service monitoring.
+
+## Example scenario
+
+If you have a Cache Rule that segments content based on a specific cookie (for example, `user_region`), run a Trace with that cookie present to confirm the `user_region` value appears in the resulting cache key.
+
+The Trace response includes the cache key in the `cache` object:
+
+```json
+{
+  "step_name": "request",
+  "type": "cache",
+  "matched": true,
+  "public_name": "Cache Parameters",
+  "cache": {
+    "key": {
+      "zone_id": "023e105f4ecef8ad9ca31a8372d0c353",
+      "scheme": "https",
+      "host": "example.com",
+      "uri": "/images/hero.jpg"
+    },
+    "key_string": "023e105f4ecef8ad9ca31a8372d0c353::::https://example.com/images/hero.jpg:::::"
+  }
+}
+```
+
+## Get started
+
+To learn more, refer to the [Trace documentation](/rules/trace-request/) and our guide on [Custom Cache Keys](/cache/how-to/cache-keys/).