Client awareness

Configure client awareness in Apollo Router

The Apollo Router supports client awareness by default. If the client sets the headers apollographql-client-name and apollographql-client-version in its HTTP requests, Apollo Studio can separate the metrics and queries per client.

Overriding client awareness headers

Different header names can be used by updating the configuration file. If those headers will be sent by a browser, they must be allowed in the CORS (Cross Origin Resource Sharing) configuration, as follows:

router.yaml

1
telemetry:
2
  apollo:
3
    # defaults to apollographql-client-name
4
    client_name_header: MyClientHeaderName
5
    # defaults to apollographql-client-version
6
    client_version_header: MyClientHeaderVersion
7
cors:
8
  # The headers to allow.
9
  # (Defaults to [ Content-Type ], which is required for Apollo Studio)
10
  allow_headers: [ Content-Type, MyClientHeaderName, MyClientHeaderVersion]

GraphOS reporting

Configuration