Dartastic SymbolizerDartastic Symbolizer

프로덕션 오류를 소스 코드 줄로.

Dartastic Symbolizer는 프로덕션 오류를 바로 조치할 수 있는 소스 코드 줄로 바꿔 줍니다. 비공개로 안전하게.

Dartastic Symbolizer를 거친 Flutter 오류 스팬: 함수 이름과 소스 코드 줄이 담긴 실제 프레임

작동 방식

Native SDK가 오류를 감지하면 Dartastic Symbolizer를 호출해 오류에 소스 코드 위치를 덧붙일 수 있습니다. 관측성 플랫폼은 소스 코드의 특정 줄을 가리키는 오류를 자동으로 받습니다.

디버그 심볼(또는 소스 맵)과 앱이 있으면 소스 코드를 알 수 있습니다. 이를 관측성 벤더에 업로드하면 지식 재산에 대한 공격 표면이 늘어나고, DevOps 부담도 더해집니다.

심볼은 패키지를 게시하는 곳, 즉 지식 재산을 볼 수 있는 사람을 직접 관리하는 Dartastic Pub에 보관하세요.

스택 트레이스, 해결.

난독화된 프로덕션 스택 트레이스를 보내면 실제 함수 이름과 소스 코드 줄 번호가 담긴 같은 트레이스를 돌려받습니다. 심볼은 Dartastic Pub 서버에 그대로 있으므로 관측성 벤더에 따로 업로드할 필요가 없고, 지식 재산이 노출될 수 있는 공격 표면도 줄어듭니다.

난독화됨 · 프로덕션에서
Dartastic Observatory 스팬 이벤트: 심볼화되지 않은 Flutter 크래시로, build_id와 _kDartIsolateInstructions 안의 원시 명령어 오프셋만 표시됩니다.
심볼화됨 · Dartastic Symbolizer 사용
Dartastic Symbolizer를 거친 같은 스팬 이벤트: 함수 이름과 소스 코드 줄이 담긴 실제 프레임(예: symbolizer_demo.dart:157:7의 _SymbolizerDemoPageState._validateQuantity)

OTLP와 호환되는 모든 플랫폼에서 작동합니다. Dartastic Native OTel SDK는 스팬 오류나 크래시가 발생하면 Dartastic Symbolizer를 호출해 익스포터에 앞서 트레이스를 다시 씁니다. 따라서 관측성 플랫폼에는 알아볼 수 없는 문자열이 아니라, 문제와 관련된 소스 코드 줄을 가리키는 사람이 읽을 수 있는 스택 트레이스가 표시됩니다.

Dartastic Symbolizer가 난독화된 크래시를 소스 코드 줄로 바꾸는 방법 같은 트레이스 스팬 안에서 처음부터 끝까지. 두 번째 도구도, 복사해서 붙여 넣기도 필요 없습니다. Flutter 앱OTel CollectorDartastic Pub비공개 심볼 저장소Dartastic SymbolizerWeb APIsymbolizer.dartastic.ioDartastic Observatory1. 오류 스팬2. 오류, 앱 버전3. 빌드 정보4. .symbols5. 소스 코드 스택 트레이스 모든 트래픽 TLS 암호화 · 패키지별 API 키 범위 지정 · 심볼은 고객 소유로 유지
Dartastic Observatory를 사용하지 않으시나요? 자체 통합에서 같은 Web API를 호출하세요. 심볼은 Pub 밖으로 나가지 않습니다. 자체 통합예: 오류 추적 도구Dartastic SymbolizerWeb APIsymbolizer.dartastic.ioDartastic Pub비공개 심볼 저장소1. 오류, 앱 버전2. 오류, 빌드 정보3. .symbols4. 소스 코드 스택 트레이스 HTTPS 호출 한 번 · 심볼은 비공개 Pub에 그대로 유지

장점

  • 읽을 수 있는 오류가 워크플로 전체를 움직입니다. 파일과 줄을 짚어 주는 오류는 분류하고, 담당자를 정하고, 점심 전에 고칠 수 있는 티켓이 됩니다. 심볼화는 프로덕션을 그저 지켜보는 것과 이해하는 것의 차이입니다. 한번 써 보면 그동안 어떻게 없이 출시했는지 궁금해질 것입니다.
  • 자동입니다. 게시하면 끝납니다. flutter build apk --release --obfuscate --split-debug-info=symbols/ 옵션으로 빌드하고, .symbols 파일을 함께 담아 비공개 Dartastic Pub에 릴리스를 게시하세요. Dartastic Symbolizer가 모든 앱, 버전, 플랫폼에 맞는 정확한 심볼을 알아서 찾습니다. 버전 1.4.0의 오류는 몇 년이 지나도 읽을 수 있습니다.
  • Sentry나 Crashlytics보다 쉽습니다. 이런 플랫폼은 모든 플랫폼, 모든 릴리스마다 디버그 심볼을 업로드하라고 요구하며, 그 작업은 직접 만들고 계속 돌봐야 하는 CI 단계가 됩니다. Dartastic은 이 모든 절차를 건너뜁니다. 심볼은 이미 제자리에 있습니다.
  • 보안도 더 강합니다. 디버그 심볼은 소스 코드로 되돌아가는 지도이며, 이를 벤더에 업로드하면 지식 재산이 노출될 수 있는 공격 표면이 넓어집니다. Dartastic에서는 심볼이 고객의 키로 보호되는 비공개 Pub에 그대로 있습니다. 관측성 벤더는 사람이 읽기 쉬운 텍스트만 보게 됩니다.
  • 사용하던 플랫폼에서 그대로 작동합니다. OTLP와 호환되는 모든 플랫폼에 오류가 소스 코드 줄과 함께 도착합니다: Datadog, Honeycomb, Dartastic Dedicated, 심지어 Sentry까지. 벤더 쪽에 설치할 것도, 기다려야 할 통합도 없습니다.
  • 트레이스의 일부로, 밀리초 만에. 간단한 API 하나. 캐시된 조회는 밀리초 만에 응답하며, 모든 응답에는 이번 달 누적 사용량이 담깁니다. 마치 트레이스가 처음부터 난독화되지 않았던 것처럼 느껴집니다.
심볼은 빌드 시스템 안에 머뭅니다.

대부분의 팀은 별도 단계로 .symbols / .dSYM 파일을 Datadog, Sentry 등에 업로드합니다. 이는 벤더에게 소스를 재구성할 수 있는 열쇠를 넘기는 것입니다. Dartastic Symbolizer는 심볼 파일을 pub.dartastic.io 안에 두고, 난독화가 해제된 텍스트만 다음 단계로 내보냅니다.

온프레미스 옵션(규정 준수)

규제를 받는 워크플로에서는 엄격하게 통제된 Dartastic Dedicated 플랫폼의 일부로 Dartastic Symbolizer를 사내 보안 경계 안에서 실행할 수 있습니다. 프로덕션 트레이스는 고객 네트워크 밖으로 나가지 않습니다.

Dartastic Pub에서 자동으로 가져오기

flutter build apk --release --obfuscate --split-debug-info=symbols/ 옵션으로 Flutter 앱을 pub.dartastic.io 주소에 게시하세요. 캐시에 처음 없을 때 Dartastic Symbolizer가 아카이브를 다운로드합니다. 두 번째 업로드 단계는 없습니다.

Dartastic Symbolizer 시작하기

Dartastic Symbolizer는 OTel Pro 및 Dartastic Observatory 요금제에 포함됩니다. 맞는 요금제를 고르시면 Dartastic Symbolizer가 함께 제공됩니다.