fix(runtime): 운영 telemetry를 자리표시자 주소 대신 끈다 #2

Merged
donghyeon.kang merged 1 commits from fix/production-telemetry-off into main 2026-11-11 22:44:25 +00:00
Owner

무엇을, 왜

운영 profile(config/runtime/production.json)이 telemetry를 켠 채 자리표시자 주소 https://telemetry.example.com/v1/events로 보낸다. 이 주소는 DNS가 없고 받는 곳도 없다. 운영 빌드 인자 목록에 RUNTIME_TELEMETRY_ENDPOINT가 없어서 hyeonworks.com의 운영 이미지도 이 값을 쓴다. docs/release/2026-08-19-release-gate-verification.md P1-3에 이미 적힌 문제다.

소유자 결정(design-docs template-program/README.md 5절 c): 클러스터 안 수신처가 있으면 같은 origin 경로로 보내고, 없으면 끈다. 자리표시자로 보내지 않는다.

고른 방법과 버린 대안

수신처를 찾아본 결과 없다.

  • 이 앱의 telemetry는 {events: [...]} JSON을 POST한다(src/adapters/telemetry/telemetry-collector.ts). OTLP 형식이 아니다.
  • 클러스터의 OTLP 수신처는 alloy와 tempo의 gRPC 4317뿐이다. 둘 다 ClusterIP이고 traces만 받는다. 브라우저가 보낼 HTTP 경로는 없다.

그래서 TELEMETRY_ENABLED: false로 두고 TELEMETRY_ENDPOINT 줄을 지운다. 꺼진 telemetry는 endpoint가 없어도 schema·배포 허용 검사를 통과한다(둘 다 켜졌을 때만 endpoint를 요구한다).

버린 대안: endpoint를 hyeonworks.com의 빈 경로로 바꾸기. 받는 곳이 없으니 요청만 는다.

위험과 영향

  • 운영에서 화면 오류·기능 이벤트를 모으지 않는다. 지금도 주소가 DNS에 없어 실제로 모인 것은 없다.
  • 지금 운영 이미지(7a4e201)에는 이 변경이 없다. 새 이미지로 배포할 때부터 적용된다. 7a4e201은 노트북 clone의 로컬 브랜치에만 있고 Gitea에 없다. 무엇을 배포할지는 소유자 판단이다.
  • staging profile의 telemetry.staging.example.com은 그대로 둔다. 배포된 staging이 없다.

검증

  • config/runtime/production.json이 JSON으로 읽힌다.
  • 코드 확인: scripts/generate-runtime-config.ts가 덮어쓸 수 있는 값은 API_BASE_URL·TELEMETRY_ENDPOINT뿐이고, TELEMETRY_ENDPOINT는 선택 항목이다. release-artifacts.ts와 deployment-admission.ts는 TELEMETRY_ENABLED가 참일 때만 endpoint를 요구한다.
  • 운영 빌드(desktop, Dockerfile과 같은 node@sha256:3638d9… 컨테이너, CI=true APP_PROFILE=production RUNTIME_API_BASE_URL=https://hyeonworks.com/ corepack pnpm build)가 통과했다. dist/config.json은 TELEMETRY_ENABLED: false이고 TELEMETRY_ENDPOINT가 없다. dist에 telemetry.example.com이 없다.
  • RELEASE_TARGET=production corepack pnpm check:release-admission: release admission: production ADMITTED.
  • 커밋 본문의 검증 줄은 이 결과가 나오기 전에 push해서 「아직 돌리지 못했다」로 남아 있다. force push를 하지 않으려고 고치지 않았다. 이 PR 본문이 최종 결과다.

리뷰어가 볼 곳

  • config/runtime/production.json 한 파일.

관련

  • design-docs template-program/README.md 5절 c
  • docs/release/2026-08-19-release-gate-verification.md P1-3
## 무엇을, 왜 운영 profile(`config/runtime/production.json`)이 telemetry를 켠 채 자리표시자 주소 `https://telemetry.example.com/v1/events`로 보낸다. 이 주소는 DNS가 없고 받는 곳도 없다. 운영 빌드 인자 목록에 `RUNTIME_TELEMETRY_ENDPOINT`가 없어서 hyeonworks.com의 운영 이미지도 이 값을 쓴다. `docs/release/2026-08-19-release-gate-verification.md` P1-3에 이미 적힌 문제다. 소유자 결정(design-docs `template-program/README.md` 5절 c): 클러스터 안 수신처가 있으면 같은 origin 경로로 보내고, 없으면 끈다. 자리표시자로 보내지 않는다. ## 고른 방법과 버린 대안 수신처를 찾아본 결과 없다. - 이 앱의 telemetry는 `{events: [...]}` JSON을 POST한다(`src/adapters/telemetry/telemetry-collector.ts`). OTLP 형식이 아니다. - 클러스터의 OTLP 수신처는 alloy와 tempo의 gRPC 4317뿐이다. 둘 다 ClusterIP이고 traces만 받는다. 브라우저가 보낼 HTTP 경로는 없다. 그래서 `TELEMETRY_ENABLED: false`로 두고 `TELEMETRY_ENDPOINT` 줄을 지운다. 꺼진 telemetry는 endpoint가 없어도 schema·배포 허용 검사를 통과한다(둘 다 켜졌을 때만 endpoint를 요구한다). 버린 대안: endpoint를 hyeonworks.com의 빈 경로로 바꾸기. 받는 곳이 없으니 요청만 는다. ## 위험과 영향 - 운영에서 화면 오류·기능 이벤트를 모으지 않는다. 지금도 주소가 DNS에 없어 실제로 모인 것은 없다. - 지금 운영 이미지(`7a4e201`)에는 이 변경이 없다. 새 이미지로 배포할 때부터 적용된다. `7a4e201`은 노트북 clone의 로컬 브랜치에만 있고 Gitea에 없다. 무엇을 배포할지는 소유자 판단이다. - staging profile의 `telemetry.staging.example.com`은 그대로 둔다. 배포된 staging이 없다. ## 검증 - `config/runtime/production.json`이 JSON으로 읽힌다. - 코드 확인: `scripts/generate-runtime-config.ts`가 덮어쓸 수 있는 값은 `API_BASE_URL`·`TELEMETRY_ENDPOINT`뿐이고, `TELEMETRY_ENDPOINT`는 선택 항목이다. `release-artifacts.ts`와 `deployment-admission.ts`는 `TELEMETRY_ENABLED`가 참일 때만 endpoint를 요구한다. - 운영 빌드(desktop, Dockerfile과 같은 `node@sha256:3638d9…` 컨테이너, `CI=true APP_PROFILE=production RUNTIME_API_BASE_URL=https://hyeonworks.com/ corepack pnpm build`)가 통과했다. `dist/config.json`은 `TELEMETRY_ENABLED: false`이고 `TELEMETRY_ENDPOINT`가 없다. `dist`에 `telemetry.example.com`이 없다. - `RELEASE_TARGET=production corepack pnpm check:release-admission`: `release admission: production ADMITTED`. - 커밋 본문의 검증 줄은 이 결과가 나오기 전에 push해서 「아직 돌리지 못했다」로 남아 있다. force push를 하지 않으려고 고치지 않았다. 이 PR 본문이 최종 결과다. ## 리뷰어가 볼 곳 - `config/runtime/production.json` 한 파일. ## 관련 - design-docs `template-program/README.md` 5절 c - `docs/release/2026-08-19-release-gate-verification.md` P1-3
donghyeon.kang added 1 commit 2026-11-11 22:43:34 +00:00
운영 profile이 telemetry를 켠 채 `https://telemetry.example.com/v1/events`
로 보낸다. 이 주소는 자리표시자라 DNS가 없고, 받는 곳도 없다. 운영
빌드 인자 목록에 `RUNTIME_TELEMETRY_ENDPOINT`가 없어 hyeonworks.com의
운영 이미지도 이 값으로 나간다(release-gate 검증 문서 P1-3에 이미 적힌
문제다).

같은 origin으로 받을 수신처가 클러스터에 있으면 그리로 보내고, 없으면
끈다(소유자 결정, 2026-11-11). 수신처를 찾아봤다.

- 이 앱의 telemetry는 `{events: [...]}` JSON을 POST한다. OTLP 형식이
  아니다.
- 클러스터의 OTLP 수신처는 alloy와 tempo의 gRPC 4317뿐이다. 둘 다
  ClusterIP이고 traces만 받는다. 브라우저가 보낼 HTTP 경로는 없다.

그래서 `TELEMETRY_ENABLED`를 false로 두고 `TELEMETRY_ENDPOINT` 줄을
지운다. 꺼진 telemetry에는 endpoint가 필요 없다(release-artifacts와
deployment-admission 모두 켜졌을 때만 endpoint를 요구한다). 배포가
`RUNTIME_TELEMETRY_ENDPOINT`로 endpoint만 덮어써도 꺼진 채로 남는다.
버린 대안: endpoint를 hyeonworks.com의 빈 경로로 바꾸는 것. 받는 곳이
없으니 요청만 늘고, 켤 이유가 없다.

위험·한계: 운영 화면 오류·이벤트 수집이 다시 필요해지면 수신처를 먼저
만들고 profile을 켠다. 지금 운영 중인 이미지(7a4e201)는 이 커밋을 담지
않는다. 새 이미지로 배포할 때부터 적용된다.

검증: profile이 JSON으로 읽히고, generate-runtime-config가 덮어쓸 수
있는 값은 API_BASE_URL과 TELEMETRY_ENDPOINT뿐이며 둘 다 선택 항목임을
코드로 확인했다. 운영 빌드(`APP_PROFILE=production corepack pnpm build`)와
`check:release-admission`은 desktop heavy lock을 기다리는 중이라 아직
돌리지 못했다.
donghyeon.kang merged commit 585c62431a into main 2026-11-11 22:44:25 +00:00
Sign in to join this conversation.
No Reviewers
No labels
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: donghyeon.kang/tech-log-frontend#2