Adding guidance on using Durable Object logs in the dashboard.

Author: Oxyjun

src/content/docs/durable-objects/observability/graphql-analytics.mdx

@@ -6,7 +6,7 @@ sidebar:
 
 ---
 
-import { GlossaryTooltip, DashButton } from "~/components";
+import { GlossaryTooltip, DashButton, Steps, WranglerConfig } from "~/components";
 
 <GlossaryTooltip term="Durable Object">Durable Objects</GlossaryTooltip> expose analytics for Durable Object namespace-level and request-level metrics.
 
@@ -21,15 +21,49 @@ A Durable Object namespace is a set of Durable Objects that can be addressed by
 
 Per-namespace analytics for Durable Objects are available in the Cloudflare dashboard. To view current and historical metrics for a namespace:
 
+<Steps>
 1. In the Cloudflare dashboard, go to the **Durable Objects** page.
 
    <DashButton url="/?to=/:account/workers/durable-objects" />
 2. View account-level Durable Objects usage.
-3. Select an existing namespace.
+3. Select an existing Durable Object namespace.
 4. Select the **Metrics** tab.
+</Steps>
 
 You can optionally select a time window to query. This defaults to the last 24 hours.
 
+## View Durable Object logs from the dashboard
+
+You can view Durable Object logs from the Cloudflare dashboard. Logs are aggregated by the script name and the Durable Object class name.
+
+To start using Durable Object logging:
+
+<Steps>
+1. Enable Durable Object logging in the Wrangler configuration file of the Worker that defines your Durable Object class:
+   <WranglerConfig>
+   ```jsonc
+   {
+       "observability": {
+           "enabled": true
+       }
+   }
+   ```
+   </WranglerConfig>
+2. Deploy the latest version of the Worker with the updated binding.
+3. Go to the **Durable Objects** page.
+
+   <DashButton url="/?to=/:account/workers/durable-objects" />
+4. Select an existing Durable Object namespace.
+5. Select the **Logs** tab.
+   - You can use the Durable Object instance ID (displayed as `$workers.durableObjectId`) to understand which specific Durable Object instance generated the log entry.
+
+6. (Optional) Use filters and the search bar to quickly find the log event you are looking for.
+</Steps>
+
+:::note
+For information on log limits (such as maximum log retention period), refer to the [Workers Logs documentation](/workers/observability/logs/workers-logs/#limits).
+:::
+
 ## Query via the GraphQL API
 
 Durable Object metrics are powered by GraphQL.