From 568048cfd0b7c10abfb9651e1965b8c0b6f78534 Mon Sep 17 00:00:00 2001 From: Reinaldy Rafli Date: Thu, 30 Jan 2025 07:52:41 +0700 Subject: [PATCH 1/2] docs(self-hosted): troubleshooting guide for errors caused of minified assets by CDNs Closes https://github.com/getsentry/self-hosted/issues/2962 --- develop-docs/self-hosted/troubleshooting/sentry.mdx | 10 ++++++++++ 1 file changed, 10 insertions(+) diff --git a/develop-docs/self-hosted/troubleshooting/sentry.mdx b/develop-docs/self-hosted/troubleshooting/sentry.mdx index 4591d56cad46c..aadaef61a28a8 100644 --- a/develop-docs/self-hosted/troubleshooting/sentry.mdx +++ b/develop-docs/self-hosted/troubleshooting/sentry.mdx @@ -51,3 +51,13 @@ worker1: ``` To see a more complete example, please see [a sample solution on our community forum](https://forum.sentry.io/t/how-to-clear-backlog-and-monitor-it/10715/14?u=byk). + +## Cannot load Javascript or CSS files from web interface + +If you are running your Sentry instance behind a CDN like Cloudflare, Fastify, or the like, you may see some errors of invalid Javascript or CSS files being loaded from the web interface. This is caused by some static asset files are already optimized by the bundlers, but isn't being served with minified extensions (e.g. `.min.js`). Therefore, the CDN that you are using will try to optimize the files for the second time, which will result in corrupted files. + +Some known paths that you may see this error: +* _static/dist/sentry/entrypoints/sentry.css +* _static/dist/sentry/entrypoints/app.js + +To fix this, you can disable the auto optimization performed by your CDN. From 81a838b59020e5418b81f169f4cb36eccc5a7534 Mon Sep 17 00:00:00 2001 From: Reinaldy Rafli Date: Sat, 15 Feb 2025 06:25:49 +0700 Subject: [PATCH 2/2] Apply suggestions from code review Co-authored-by: Alex Krawiec --- develop-docs/self-hosted/troubleshooting/sentry.mdx | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/develop-docs/self-hosted/troubleshooting/sentry.mdx b/develop-docs/self-hosted/troubleshooting/sentry.mdx index aadaef61a28a8..64b1831585ba4 100644 --- a/develop-docs/self-hosted/troubleshooting/sentry.mdx +++ b/develop-docs/self-hosted/troubleshooting/sentry.mdx @@ -52,11 +52,11 @@ worker1: To see a more complete example, please see [a sample solution on our community forum](https://forum.sentry.io/t/how-to-clear-backlog-and-monitor-it/10715/14?u=byk). -## Cannot load Javascript or CSS files from web interface +## Cannot Load JavaScript or CSS Files From Web Interface -If you are running your Sentry instance behind a CDN like Cloudflare, Fastify, or the like, you may see some errors of invalid Javascript or CSS files being loaded from the web interface. This is caused by some static asset files are already optimized by the bundlers, but isn't being served with minified extensions (e.g. `.min.js`). Therefore, the CDN that you are using will try to optimize the files for the second time, which will result in corrupted files. +If you are running your Sentry instance behind a CDN like Cloudflare, Fastify, or the like, you may see some errors of invalid JavaScript or CSS files being loaded from the web interface. This is caused by some static asset files that are already optimized by the bundlers, but aren't being served with minified extensions (for example, `.min.js`). Therefore, the CDN that you are using will try to optimize the files a second time, which will result in corrupted files. -Some known paths that you may see this error: +Some known paths where you may see this error: * _static/dist/sentry/entrypoints/sentry.css * _static/dist/sentry/entrypoints/app.js