Skip to content

[DO] Add changelog for filtering metrics by ID or name#31316

Merged
iglesiasbrandon merged 11 commits into
productionfrom
changelog/do-metrics-filter-id-name
Jun 12, 2026
Merged

[DO] Add changelog for filtering metrics by ID or name#31316
iglesiasbrandon merged 11 commits into
productionfrom
changelog/do-metrics-filter-id-name

Conversation

@iglesiasbrandon

@iglesiasbrandon iglesiasbrandon commented Jun 8, 2026

Copy link
Copy Markdown
Collaborator

Summary

Adds a changelog entry for a new Durable Objects dashboard capability: filtering the Metrics tab to an individual Durable Object by its ID or name. Previously the metrics charts only showed aggregate, namespace-level data, which made it hard to investigate a single object.

Tracked internally as STOR-5275.

Documentation checklist

@github-actions

github-actions Bot commented Jun 8, 2026

Copy link
Copy Markdown
Contributor

This pull request requires reviews from CODEOWNERS as it changes files that match the following patterns:

Pattern Owners
/src/assets/images/ @cloudflare/pm-changelogs, @cloudflare/product-owners
/src/content/changelog/ @cloudflare/pm-changelogs, @cloudflare/product-owners
/src/content/docs/durable-objects/ @elithrar, @rita3ko, @irvinebroque, @vy-ton, @iglesiasbrandon, @joshthoward, @danlapid, @oxyjun, @lambrospetrou, @mikenomitch, @cloudflare/product-owners

@ask-bonk ask-bonk Bot added changelog Adds or updates changelog entries/pages. product:durable-objects Durable Objects: https://developers.cloudflare.com/workers/learning/using-durable-objects/ labels Jun 8, 2026

@ask-bonk ask-bonk Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Two minor style guide issues to address.

@ask-bonk

ask-bonk Bot commented Jun 8, 2026

Copy link
Copy Markdown
Contributor

Applied labels changelog and product:durable-objects.

Verdict: 2 minor style guide issues need fixing before merge.

Issues:

  • MEDIUM src/content/changelog/durable-objects/2026-06-08-durable-objects-metrics-filter-by-id-name.mdx:18 — "time-granularity" should be "time granularity" (hyphenate compound modifiers before a noun only).

  • MEDIUM src/content/changelog/durable-objects/2026-06-08-durable-objects-metrics-filter-by-id-name.mdx:20 — Link text should match the page title ("Metrics and analytics") and the standard phrasing drops "the" before the link: For more information, refer to [Metrics and analytics](/durable-objects/observability/metrics-and-analytics/).

Posted both fixes as inline suggestions on the PR.

github run

iglesiasbrandon and others added 3 commits June 8, 2026 15:33
…ts-metrics-filter-by-id-name.mdx

Co-authored-by: ask-bonk[bot] <249159057+ask-bonk[bot]@users.noreply.github.com>
…ts-metrics-filter-by-id-name.mdx

Co-authored-by: ask-bonk[bot] <249159057+ask-bonk[bot]@users.noreply.github.com>

<DashButton url="/?to=/:account/workers/durable-objects" />

Start typing an ID or name into the filter and select a match from the autocomplete dropdown. Every chart on the page updates to reflect only the selected object: requests, errors, billable duration, request wall time, requests by type, storage operations, and WebSockets. This makes it easier to identify and investigate a single Durable Object when debugging a hot instance, an error spike, or unexpected storage usage. Clear the filter to return to namespace-level metrics.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

select a match from the autocomplete dropdown

How does the autocomplete work? Is it filtered to objects with invocations during the selected time range? What if you enter a wrong object id or name?

Need to help user understand what if an object doesnt appear in the dropdown (doesnt mean object is deleted which some might think).

cc @apeacock1991 for UI behavior

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Is it filtered to objects with invocations during the selected time range?

Yup, and if you enter a wrong one, it will give you a small message indicating there are no results. I'll update it to include a note around the time range

iglesiasbrandon and others added 4 commits June 9, 2026 08:07
…ts-metrics-filter-by-id-name.mdx

Co-authored-by: Vy Ton <vy@cloudflare.com>
…ts-metrics-filter-by-id-name.mdx

Co-authored-by: Vy Ton <vy@cloudflare.com>
Updated the description of filtering metrics for Durable Objects to clarify the functionality and removed redundant information.
Updated description to clarify debugging scenarios for Durable Objects metrics filtering.
@iglesiasbrandon iglesiasbrandon requested a review from vy-ton June 12, 2026 13:30
@iglesiasbrandon iglesiasbrandon marked this pull request as ready for review June 12, 2026 14:14
@cloudflare-docs-bot

cloudflare-docs-bot Bot commented Jun 12, 2026

Copy link
Copy Markdown
Contributor

Review

💡 1 suggestion found in commit 6dc5353.

Suggestions (1)
File Issue
changelog/durable-objects/2026-06-12-durable-objects-metrics-filter-by-id-name.mdx line 18 Passive voice where active voice would be clearer — Line adds "Metrics are powered by the GraphQL Analytics API..." Fix: Rewrite in active voice: "The GraphQL Analytics API powers metrics, so standard analytics behavior..."
Commands

Only codeowners can run commands. Post a comment with the command to trigger it.

Command Description
/review Runs a review now. Incremental if a prior review exists, full if not.
/full-review Re-reviews the entire PR diff from scratch, ignoring incremental history. Useful after a rebase, when you want a fresh review, or if the bot gets out of sync and reports issues that no longer exist.

@iglesiasbrandon iglesiasbrandon enabled auto-merge (squash) June 12, 2026 14:36

@vy-ton vy-ton left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

conditional approve, do think we want to clarify the behavior of which objects appear


<DashButton url="/?to=/:account/workers/durable-objects" />

Start typing an ID or name into the filter and select a match from the autocomplete dropdown. Every chart on the page updates to reflect only the selected object. This makes it easier to identify and investigate a single Durable Object when debugging a high-traffic object, an error spike, or unexpected storage usage. Clear the filter to return to namespace-level metrics.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

would callout that only objects with invocations during the selected time range appear

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

ack, we will also make sure to incorporate some kind of warning in the UI so that users are not confused by this. thank you for calling this out!

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.


For more information, refer to [Metrics and analytics](/durable-objects/observability/metrics-and-analytics/).

![The Durable Objects Metrics tab filtered to a single object by ID, showing per-object requests and errors by invocation status.](~/assets/images/changelog/durable-objects/durable-objects-metrics-dashboard.png)

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

nit: put the image after the UI button

@iglesiasbrandon iglesiasbrandon merged commit 13cfcfa into production Jun 12, 2026
11 checks passed
@iglesiasbrandon iglesiasbrandon deleted the changelog/do-metrics-filter-id-name branch June 12, 2026 21:07
iglesiasbrandon added a commit that referenced this pull request Jun 15, 2026
* [DO] Address review feedback on metrics filter changelog

- Move the dashboard screenshot to immediately after the DashButton so
  readers see the UI before the description of how to use it.
- Note that the autocomplete only lists objects with invocations during
  the selected time range, so a missing object means no recent
  invocations rather than deletion.

Addresses post-merge review comments on #31316.

* [DO] Replace em dash with two sentences in metrics changelog

---------

Co-authored-by: iglesiasbrandon <5313116+iglesiasbrandon@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

changelog Adds or updates changelog entries/pages. product:changelog product:durable-objects Durable Objects: https://developers.cloudflare.com/workers/learning/using-durable-objects/ size/s

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants