Skip to content

OpenTelemetry: metrics for ActivityPub collections #777

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
dahlia merged 10 commits into from
May 25, 2026
Merged

OpenTelemetry: metrics for ActivityPub collections #777

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
10 commits
Select commit Hold shift + click to select a range
1b57c9d
Add collection metric instruments
dahlia May 24, 2026
aad994d
Record collection dispatch metrics
dahlia May 24, 2026
b843c6a
Document collection metrics
dahlia May 24, 2026
3fba894
Defer custom collection metrics
dahlia May 25, 2026
dec47ba
Fix custom collection metrics
dahlia May 25, 2026
91acb27
Document collection meter providers
dahlia May 25, 2026
6f56e1e
Record filtered collection item counts
dahlia May 25, 2026
7be48c7
Harden filtered collection metric assertions
dahlia May 25, 2026
2c74e20
Type custom collection meter access
dahlia May 25, 2026
6534413
Normalize custom total item metrics
dahlia May 25, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
21 changes: 21 additions & 0 deletions CHANGES.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -66,6 +66,25 @@ To be released.
deliberately exclude raw URLs, query strings, and identifier values to
keep cardinality bounded. [[#316], [#736], [#757]]

- Added OpenTelemetry metrics for ActivityPub collection requests handled
by `Federation.fetch()` and custom collection handlers:

- `activitypub.collection.request` (counter)
- `activitypub.collection.dispatch.duration` (histogram)
- `activitypub.collection.page.items` (histogram)
- `activitypub.collection.total_items` (histogram)

The metrics expose bounded collection dimensions:
`activitypub.collection.kind`, `activitypub.collection.page`,
`activitypub.collection.result`, `fedify.collection.dispatcher`, and
optional `http.response.status_code`. Built-in collections are classified
Comment thread
dahlia marked this conversation as resolved.
as `inbox`, `outbox`, `following`, `followers`, `liked`, `featured`, or
`featured_tags`; application-defined collection routes are collapsed into
`custom`. Collection IDs, cursors, custom route names, actor identifiers,
and full URLs are deliberately excluded so dashboards can aggregate
collection rate, latency, item counts, and `totalItems` values without
attacker-controlled cardinality. [[#316], [#741], [#777]]

- Added OpenTelemetry queue task metrics covering Fedify's enqueue and
worker boundaries for inbox, outbox, and fanout work:

Expand Down Expand Up @@ -208,6 +227,7 @@ To be released.
[#738]: https://github.com/fedify-dev/fedify/issues/738
[#739]: https://github.com/fedify-dev/fedify/issues/739
[#740]: https://github.com/fedify-dev/fedify/issues/740
[#741]: https://github.com/fedify-dev/fedify/issues/741
[#742]: https://github.com/fedify-dev/fedify/issues/742
[#748]: https://github.com/fedify-dev/fedify/pull/748
[#752]: https://github.com/fedify-dev/fedify/issues/752
Expand All @@ -220,6 +240,7 @@ To be released.
[#770]: https://github.com/fedify-dev/fedify/pull/770
[#771]: https://github.com/fedify-dev/fedify/pull/771
[#772]: https://github.com/fedify-dev/fedify/pull/772
[#777]: https://github.com/fedify-dev/fedify/pull/777

### @fedify/fixture

Expand Down
196 changes: 126 additions & 70 deletions docs/manual/opentelemetry.md
View file
Open in desktop

Large diffs are not rendered by default.

Loading
Loading