post (@post@lemmy.ml)
Fedify 1.10.0: Observability foundations for the future debug dashboard
https://lemmy.ml/post/40746886
Show Original Post
post (@post@lemmy.ml)
Fedify 1.10.0: Observability foundations for the future debug dashboard
https://lemmy.ml/post/40746885
Show Original Post
fedify (@fedify@hollo.social)
Fedify 1.10.0: Observability foundations for the future debug dashboard
Fedify is a #TypeScript framework for building #ActivityPub servers that participate in the #fediverse. It reduces the complexity and boilerplate typically required for ActivityPub implementation while providing comprehensive federation capabilities.
We're excited to announce #Fedify 1.10.0, a focused release that lays critical groundwork for future debugging and observability features. Released on December 24, 2025, this version introduces infrastructure improvements that will enable the upcoming debug dashboard while maintaining full backward compatibility with existing Fedify applications.
This release represents a transitional step toward Fedify 2.0.0, introducing optional capabilities that will become standard in the next major version. The changes focus on enabling richer observability through OpenTelemetry enhancements and adding prefix scanning capabilities to the key–value store interface.
Enhanced OpenTelemetry instrumentation
Fedify 1.10.0 significantly expands OpenTelemetry instrumentation with span events that capture detailed ActivityPub data. These enhancements enable richer observability and debugging capabilities without relying solely on span attributes, which are limited to primitive values.
The new span events provide complete activity payloads and verification status, making it possible to build comprehensive debugging tools that show the full context of federation operations:
activitypub.activity.receivedevent onactivitypub.inboxspan — records the full activity JSON, verification status (activity verified, HTTP signatures verified, Linked Data signatures verified), and actor informationactivitypub.activity.sentevent onactivitypub.send_activityspan — records the full activity JSON and target inbox URLactivitypub.object.fetchedevent onactivitypub.lookup_objectspan — records the fetched object's type and complete JSON-LD representation
Additionally, Fedify now instruments previously uncovered operations:
activitypub.fetch_documentspan for document loader operations, tracking URL fetching, HTTP redirects, and final document URLsactivitypub.verify_key_ownershipspan for cryptographic key ownership verification, recording actor ID, key ID, verification result, and the verification method used
These instrumentation improvements emerged from work on issue #234 (Real-time ActivityPub debug dashboard). Rather than introducing a custom observer interface as originally proposed in #323, we leveraged Fedify's existing OpenTelemetry infrastructure to capture rich federation data through span events. This approach provides a standards-based foundation that's composable with existing observability tools like Jaeger, Zipkin, and Grafana Tempo.
Distributed trace storage with FedifySpanExporter
Building on the enhanced instrumentation, Fedify 1.10.0 introduces FedifySpanExporter, a new OpenTelemetry SpanExporter that persists ActivityPub activity traces to a KvStore. This enables distributed tracing support across multiple nodes in a Fedify deployment, which is essential for building debug dashboards that can show complete request flows across web servers and background workers.
The new @fedify/fedify/otel module provides the following types and interfaces:
import { MemoryKvStore } from "@fedify/fedify";
import { FedifySpanExporter } from "@fedify/fedify/otel";
import {
BasicTracerProvider,
SimpleSpanProcessor,
} from "@opentelemetry/sdk-trace-base";
const kv = new MemoryKvStore();
const exporter = new FedifySpanExporter(kv, {
ttl: Temporal.Duration.from({ hours: 1 }),
});
const provider = new BasicTracerProvider();
provider.addSpanProcessor(new SimpleSpanProcessor(exporter));The stored traces can be queried for display in debugging interfaces:
// Get all activities for a specific trace
const activities = await exporter.getActivitiesByTraceId(traceId);
// Get recent traces with summary information
const recentTraces = await exporter.getRecentTraces({ limit: 100 });The exporter supports two storage strategies depending on the KvStore capabilities. When the list() method is available (preferred), it stores individual records with keys like [prefix, traceId, spanId]. When only cas() is available, it uses compare-and-swap operations to append records to arrays stored per trace.
This infrastructure provides the foundation for implementing a comprehensive debug dashboard as a custom SpanExporter, as outlined in the updated implementation plan for issue #234.
Optional list() method for KvStore interface
Fedify 1.10.0 adds an optional list() method to the KvStore interface for enumerating entries by key prefix. This method enables efficient prefix scanning, which is useful for implementing features like distributed trace storage, cache invalidation by prefix, and listing related entries.
interface KvStore {
// ... existing methods
list?(prefix?: KvKey): AsyncIterable<KvStoreListEntry>;
}When the prefix parameter is omitted or empty, list() returns all entries in the store. This is useful for debugging and administrative purposes. All official KvStore implementations have been updated to support this method:
MemoryKvStore— filters in-memory keys by prefixSqliteKvStore— usesLIKEquery with JSON key patternPostgresKvStore— uses array slice comparisonRedisKvStore— usesSCANwith pattern matching and key deserializationDenoKvStore— delegates to Deno KV's built-inlist()APIWorkersKvStore— uses Cloudflare Workers KVlist()with JSON key prefix pattern
While list() is currently optional to give existing custom KvStore implementations time to add support, it will become a required method in Fedify 2.0.0 (tracked in issue #499). This migration path allows implementers to gradually adopt the new capability throughout the 1.x release cycle.
The addition of list() support was implemented in pull request #500, which also included the setup of proper testing infrastructure for WorkersKvStore using Vitest with @cloudflare/vitest-pool-workers.
NestJS 11 and Express 5 support
Thanks to a contribution from Cho Hasang (@crohasang), the @fedify/nestjs package now supports NestJS 11 environments that use Express 5. The peer dependency range for Express has been widened to ^4.0.0 || ^5.0.0, eliminating peer dependency conflicts in modern NestJS projects while maintaining backward compatibility with Express 4.
This change, implemented in pull request #493, keeps the workspace catalog pinned to Express 4 for internal development and test stability while allowing Express 5 in consuming applications.
What's next
Fedify 1.10.0 serves as a stepping stone toward the upcoming 2.0.0 release. The optional list() method introduced in this version will become required in 2.0.0, simplifying the interface contract and allowing Fedify internals to rely on prefix scanning being universally available.
The enhanced #OpenTelemetry instrumentation and FedifySpanExporter provide the foundation for implementing the debug dashboard proposed in issue #234. The next steps include building the web dashboard UI with real-time activity lists, filtering, and JSON inspection capabilities—all as a separate package that leverages the standards-based observability infrastructure introduced in this release.
Depending on the development timeline and feature priorities, there may be additional 1.x releases before the 2.0.0 migration. For developers building custom KvStore implementations, now is the time to add list() support to prepare for the eventual 2.0.0 upgrade. The implementation patterns used in the official backends provide clear guidance for various storage strategies.
Acknowledgments
Special thanks to Cho Hasang (@crohasang) for the NestJS 11 compatibility improvements, and to all community members who provided feedback and testing for the new observability features.
For the complete list of changes, bug fixes, and improvements, please refer to the CHANGES.md file in the repository.
Show Original Post
ishii00141 (@ishii00141@mastodon.social)
RE: https://ishii00141.stars.ne.jp/20251224-0707-4873/
#WordPress の #プラグイン #ActivityPub に新たなバグ。
記事中のハッシュタグを拾う際に、WordPressのタグのIDで拾っているのか、記事中に#27～とか#30～とかあると、ID=27やID=30のタグをハッシュタグと認識して拾ってしまう。「～」の部分に条件があるのは分からないけれど、私が試したケースでは「～」は「ae60;」だった。
Show Original Post
20251224-0707-4873 (@20251224-0707-4873@ishii00141.stars.ne.jp)
特定のタグが勝手に付けられるバグが再現されるかテスト？
#ActivityPub #WordPress #テスト #ハッシュタグ #バグ #仕様
テスト１：新規投稿で任意の６個のタグを付けてみる。
テスト１の結果：タグの数は関係なさそう。
https://ishii00141.stars.ne.jp/20251224-0707-4873/Show Original Post
NetscapeNavigator (@NetscapeNavigator@social.vivaldi.net)
💸 Unlock More Support for Your Fediverse Instance! 💸
Dear Admins,
Allowing users to donate any amount can significantly boost your support. Pre-set fixed amounts might limit contributions and discourage potential donors.
I frequently use Visa, Mastercard, Discover, and American Express gift cards, often donating the remaining balances. While a single card might not seem like much, using a dozen or more can add up to a significant contribution. 😇
#Fediverse #Misskey #Mastodon #ActivityPub #Donation #Contribution #Charity #FediAdmin
Show Original Post
daltux (@daltux@snac.daltux.net)
Content warning:Lamento sobre teimosias de Mastodon
🌡️ Gostaria que várias pessoas que, especificamente, usam #Mastodon e comentam, hoje, sobre calor soubessem que tenho "reagido" com este emoji: :fine: (o meme "this is fine"). Porém, não vão ficar sabendo disso.
⏳️ Mais um ano se vai e, ao contrário de vários outros sistemas,
, o mais comum na nossa querida Web Social federada, permanece sem deixar publicar Markdown, embora exiba o de terceiros. Neste caso, que considero pior, ainda não ocorre sequer um aviso a quem o utiliza de que houve um #EmojiReact de suas publicações. 🔕Sim, essa funcionalidade acaba de ser implementada pelo SNAC (merci @vi@downbad.fr 👏), nem foi lançada ainda e já estou me gabando por utilizá-lo!
Gostei muito de poder reagir assim às publicações, como já era possível em outros como #Pleroma, #Akkoma, #Misskey etc. Mas #SNAC, embora, até então, não exibisse
EmojiReact junto à publicação correspondente, já gerava notificação de sua ocorrência faz tempo. Achava que no Mastodon isso ficasse sempre como se fosse uma curtida, mas, apenas ao testar isso, notei que não surte qualquer efeito. O mais curioso é que consta uma estrutura de dados que serviria para isso desde Mastodon 3.1.0.#SocialWeb #Fediverso #Fediverse #ActivityPub #diversidade #blambers #dev
Show Original Post
jansenspott (@jansenspott@ruhr.social)
Hm, ob mein Blog in diesem Jahr noch die 100 Follower hier im Fediverse zusammen bekommt? Ich bin gespannt, Ihr auch?
#bloggen #blog #fediverse #activitypub
Show Original Post
hongminhee (@hongminhee@hollo.social)
Found this helpful resource by Ben Boyter (@boyter): a collection of sequence diagrams explaining how #ActivityPub/#WebFinger works in practice—covering post creation, follows, boosts, deletions, and user migration.
If you're trying to implement ActivityPub, the spec can be frustratingly vague, and different servers do things differently. This aims to be a “clean room” reference for getting federation right.
https://github.com/boyter/activitypub
Show Original Post
fedify (@fedify@hollo.social)
According to @tchambers's My 2026 Open Social Web Predictions:
Fedify will power the federation layer for at least one mid-sized social platform (500K+ users) that adds ActivityPub support in 2026. The “build vs. buy” calculation for federation shifts decisively toward “just use Fedify.”
We're honored by this recognition and will keep working hard to make #ActivityPub adoption easier for everyone. Thank you, Tim!
Show Original Post
eyeinthesky (@eyeinthesky@mastodon.social)
Do any non-Pixelfed server implementations interoperate with the Pixelfed #ActivityPub protocol extensions?
Show Original Post
mikka (@mikka@mstdn.social)
When I see and read what and how some people comment on the efforts of good people to bridge gaps between "the fediverse" and the outer world (where it makes sense) and inside "the fediverse" itself between the various bubbles I feel a strong urge to stop my own personal efforts and quit altogether. Merry, peaceful christmas!
#fediverse #activitypub
@gelbphoenix
@julian
Show Original Post