Router Logging
Configure logging in the Apollo Router
The Apollo Router provides built-in logging to capture records about the router's activity.
The router supports configurable log levels and stdout output of log messages (with configurable output formats).
Log level
The Apollo Router accepts a command-line argument to set its log level:
Name | Description |
---|---|
| The log level, indicating the most severe log message type to include. In ascending order of verbosity, can be one of: The default value is |
The router also accepts both RUST_LOG
and APOLLO_ROUTER_LOG
environment variables with the same possible values as the command-line argument. With multiple ways to set the log level, the router checks for them in the following order, and it uses the first one that is set:
RUST_LOG
- Command-line argument
APOLLO_ROUTER_LOG
RUST_LOG
is supported for advanced users with specific filtering requirements who may wish to see log messages from crates consumed by the router. Most users should use the command-line argument or APOLLO_ROUTER_LOG
. Both of these options constrain log output to the router.
For example, every environment variable and command-line argument below sets the log level to debug
:
RUST_LOG=apollo_router::debugAPOLLO_ROUTER_LOG=debug--log=debug
For another example, every line below sets the same log levels:
RUST_LOG=hyper=debug,apollo_router::info,h2=traceAPOLLO_ROUTER_LOG=hyper=debug,info,h2=trace--log=hyper=debug,info,h2=trace
In both examples, the actual filter used by the router the value defined by RUST_LOG
.
For more information about specifying filters for more granular control over Apollo Router logging, see the Env Logger documentation.
Logging common configuration
The router supports configuration options that apply to all logging exporters:
Service name
Set a service name for your router's logs so they can be easily searched and found in your metrics dashboards.
The service name can be set by an environment variable or in router.yaml
. With multiple ways to set the service name, the router checks for them in the following order, and it uses the first one that is set:
OTEL_SERVICE_NAME
environment variableOTEL_RESOURCE_ATTRIBUTES
environment variabletelemetry.exporters.logging.common.service_name
inrouter.yaml
telemetry.exporters.logging.common.resource
inrouter.yaml
If the service name isn't explicitly set, then it is set by default to unknown_service:apollo_router
(or unknown_service
if the executable name cannot be determined).
Resource attribute
A resource attribute is a set of key-value pairs that provide additional information to an exporter. Application performance monitors (APM) may interpret and display resource information.
In router.yaml
, resource attributes are set in telemetry.exporters.logging.common.resource
. For example:
telemetry:exporters:logging:common:resource:"environment.name": "production""environment.namespace": "{env.MY_K8_NAMESPACE_ENV_VARIABLE}"
For OpenTelemetry conventions for resources, see Resource Semantic Conventions.
Request/Response logging
This feature is experimental. Your questions and feedback are highly valued—don't hesitate to get in touch with your Apollo contact or on the official Apollo GraphQL Discord. If you want to give feedback or participate in the feature, feel free to join the discussion on GitHub.
By default, the router doesn't log the following values that might contain sensitive data, even if a sufficient log level is set:
- Request bodies
- Response bodies
- Headers
You can enable selective logging of these values via the experimental_when_header
option:
telemetry:exporters:logging:# If one of these headers matches we will log supergraph and subgraphs requests/responsesexperimental_when_header:- name: apollo-router-log-requestvalue: my_clientheaders: true # default: falsebody: true # default: false# log request for all requests coming from Iphones- name: user-agentmatch: ^Mozilla/5.0 (iPhone*headers: true
Logging common reference
Attribute | Default | Description |
---|---|---|
service_name | unknown_service:router | The OpenTelemetry service name. |
service_namespace | The OpenTelemetry namespace. | |
resource | The OpenTelemetry resource to attach to generated log events. |
Experimental logging of broken pipe errors
You can emit a log message each time the client closes the connection early, which can help you debug issues with clients that close connections before the server can respond.
This feature is disabled by default but can be enabled by setting the experimental_log_broken_pipe
option to true
:
supergraph:experimental_log_on_broken_pipe: true
Attribute | Default | Description |
---|---|---|
experimental_log_on_broken_pipe | false | Emit a log message if a broken pipe was detected. |