Apollo Router

Apollo Router - v2 (latest)

Overview Get Started Request Lifecycle

Configuration

Overview Hot Reload Environment Variable Reference CLI Reference YAML Reference

Features

Security

Overview Persisted Queries Authorization

Authentication

JWT Authentication Router Authentication Subgraph Authentication

CORS CSRF Prevention TLS Request Limits Demand Control

Observability

Studio Insights

Overview Operation Metrics Reporting Federated Trace Data

Router Telemetry (OTEL)

Telemetry Data

Metrics

Instruments Standard Instruments

Traces

Spans Standard Attributes

Conditions Selectors

Usage Guides

Subgraph Observability

Subgraph Error Inclusion Debugging Subgraph Requests Instrumenting Subgraphs

Client Observability

Debugging Client Requests Client ID Enforcement

Telemetry Exporters

Metrics Exporters

Log Exporters

Overview Stdout

Trace Exporters

APM Guides

Datadog

Connecting to Datadog

Overview OpenTelemetry Collector

Datadog Agent

Router Instrumentation Dashboard Template

New Relic

Prometheus

Metrics Trace Metrics

Jaeger

Dynatrace

Performance and Scaling

Response Caching

Overview Quickstart Invalidation Customization Observability FAQ

Traffic Shaping Query Batching Circuit Breaking

Client Features

APQ HTTP Header Propagation @defer

GraphQL Subscriptions

Overview Configuration Callback Protocol Multipart Protocol

HTTP Callback Best Practices

Overview Subscription Broker Pattern Guaranteed Delivery Pattern

Enable with API Gateway

Query Planning

Native Query Planner Best Practices Caching

Customization

Coprocessors

Coprocessor Configuration Coprocessor Reference

Rhai Scripts

Rhai Configuration Rhai API Reference

Custom Builds

Building a Binary Rust Plugins

Deployment

Docker

Docker with the Apollo Runtime Container Docker with Apollo Router

Kubernetes

Quickstart Deploying with Extensibility Enabling Metrics Other Considerations

AWS

Azure

Azure Container Apps

GCP

Google Cloud Run

Managed Hosting

Tools

Router Resource Estimator Health Checks Resource Management

Releases

Changelogs What's New in Router v2 Upgrade from Router v1 Upgrade from Router v2 Migrate from Gateway API Gateway Comparison

GraphOS Integration

GraphOS Plan License GraphOS Plan Features Apollo Uplink

Reference

Federation Version Support Errors

Products

Apollo GraphOS PlatformManage, observe, and scale your graph.Apollo ConnectorsConnect REST APIs to your graph declaratively.Apollo FederationFederate multiple subgraphs into a single supergraph.Rover CLIInteract with your graph from the command line.Apollo RouterRun and configure your graph gateway.Apollo OperatorDeploy and manage Apollo Router on Kubernetes.

Open source

Apollo Client (Web)Simplify GraphQL data management in web apps.Apollo iOSSwift-first GraphQL client for iOS.Apollo KotlinKotlin-first GraphQL client for Android and JVM.Apollo ServerBuild GraphQL servers with Node.js.Apollo MCP ServerExpose GraphQL tools to AI agents with MCP.IDE SupportEnhance your development workflow with IDE support.

Zipkin tracing

Configure tracing for Zipkin

Enable and configure tracing for Zipkin in GraphOS Router or Apollo Router Core.

For general tracing configuration, refer to Router Tracing Configuration.

OTLP configuration

Zipkin supports OTLP ingestion via zipkin-otel. Configure the router's OTLP exporter to send traces to Zipkin:

YAML

router.yaml

1telemetry:
2  exporters:
3    tracing:
4      otlp:
5        enabled: true
6        endpoint: "http://${env.ZIPKIN_HOST}:9411"
7        protocol: http

This sends traces to Zipkin using the OTLP protocol.

See OTLP configuration for more details on settings.

Give FeedbackFeedback