ES /docs

PotreeService#downloadFile — missing retry on transient network error

Service
cupixworks-any-potree-agent
Occurrences
7
Status
Reported
Confidence
85%
Actionability
28%
Cluster ID
295f5cac-b407-4dba-9ea6-a86c9ed77326
First Seen
2026-06-08 06:20 UTC
Last Seen
2026-07-16 12:55 UTC
Datadog↗ Slack↗
Actions

PotreeService#downloadFile — missing retry on transient network error

What Happened#

2026-06-08 15:20:54 KST에 cupixworks-any-potree-agent (gad 테넌트, me-central-1 리전) 가 pointcloud 1132267의 원본 .cpc 파일을 S3 presigned URL로 다운로드하던 중 AWS S3 가 503 Service Unavailable 응답을 반환하여 작업이 실패했다. 단 1건의 단발성 이벤트로, downstream(S3) 의 일시적 장애로 보인다.

Quick Facts#

Field Value
exception.class PotreeService::downloadFile
exception.message code: 503, message: Service Unavailable
top_frame applications/agents/packages/cupix-tesla-potree-agent/src/potree-service.ts:555
runtime Node.js / TypeScript (cupix-tesla-potree-agent ECS task)
env production, region me-central-1 (S3 호스트 기준), tenant gad

Affected Teams#

Team / Domain Error Count Impact
gad (me-central-1 pointcloud 처리) 1 pointcloud 1132267 Potree 변환 실패 — potree_state 가 Error 로 마킹되어 사용자 측에서 해당 point cloud 미리보기/뷰어 불가. SQS 메시지가 재처리 큐로 돌아가지 않고 삭제될 수 있음 (Hypotheses 참조).

Timeline#

  1. 2026-06-08 15:20:51 KST — PotreeService::runByMessage | id: 1132267 — 메시지 처리 시작
  2. 2026-06-08 15:20:54 KST — S3 presigned URL (s3.me-central-1.amazonaws.com/cupixworks-source-...mece1/...) GET 응답 503 Service Unavailable (AmazonS3 server, request id 309942E0451E8166)
  3. 2026-06-08 15:20:54 KST — PotreeService::downloadFile | response path: /tmp/workspace/1132267/1132267.cpc, code: 503 (error)
  4. 2026-06-08 15:20:54 KST — CupixAuth::handleError | Undefined response warn — response 객체 형태가 axios/nodejs 어느 쪽과도 매치되지 않아 statusCode 판별 누락
  5. 2026-06-08 15:20:54 KST — PotreeService::getApiErrorToDeleteMessage | undefined response warn — response가 error.response 경로에 없어 undefined response 로 인식

Scoring#

Confidence 85% · Actionability 28%

Confidence#

Dimension Score Detail
Evidence completeness 5/5 12 code refs, 3 log queries
Code path explicitness 3/3 12 file:line refs
Log evidence 3/3 section, query, pattern
RCA structure 3/3 3/3 sections
Revision history 0/3 0 revision(s)
Agent execution 3/3 success

Actionability#

Dimension Score Detail
Fix complexity 1/5 critical
Affected files 1/5 9 file(s)
Single repo 1/3 7 service(s)
Immediate actions 0/3 absent
Testability 0/3 no test info
External dependency 1/3 external deps found
Data migration 3/3 no migration