[DOCS-13743] EXP- GA BigQuery guide #35455
Merged
Conversation
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
iadjivon
changed the title
Contributor
Preview links (active after the
|
|
|
||
| ## Step 3: Grant IAM roles to the service account | ||
|
|
||
| In addition to the permissions described in the [Google Cloud Platform integration page][1], the Datadog Experiments service account requires the following permissions: |
Contributor
There was a problem hiding this comment.
@chasdevs does this sentence contradict with line 24: "If you're only using the Google Cloud integration for warehouse native experiment analysis, you can opt out of collecting other resources."
I guess we're recommending to still give all of the permissions, even if we're not using them to collect other resources?
There was a problem hiding this comment.
Can we just say "Datadog Experiments requires some additional permissions for the service account you are using..."?
chasdevs
approved these changes
Mar 24, 2026
| @@ -0,0 +1,81 @@ | |||
| --- | |||
| title: Connect BigQuery for Warehouse Native Experiment Analysis | |||
There was a problem hiding this comment.
@lukasgoetzweiss The Snowflake docs (PR: #35422 (review)) use hyphenated "Warehouse-Native" but this does not. What should we do?
|
|
||
| Once you have created a service account, continue on to the next section. | ||
|
|
||
| <div class="alert alert-info">If you're only using the Google Cloud integration for warehouse native experiment analysis, you can opt out of collecting other resources.</div> |
There was a problem hiding this comment.
Nit: Jeff flagged that "opt out" was confusing because there are toggles in the UI; he suggested using clearer language here like "disable" or "toggle off".
|
|
||
| ## Step 3: Grant IAM roles to the service account | ||
|
|
||
| In addition to the permissions described in the [Google Cloud Platform integration page][1], the Datadog Experiments service account requires the following permissions: |
There was a problem hiding this comment.
Can we just say "Datadog Experiments requires some additional permissions for the service account you are using..."?
| 1. [BigQuery Job User][4] — allows the service account to run BigQuery jobs. | ||
| 1. [BigQuery Data Owner][5] - grants the service account full access to the Datadog Experiments output dataset. | ||
| 1. [Storage Object User][6] - allows the service account to read and write objects in the storage bucket used by Datadog Experiment. | ||
| 1. [BigQuery Data Viewer][7] - allows the service account to read table used in warehouse native metrics. |
There was a problem hiding this comment.
Where's this coming from? I think if we have BigQuery Data Owner you don't need this.
Contributor
There was a problem hiding this comment.
My understanding is that you need Data Owner on the output dataset, and data viewer on datasets you intend to use when creating metric SQL models. Am I thinking about that wrong?
…, added the overview sentence to match the other guides.
iadjivon
force-pushed
the
ida.adjivon/DOCS-13743-BigQuery-guide-expga
branch
from
d4b5c29 to
d714b7e
Compare
lukasgoetzweiss
approved these changes
Mar 30, 2026
iadjivon
commented
Mar 31, 2026
OliviaShoup
reviewed
Mar 31, 2026
OliviaShoup
reviewed
Mar 31, 2026
jeff-morgan-dd
requested changes
Mar 31, 2026
Contributor
jeff-morgan-dd
left a comment
jeff-morgan-dd
left a comment
There was a problem hiding this comment.
Just see one note on the Snowflake page - thanks!
Co-authored-by: jeff-morgan-dd <jeff.morgan@datadoghq.com>
jeff-morgan-dd
approved these changes
Mar 31, 2026
StefonSimmons
pushed a commit
that referenced
this pull request
Apr 16, 2026
* [DOCS-13743] Add BigQuery guide placeholder with frontmatter Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com> * [DOCS-13743] Add BigQuery guide content (WIP) Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com> * added bigquery to the guide index, moved the file to the guide folder, added the overview sentence to match the other guides. * pulled in static as well * reconfigured steps and modified overview section * style edits * added steps and images from gc console * added images and moved content * modified permissions needed * edits from review * new image and anchor links modified * quick fixed * Apply suggestion from @iadjivon * changes the snowflake name on the index page to match the others. * quick modifications and refreshed the image * Update content/en/experiments/guide/connecting_snowflake.md Co-authored-by: jeff-morgan-dd <jeff.morgan@datadoghq.com> --------- Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com> Co-authored-by: jeff-morgan-dd <jeff.morgan@datadoghq.com>
genesor
pushed a commit
that referenced
this pull request
Apr 19, 2026
* [DOCS-13743] Add BigQuery guide placeholder with frontmatter Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com> * [DOCS-13743] Add BigQuery guide content (WIP) Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com> * added bigquery to the guide index, moved the file to the guide folder, added the overview sentence to match the other guides. * pulled in static as well * reconfigured steps and modified overview section * style edits * added steps and images from gc console * added images and moved content * modified permissions needed * edits from review * new image and anchor links modified * quick fixed * Apply suggestion from @iadjivon * changes the snowflake name on the index page to match the others. * quick modifications and refreshed the image * Update content/en/experiments/guide/connecting_snowflake.md Co-authored-by: jeff-morgan-dd <jeff.morgan@datadoghq.com> --------- Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com> Co-authored-by: jeff-morgan-dd <jeff.morgan@datadoghq.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
5 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What does this PR do? What is the motivation?
Fixes DOCS-13743
Adds a new guide for connecting Google BigQuery to Datadog Experiments for warehouse-native experiment analysis. The guide covers GCP service account setup, dataset permissions, and Datadog configuration.
Merge instructions
Merge readiness: