`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 .

Warning

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.

Note

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,
    ],
)

Note

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