Skip to content

Commit c1a2f0c

Browse files
authored
docs(self-hosted): Troubleshooting guide to invalidate projectconfigs (#15377)
<!-- Use this checklist to make sure your PR is ready for merge. You may delete any sections you don't need. --> ## DESCRIBE YOUR PR Closes getsentry/self-hosted#3977 Preview URL: https://develop-docs-git-aldy505-self-hostedmissing-project-config.sentry.dev/self-hosted/troubleshooting/sentry/#relay-rejects-envelope-events ## IS YOUR CHANGE URGENT? Help us prioritize incoming PRs by letting us know when the change needs to go live. - [ ] Urgent deadline (GA date, etc.): <!-- ENTER DATE HERE --> - [ ] Other deadline: <!-- ENTER DATE HERE --> - [x] None: 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 added an urgent due date to it. 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](https://github.com/orgs/getsentry/teams/docs)
1 parent 2bfe39a commit c1a2f0c

File tree

1 file changed

+15
-0
lines changed
  • develop-docs/self-hosted/troubleshooting

1 file changed

+15
-0
lines changed

develop-docs/self-hosted/troubleshooting/sentry.mdx

Lines changed: 15 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -69,3 +69,18 @@ Some known paths where you may see this error:
6969
* _static/dist/sentry/entrypoints/app.js
7070

7171
To fix this, you can disable the auto optimization performed by your CDN.
72+
73+
## Relay rejects envelope events
74+
75+
If you're seeing the following error in your Relay logs:
76+
```
77+
ERROR relay_server::services::projects::cache::service: failed to fetch project from source: Fetch { project_key: ProjectKey("00000000000000000000000000000000"), previous_fetch: None, initiated: Instant { tv_sec: 16838910, tv_nsec: 923025932 }, when: Some(Instant { tv_sec: 16839069, tv_nsec: 382950946 }), revision: Revision(None) } tags.project_key="00000000000000000000000000000000" tags.has_revision=false error=upstream error failed to send message to service error.sources=[failed to send message to service]
78+
```
79+
80+
This means Relay is unable to fetch the project configuration from Redis. This can happen if the worker (in the `taskworker` container) is lagging behind, making it unable to write new project configurations to Redis, which Relay then cannot fetch.
81+
82+
To fix this, you can trigger a manual project configuration invalidation by running the following command. Warning: This will temporarily halt event ingestion until the project configurations are written to Redis again.
83+
84+
```bash
85+
docker compose exec web ./bin/invalidate-project-configs
86+
```

0 commit comments

Comments
 (0)