ApolloFederationTracingExtension

This extension adds support for Apollo Federation inline tracing (FTV1). When a request includes the apollo-federation-include-trace: ftv1 header, the extension records per-resolver timing and includes the trace in the response as a base64-encoded protobuf under extensions.ftv1.

Any client can send the apollo-federation-include-trace: ftv1 header unless you restrict it. Tracing payloads expose resolver timing details, so make sure only a trusted Apollo Gateway (or other internal traffic) can request traces — for example by enforcing authentication, network policy, or stripping the header from public requests at the edge.

Make sure you have protobuf installed before using this extension.

pip install 'strawberry-graphql[apollo-federation]'

Usage example:

import strawberry
from strawberry.extensions.tracing import ApolloFederationTracingExtension


@strawberry.type
class Query:
    @strawberry.field
    def hello(self) -> str:
        return "Hello, world!"


schema = strawberry.Schema(
    Query,
    extensions=[
        ApolloFederationTracingExtension,
    ],
)

If you are not running in an Async context then you'll need to use the sync version:

import strawberry
from strawberry.extensions.tracing import ApolloFederationTracingExtensionSync


@strawberry.type
class Query:
    @strawberry.field
    def hello(self) -> str:
        return "Hello, world!"


schema = strawberry.Schema(
    Query,
    extensions=[
        ApolloFederationTracingExtensionSync,
    ],
)

API reference:

No arguments