Skip to content

feat(Seer): Added GCP for Seer integration docs - #19563

Open
sfanahata wants to merge 3 commits into
masterfrom
sanahata/feat/seer-GCP-integration
Open

sfanahata wants to merge 3 commits into
masterfrom
sanahata/feat/seer-GCP-integration

Conversation

@sfanahata

Copy link
Copy Markdown
Contributor

DESCRIBE YOUR PR

Updated docs to include GCP for Seer integration.

IS YOUR CHANGE URGENT?

Help us prioritize incoming PRs by letting us know when the change needs to go live.
Select exactly one option. For deadlines, replace YYYY-MM-DD with the due date. You can update this information later by editing the PR description.

  • Urgent deadline (GA date, etc.): YYYY-MM-DD
  • Other deadline: 2026-09-28
  • No deadline: Not urgent, can wait up to 1 week+

SLA

  • Teamwork makes the dream work, so please add a reviewer to your PRs.
  • Please give the docs team up to 1 week to review your PR unless you've supplied a deadline.

Thanks in advance for your help!

PRE-MERGE CHECKLIST

Make sure you've checked the following before merging your changes:

  • Checked Vercel preview for correctness, including links
  • PR was reviewed and approved by any necessary SMEs (subject matter experts)
  • PR was reviewed and approved by a member of the Sentry docs team

@vercel

vercel Bot commented Sep 22, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated
sentry-docs Ready Ready Preview Sep 22, 2026 10:03pm UTC
1 Skipped Deployment
Project Deployment Actions Updated
develop-docs Ignored Ignored Preview Sep 22, 2026 10:03pm UTC

Request Review

@codeowner-assignment
codeowner-assignment Bot requested a review from a team September 22, 2026 17:44
@github-actions github-actions Bot added the Priority: Deadline Docs review has a specific non-urgent due date label Sep 22, 2026
Comment thread docs/integrations/debugging/gcp-seer/index.mdx Outdated
Comment thread docs/integrations/debugging/gcp-seer/index.mdx Outdated
Comment thread docs/integrations/debugging/gcp-seer/index.mdx Outdated
Comment thread docs/integrations/debugging/gcp-seer/index.mdx Outdated
Comment thread docs/integrations/debugging/gcp-seer/index.mdx Outdated
@shashjar
shashjar requested a review from srest2021 September 22, 2026 18:57
Comment thread docs/integrations/debugging/gcp-seer/index.mdx
Comment on lines +62 to +64
Copy the **Sentry Service Account email** from the Sentry integration setup modal, and apply it as the principal. Assign the **Service Account Token Creator** role (`roles/iam.serviceAccountTokenCreator`) and click **Save**.

**Grant this role on your service account itself.** This limits the impersonation grant to the account you created for the integration.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Could just be me / the fact that I don't have GCP open but I'm a bit confused about the "your service account itself" wording. Does this mean: make sure you grant this role to the created service account? From what I see in the docs it seems like you first have to select the created service account anyway to grant the role to the Sentry service account. If yes, I think this last paragraph could be taken out

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@shashjar - what do you think? I wasn't quite sure, as I didn't run through a GCP setup (don't have an account). I assumed what we were trying to say was that the role needs to be on the service account vs in a project. But I do agree that we could get clarification here and either nix the sentence or better word it.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Yeah agreed this is a bit confusing since there's 2 service accounts to keep straight. I think using the phrase "service account you created" makes it clearer that we're referring to the customer-side service account, not the service account we generated for them and manage on our side.

How about something like this?

7. Authorize the **Sentry Service Account** to impersonate **your service account**.

In the Google Cloud console:
1. Open **IAM & Admin > Service Accounts** and select the project containing the service account you created for this integration.
2. Open **Permissions** for that service account, find **Principals with access to this service account**, and click **Grant access**.
3. Enter the **Sentry Service Account email** shown in the Sentry integration setup modal as the principal.
4. Select **Service Account Token Creator** (roles/iam.serviceAccountTokenCreator) and click **Save**.

I think the most succinct way to say it is: Grant the **Sentry service account** the **Service Account Token Creator** (roles/iam.serviceAccountTokenCreator) role on the service account you created for this integration. This allows Sentry to impersonate that account in order to query your GCP data.. I think most GCP admins should understand the role they need to grant, and the principals involved. Open to thoughts on how much hand-holding/detail is really necessary.

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Yep, I like that. Reads much better. Updated!

This branch was successfully deployed

1 active deployment
Preview – sentry-docs 2b42fb76 Deployed Sep 22, 2026 by vercel[bot]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Priority: Deadline Docs review has a specific non-urgent due date

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants