Docs
Launch GraphOS Studio
You're viewing documentation for a previous version of this software. Switch to the latest stable version.

Opt-in error reporting for managed federation


You can configure your managed gateway to send error reports to Apollo via out-of-band reporting. These reports help Apollo improve the performance and reliability of .

Enabling reporting

To enable out-of-band error reporting, set the following environment variable in your gateway's environment:

APOLLO_OUT_OF_BAND_REPORTER_ENDPOINT=https://outofbandreporter.api.apollographql.com

The next time you start up your gateway, out-of-band error reporting is enabled.

Note: If you've enabled out-of-band reporting in the past, you might have specified a URL that is now deprecated. Double-check your configuration to make sure you've specified the URL listed above.

How it works

Whenever your gateway fails to fetch its from Apollo due to an error, the out-of-band reporting mechanism sends an error report to Apollo as a .

The report provides the following information as :

  • The error code and message produced by the gateway
  • The HTTP Request URL and body
  • The HTTP Response status code and body
  • The started-at and end-at times of the request

It also provides the following HTTP headers:

  • apollographql-client-name: The name of the used by the Gateway
  • apollographql-client-version: The version number of the used by the Gateway
Previous
Deployment best practices
Next
Caching
Edit on GitHubEditForumsDiscord

© 2024 Apollo Graph Inc.

Privacy Policy

Company