fix(backend): make sentry traces-sample-rate env-configurable

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
feat(backend): add sentry-spring-boot-starter-jakarta for GlitchTip error reporting
2026-05-15 08:55:40 +02:00 · 2026-05-15 08:55:40 +02:00 · 2026-05-15 08:52:21 +02:00
5 changed files with 21 additions and 0 deletions
--- a/.env.example
+++ b/.env.example
@@ -50,6 +50,7 @@ GLITCHTIP_SECRET_KEY=changeme-generate-a-real-secret
 # Error reporting DSNs — leave empty to disable the SDK (safe default).
 # SENTRY_DSN: backend (Spring Boot) — used by the GlitchTip/Sentry Java SDK
 SENTRY_DSN=
+SENTRY_TRACES_SAMPLE_RATE=
 # VITE_SENTRY_DSN: frontend (SvelteKit) — injected at build time via Vite
 VITE_SENTRY_DSN=
 # Sentry/GlitchTip auth token for source map upload at build time (optional)
--- a/backend/pom.xml
+++ b/backend/pom.xml
@@ -224,6 +224,13 @@
 				</exclusion>
 			</exclusions>
 		</dependency>
+
+		<!-- Sentry error reporting (GlitchTip-compatible) -->
+		<dependency>
+			<groupId>io.sentry</groupId>
+			<artifactId>sentry-spring-boot-starter-jakarta</artifactId>
+			<version>8.5.0</version>
+		</dependency>
 	</dependencies>


--- a/backend/src/main/resources/application.yaml
+++ b/backend/src/main/resources/application.yaml
@@ -118,3 +118,12 @@ ocr:
  sender-model:
    activation-threshold: 100
    retrain-delta: 50
+
+sentry:
+  dsn: ${SENTRY_DSN:}
+  environment: ${SPRING_PROFILES_ACTIVE:dev}
+  traces-sample-rate: ${SENTRY_TRACES_SAMPLE_RATE:1.0}
+  send-default-pii: false
+  enable-tracing: true
+  ignored-exceptions-for-type:
+    - org.raddatz.familienarchiv.exception.DomainException
--- a/backend/src/test/resources/application-test.yaml
+++ b/backend/src/test/resources/application-test.yaml
@@ -23,6 +23,8 @@ otel:
 # Disable trace export in tests — prevents OTLP connection attempts when no Tempo is running.
 # Sampling probability 0.0 means no spans are created, so no export is attempted.
 management:
+  server:
+    port: 0   # random port per context — prevents TIME_WAIT conflicts when @DirtiesContext restarts the context
  tracing:
    sampling:
      probability: 0.0
--- a/docker-compose.yml
+++ b/docker-compose.yml
@@ -147,6 +147,8 @@ services:
      SPRING_MAIL_PROPERTIES_MAIL_SMTP_STARTTLS_ENABLE: ${MAIL_STARTTLS_ENABLE:-false}
      APP_OCR_BASE_URL: http://ocr-service:8000
      APP_OCR_TRAINING_TOKEN: "${OCR_TRAINING_TOKEN:-}"
+      SENTRY_DSN: ${SENTRY_DSN:-}
+      SENTRY_TRACES_SAMPLE_RATE: ${SENTRY_TRACES_SAMPLE_RATE:-1.0}
      # Observability: send traces to Tempo inside archiv-net (OTLP gRPC port 4317)
      # Tempo is defined in docker-compose.observability.yml (future issue).
      # OTLP failures are non-fatal — backend starts cleanly without the observability stack.
Author	SHA1	Message	Date
Marcel	68e4ff4121	fix(backend): make sentry traces-sample-rate env-configurable Some checks failed CI / Unit & Component Tests (pull_request) Successful in 6m4s Details CI / OCR Service Tests (pull_request) Successful in 32s Details CI / Backend Unit Tests (pull_request) Failing after 7m9s Details CI / fail2ban Regex (pull_request) Successful in 2m27s Details CI / Compose Bucket Idempotency (pull_request) Successful in 1m59s Details Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>	2026-05-15 08:55:40 +02:00
Marcel	0a1d709c5f	feat(backend): add sentry-spring-boot-starter-jakarta for GlitchTip error reporting Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>	2026-05-15 08:55:40 +02:00
Marcel	8a00d66435	fix(ci): set management.server.port=0 in test profile to fix 25-min test timeout Some checks failed CI / OCR Service Tests (pull_request) Waiting to run Details CI / Backend Unit Tests (pull_request) Waiting to run Details CI / fail2ban Regex (pull_request) Waiting to run Details CI / Compose Bucket Idempotency (pull_request) Waiting to run Details CI / Unit & Component Tests (pull_request) Has been cancelled Details CI / Unit & Component Tests (push) Has been cancelled Details CI / OCR Service Tests (push) Has been cancelled Details CI / Backend Unit Tests (push) Has been cancelled Details CI / fail2ban Regex (push) Has been cancelled Details CI / Compose Bucket Idempotency (push) Has been cancelled Details Port 8081 was fixed by #576. With four @DirtiesContext(AFTER_EACH_TEST_METHOD) classes (22 context restarts total), the OS TIME_WAIT state holds port 8081 for ~45-60s per cycle — adding ~17 min overhead. All 1601 tests pass but surefire's 10-min timeout fires before the suite finishes. Fixes #593. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>	2026-05-15 08:52:21 +02:00