Join us for GraphQL Summit, October 10-12 in San Diego. Use promo code ODYSSEY for $400 off your pass.
Launch GraphOS Studio

Forwarding metrics to Datadog

For enterprise graphs

⚠️ Datadog forwarding is available only for Enterprise plans. It is not available for cloud s.

The Apollo Datadog integration enables you to forward your enterprise graph's performance metrics to your Datadog account. Datadog supports an advanced function API, which enables you to create sophisticated visualizations and alerts for GraphQL metrics.

Important: only forwards metrics for named GraphQL operations. Metrics for anonymous s are not forwarded. Make sure your graph's clients name all operations:

query {
query HelloQuery {


To integrate with Datadog, you provide your Datadog API key and region to Studio. A Datadog account with administrator privileges is required to obtain an API key.

  1. Go to your Datadog Integrations page and select Apollo from the list:

    Datadog integration tile

    Then go to the Configuration tab and click Install Integration at the bottom.

  2. Go to your Datadog APIs page and create an API key:

    Datadog API key list
  3. Determine your Datadog API region by looking at your browser's address bar:

    • If the domain name is, then your API region is US.
    • If the domain name is, then your API region is EU.
  4. In Apollo Studio, go to your graph's Settings page, then go to This Graph > Reporting:

    Graph settings page in Studio with Datadog section

    If you don't see a Datadog Forwarding section on this page, the feature isn't available as part of your organization's plan. Datadog forwarding requires an Enterprise plan.

  5. In the Datadog Forwarding section, click Configure. Provide your API key and region, then click Enable.

    Datadog configuration dialog

    You can use the same Datadog API key for all of your graphs, because all forwarded metrics are tagged with the corresponding graph's ID (graph:<graph-id>).

  6. That's it! After about five minutes, your Datadog metrics will begin showing metrics forwarded from Studio.

Forwarded metrics

Studio forwards the following metrics to Datadog:

apollo.operations.countThe number of GraphQL operations that were executed. This includes queries, mutations, and operations that resulted in an error.
apollo.operations.error_countThe number of GraphQL operations that resulted in an error. This includes both GraphQL execution errors and HTTP errors if Studio failed to connect to your server.
apollo.operations.cache_hit_countThe number of GraphQL queries for which the result was served from Apollo Server's full query cache.
A histogram of GraphQL operation response times, measured in milliseconds. Because of Studio's aggregation method (logarithmic binning), these values are accurate to +/- 5%.

These metrics are aggregated in 60-second intervals and tagged with the GraphQL as operation:<query-name>. Unique query signatures with the same are merged, and queries without an operation name are ignored.

These metrics are also tagged with both the associated Apollo graph ID (as graph:<graph-id>) and the associated name (as variant:<variant-name>). If you haven't set a name, then current is used.

If you set up your integration before October 2020, the metric names start with apollo.engine.operations instead of apollo.operations, and use a service:<graph-id> tag instead of graph:<graph-id>. This is called "legacy mode". You may transition your graph to modern mode by clicking the "Transition to modern mode" button on your graph's Integrations page. This is a one-way change; you should be prepared to update any dashboards and metrics to use the new metric and tag names when you click the button.

Exploring metrics

In the Datadog metrics explorer, all Studio metrics are tagged with the graph ID (graph:<graph-id>), the name (variant:<variant-name>), and the (operation:<query-name>). These values are normalized according to Datadog naming requirements (all letters are lowercase, and illegal symbols are converted to underscores).

Tagging enables you to see data at any level of granularity, whether you want to aggregate across all s or zoom in to a particular operation. You can control granularity by choosing a relevant set of operation tags for filtering, along with appropriate functions for time aggregation and space aggregation. Similarly, if you want to compare metrics across staging and production environments, you can filter with the appropriate tags.


Suppose you want to see the 95th percentile request latency averaged across all s for a staging and a production graph.

In the Datadog metrics explorer:

  1. In the Graph , select apollo.operations.latency.95percentile.
  2. In the Over , select the name of the graph to display.
  3. In the One graph per , select variant. Choose the s for your production and staging environments.
  4. In the On each graph, aggregate with the , select Average of reported values.

At Apollo, we use Studio to monitor Studio itself, so this graph for us looks like the following:

p95 latency graph

To generate more advanced reports, open up a Datadog notebook.

Alerting with Datadog

You can configure complex alerts with Datadog monitors.

Example #1

Studio's Notifications feature supports alerts that trigger when the percentage of requests with an error in the last 5 minutes exceeds some threshold for a specific . Suppose that instead of alerting on a specific operation in the last 5 minutes, we want to alert on the error percentage over all s in some graph in the last 10 minutes, such as when the percentage exceeds 1% for a graph mygraph with staging.

The Datadog metric alert query needed here is:

sum(last_10m):sum:apollo.operations.error_count{graph:mygraph,variant:staging}.as_count().rollup(sum).fill(null) / sum:apollo.operations.count{graph:mygraph,variant:staging}.as_count().rollup(sum).fill(null) > 0.01

The .rollup(sum).fill(null) is necessary because apollo.operations.count is a Datadog gauge, which means it defaults to using avg for time aggregation and defaults to linear interpolation during space aggregation and query arithmetic. The .as_count() is necessary to ensure that operation counts are summed before the division and not after.

Example #2

Consider the error percentage monitor from the previous example. When the number of s is small, a few errors might cause the error percentage to exceed the threshold, resulting in a noisy monitor during periods of low traffic. We want to alert only when the number of s isn't small (e.g., more than 10 in the last 10 minutes).

You can use Datadog composite monitors to support this kind of alert. First, create a monitor with the following metric alert query:

sum(last_10m):sum:apollo.operations.count{graph:mygraph,variant:staging}.rollup(sum).fill(null) > 10

Then create a composite monitor for the two monitors of the form a && b, which will have the desired behavior.

Sending metrics to GraphOS
Operation signatures
Edit on GitHubEditForumsDiscord