Dartastic OTel Reference Demo
설정이 이미 끝난 상태로 Dartastic의 모든 기능을 보여 주는 실제 동작하는 Flutter 앱들입니다. 실행해서 Dartastic이 처음부터 끝까지 작동하는 모습을 확인한 뒤, 코드를 읽고 필요한 부분을 가져다 쓰세요.
오픈 소스 Dart OTel Reference Demo의 상용 확장판으로, 훨씬 많은 데모를 담고 있습니다. 모든 앱이 귀사의 Dartastic Pub에서 패키지를 가져오고 귀사의 Observatory로 데이터를 보내므로, 데모가 실행되면 계정이 제대로 작동한다는 것이 증명됩니다.
다운로드
Control Room에 로그인한 뒤, 모든 화면 상단의 “Help” 옆에 있는 Reference Demo 버튼을 누르세요.

dartastic-otel-reference-demo-<version>.tar.gz 파일이 다운로드됩니다. 코드를 보관하는 곳에 압축을 푸세요.
tar -xzf dartastic-otel-reference-demo-*.tar.gz
cd dartastic-otel-reference-demo-*최상위 폴더의 README.md 파일이 전체 가이드입니다. 아래 단계를 따르면 첫 실행까지 진행할 수 있습니다.
Dedicated: 귀사 서버를 가리키도록 설정
데모는 처음에 Dartastic Cloud를 가리키므로, Cloud에서는 이 단계에서 할 일이 없습니다. Dedicated에서는 하위 도메인을 넣어 아래 명령을 한 번 실행하세요.
tool/set-hosted-slug.sh <subdomain>하위 도메인을 .env 파일(git이 무시함)에 기록하고 pubspec을 업데이트합니다. 다른 하위 도메인으로 바꾸려면 그 값으로 다시 실행하고, Cloud로 돌아가려면 "" 값으로 실행하세요.
필요한 토큰
각 토큰은 Control Room의 Tokens 화면에서 발급하세요. 토큰은 한 번만 표시되므로 발급할 때 복사해 두세요.
| 토큰 | 용도 |
|---|---|
Pub 토큰dart pub token add (한 번) | 모든 데모: flutter pub get 명령이 귀사의 Dartastic Pub에서 패키지를 가져옵니다. |
OTLP 토큰OTEL_EXPORTER_OTLP_HEADERS | 모든 데모: 앱이 텔레메트리를 귀사의 Observatory로 보냅니다. |
Symbolizer 토큰DARTASTIC_SYMBOLIZER_TOKEN | symbolizer_demo_flutter 앱만 해당. |
symbolizer_demo_flutter 데모와 crash_demo_flutter 데모를 제외한 모든 데모는 읽기 전용 Pub 토큰으로 충분합니다. 이 두 데모는 귀사의 Pub에 게시하므로 읽기 및 쓰기 토큰이 필요합니다. Pub 토큰을 추가하고 나머지 토큰을 내보내는 방법은 시작하기 문서에서 안내합니다.
토큰은 .env 파일에 적지 말고 셸에서 export하세요. 공유되거나 커밋된 .env 파일은 비밀 정보가 유출되는 흔한 경로입니다.
데모 실행
데모는 하나의 Flutter 워크스페이스이므로, 최상위 폴더에서 모든 앱의 패키지를 한 번에 가져오세요.
flutter pub get이 명령이 성공하면 Dartastic Pub과 Pub 토큰이 제대로 작동하는 것입니다. 이제 앱을 시작하세요. tool/launch.sh 명령이 실행할 기기를 묻습니다.
tool/launch.sh --list # every demo app
tool/launch.sh # weather_flutter
tool/launch.sh rum_demo_flutter- Docker는
weather_flutter데모와all_demos_flutter데모에만 필요합니다. 이 두 데모는 로컬 머신에서 날씨 API를 실행해 앱과 서버를 잇는 하나의 트레이스를 보여 줍니다. - 데모는 Android, iOS, macOS, Windows, Linux의 실제 기기와 시뮬레이터에서 실행됩니다. 웹에서는 실행되지 않습니다.
구성
| 앱 | 보여 주는 내용 |
|---|---|
weather_flutter | 탭 한 번을 처음부터 끝까지 트레이스합니다. 앱, 날씨 API, 그 캐시, 외부 날씨 서비스가 하나의 트레이스에 담깁니다. |
all_demos_flutter | 거의 모든 데모를 한 앱의 탭으로 모았습니다. |
rum_demo_flutter | 세션, 화면 조회, 탭, 불만 신호와 세션 리플레이. |
crash_demo_flutter | 앱이 종료되어도 기록되고 전송되는 크래시. |
symbolizer_demo_flutter | 난독화된 릴리스 빌드의 스택 트레이스가 귀사의 파일과 줄 번호로 돌아오고, 버벅거림을 위젯까지 추적합니다. |
anr_demo_flutter | ANR(애플리케이션 응답 없음) 감지. |
pii_demo_flutter | 텔레메트리에서 개인정보를 제외하는 방법. |
webview_demo_flutter | 앱 안의 웹 페이지에서 나온 텔레메트리를 앱의 트레이스에 연결합니다. |
| 플랫폼 Vitals | 릴리스 상태, Android Vitals, iOS MetricKit, 앱 시작, 기기 상태, 발열 상태, 불안정한 네트워크, 사용자 경험, Linux 서버 Vitals를 각각 하나의 앱으로 보여 줍니다. |
각 앱은 Observatory에서 자신이 보낸 데이터로 연결되는 링크를 제공합니다. 기능을 익히려면 해당 앱을 실행한 뒤 코드를 읽어 보세요. 그 기능을 보여 주는 가장 작은 동작 예제입니다. AI 코딩 어시스턴트에게도 이 코드를 참고하게 하세요.
Observatory에서 볼 수 있는 내용
데모를 한 번 실행했을 때의 화면입니다. 직접 실행하면 수치는 달라지지만 각 화면이 보여 주는 내용은 같습니다.
프레임 빌드 시간

릴리스 상태

앱 시작

불안정한 네트워크

Interaction to Next Paint

First Contentful Paint

ANR 이벤트

ANR 지속 시간

iOS MetricKit 앱 종료
