개요
Dartastic은 Dart 및 Flutter 앱이 실제 사용자의 손에서 어떻게 동작하는지 보여 주고, 잘못된 부분을 고치도록 돕습니다. 이 페이지는 전체 지도입니다. 한 번 읽은 뒤 시작하기 문서를 단계별로 따라가세요.
플랫폼
모든 도움말 페이지에 같은 그림이 나오며, 해당 페이지가 다루는 부분이 강조되어 있어 지금 어디에 있는지 항상 알 수 있습니다.
- 빌드는 컴퓨터와 CI에서 이루어집니다. 앱은 pub.dev에서 패키지를 가져오는 것과 같은 방식으로 Dartastic Pub에서 Dartastic 패키지를 가져옵니다.
- 앱은 휴대폰과 데스크톱, 브라우저에서, 그리고 Dart 서버로 실행됩니다. 앱 안의 Dartastic OTel 패키지가 일어나는 일을 기록해 Observatory로 보냅니다.
- 문제가 생기면 Symbolizer가 앱과 함께 Pub에 게시한 심볼을 사용해 크래시를 귀사의 파일과 줄 번호로 되돌립니다.
- 원인을 알고 싶을 때는 Dartastic AI에 물어보세요. 텔레메트리와 Pub에 있는 소스 코드를 읽고, 원인과 수정 방법을 답합니다.
- Control Room은 이 모든 것을 설정하는 곳입니다. 다이어그램의 각 화살표를 여는 토큰을 여기서 발급합니다.
구성 요소
| 구성 요소 | 하는 일 | 만나는 곳 |
|---|---|---|
| Control Room | 귀사의 계정입니다. 이곳에서 토큰을 발급하고, 팀원을 초대하고, 요금제를 선택하고, Reference Demo를 다운로드합니다. | 로그인 후 dartastic.io/control-room |
| Dartastic Pub | pub.dev처럼 작동하는 비공개 패키지 레지스트리입니다. 여기서 Dartastic 패키지를 가져오고, 귀사의 비공개 패키지를 보관하며, 앱의 소스 코드를 게시합니다. | dart pub get, dart pub publish |
| Dartastic OTel | 앱에 추가하는 패키지입니다. 앱에서 일어나는 일(화면, 탭, 네트워크 호출, 오류, 크래시, 성능)을 OpenTelemetry로 기록해 내보냅니다. | pubspec.yaml 파일과 main() 파일 |
| Observatory | 확인하는 곳입니다. 앱이 보내는 모든 데이터에 대해 리플레이가 포함된 세션, 트레이스, 로그, 메트릭, 크래시, 대시보드, 알림을 제공합니다. | Control Room에서 열기 |
| Symbolizer | 난독화된 릴리스 빌드의 읽을 수 없는 스택 트레이스를 귀사의 파일 이름과 줄 번호로 되돌립니다. 크래시가 도착하면 자동으로 실행됩니다. | 호출할 필요 없음: Pub에 게시한 심볼을 읽습니다 |
| Dartastic AI | 앱에 관한 질문에 일상적인 언어로 답합니다. 텔레메트리와 Pub에 있는 소스 코드를 읽고, 원인을 찾아 수정 사항을 제안합니다. | Observatory와 Control Room의 “Ask” 버튼 |
볼 수 있는 내용
Observatory 화면입니다. 사용자의 각 세션이 화면, 탭, 오류, 불만 신호와 함께 나열됩니다.

세션 하나를 열어 리플레이하세요. 재생 헤드 아래에 그 순간의 트레이스, 로그, 오류가 표시되며, 해당 코드 줄로 바로 이동할 수 있습니다.

토큰으로 구성 요소를 연결
다이어그램의 각 화살표에는 각기 다른 종류의 토큰이 필요합니다. 토큰은 Control Room에서 발급하며, 각 토큰은 한 번만 표시되므로 발급할 때 복사해 두세요. 대부분의 개발자는 dart pub 명령에 토큰을 써 본 적이 없습니다. Pub 페이지에서 방법을 안내합니다.
| 토큰 | 출발 | 도착 | 허용하는 일 |
|---|---|---|---|
| Pub 토큰 | 개발자 컴퓨터 | Dartastic Pub | dart pub get 명령으로 Dartastic 패키지와 비공개 패키지를 다운로드하고, dart pub publish 명령으로 업로드할 수 있습니다. |
| CI 교환 | 귀사의 CI | Dartastic Pub | CI에 토큰을 저장하지 않고도 패키지를 읽고 게시할 수 있습니다. |
| OTLP 토큰 | 휴대폰이나 데스크톱의 앱, Dart 서버 | Observatory | 앱이 텔레메트리를 보낼 수 있습니다. |
| Browser OTLP 토큰 | Flutter 웹 앱 | Observatory | 웹 앱이 텔레메트리를 보낼 수 있습니다. 단, 등록한 웹사이트에서만 가능합니다. |
보유한 모든 토큰이 한 화면에 나열됩니다. 각 토큰의 종류와 토큰을 폐기하거나 교체하는 방법은 토큰 문서에서 설명합니다.
실행 위치: 요금제
- Cloud는 Dartastic이 여러 고객과 공유하는 인프라에서 실행됩니다. Pub 주소는
pub.dartastic.io입니다. - Dedicated는 조직에 전용 서버를 제공하며, 원하는 하위 도메인을 사용합니다. Pub 주소는
pub.<subdomain>.dartastic.io입니다. - Self-Hosted는 사내 네트워크 안에서 전체 플랫폼을 실행합니다.
모든 요금제에서 단계는 같습니다. URL이 다른 곳에서는 이 문서들이 두 가지를 모두 보여 줍니다. 요금제 비교.
준비 사항
- 모든 기능을 사용하려면 Flutter 3.44 및 Dart 3.12 이상이 필요하며, Flutter 메트릭을 제외한 모든 기능은 Flutter 3.22 및 Dart 3.4에서 사용할 수 있습니다. 패키지별 필요 버전.
- Dartastic 계정: 가입은 무료입니다. 가입하면 조직이 카드 없이 Cloud Free로 시작됩니다.
- Reference Demo의 날씨 백엔드에만 필요: Docker.
학습 방법
편한 방법을 고르세요. 모두 같은 내용을 다룹니다.
- 읽기: 이 문서들을 순서대로 읽으세요. 각 페이지 하단의 이전, 다음 링크가 다음 내용으로 안내합니다.
- Dartastic OTel Reference Demo를 실행하세요. 오픈 소스 Dart OTel Reference Demo의 상용 확장판으로, 훨씬 많은 데모를 담고 있습니다. 설정이 이미 끝난 상태로 Dartastic의 모든 기능 사용법을 보여 주는 실제 동작하는 Flutter 앱들입니다. 코드를 읽거나, 가져다 쓰거나, AI 코딩 어시스턴트에게 참고하게 하세요. Reference Demo 받기.
- 질문하기: 지원에서 질문에 답해 드립니다.
이 문서에서 쓰는 용어
- OpenTelemetry (OTel)
- 소프트웨어의 동작을 기록하는 개방형 표준입니다. Dartastic은 처음부터 끝까지 이 표준을 사용하므로, 직접 작성한 코드가 Dartastic에 종속되지 않습니다.
- OTLP
- OpenTelemetry의 전송 형식입니다. 앱이 기록한 데이터를 보내는 방식입니다.
- 트레이스와 스팬
- 스팬은 시간을 측정한 하나의 작업 단위(탭, 네트워크 호출, 데이터베이스 쿼리)입니다. 트레이스는 하나의 작업에 대한 스팬의 트리이며, 앱과 서버에 걸쳐 이어질 수도 있습니다.
- 로그
- 앱이 기록한 텍스트 한 줄로, 그 로그가 기록된 트레이스와 연결됩니다.
- 메트릭
- 시간에 따라 측정한 수치입니다. 프레임 시간, 메모리, 요청 수 등이 있습니다.
- 세션
- 한 사람이 앱을 실행해서 떠날 때까지의 방문 한 번으로, 그 안의 모든 화면, 탭, 오류, 트레이스를 담습니다.
- 리플레이
- 세션을 다시 보는 것입니다. 이벤트 타임라인, 와이어프레임, 실제 픽셀 중에서 얼마나 캡처할지 선택합니다.
- RUM
- 실제 사용자 모니터링(Real User Monitoring): 테스트가 아니라 앱을 실제로 사용하는 사람들에게서 나온 텔레메트리입니다.
- 난독화와 심볼
- 릴리스 빌드는 이름을 뒤섞을 수 있습니다(flutter build --obfuscate). 빌드가 생성하는 심볼 파일(--split-debug-info)이 이를 되돌리는 열쇠입니다.
- 토큰
- 한 대상이 다른 한 대상과 통신하도록 허용하는 긴 비밀 문자열입니다. 종류마다 위 다이어그램의 경로 하나를 엽니다.