Client awareness

The 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 will be able to 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]

Configuring metrics collectors

Health check