이 페이지에는 Cloud의 URL이 표시됩니다. Dedicated에서 로그인하면 귀사 서버의 URL이 표시됩니다.

Dartastic OTel Reference Demo

설정이 이미 끝난 상태로 Dartastic의 모든 기능을 보여 주는 실제 동작하는 Flutter 앱들입니다. 실행해서 Dartastic이 처음부터 끝까지 작동하는 모습을 확인한 뒤, 코드를 읽고 필요한 부분을 가져다 쓰세요.

오픈 소스 Dart OTel Reference Demo의 상용 확장판으로, 훨씬 많은 데모를 담고 있습니다. 모든 앱이 귀사의 Dartastic Pub에서 패키지를 가져오고 귀사의 Observatory로 데이터를 보내므로, 데모가 실행되면 계정이 제대로 작동한다는 것이 증명됩니다.

빌드DARTASTIC 아키텍처사용자토큰이슈Pub 토큰pushCI 토큰 교환앱 배포: 앱 스토어, 웹, 서버심볼크래시스택 트레이스소스 코드텔레메트리개발자 컴퓨터flutter run · dart pub getCIGitHub Actions, GitLab, …Control Room토큰 발급 · 역할 기반 접근 제어컨트롤 플레인조직 · 역할 · 토큰Dartastic Pub패키지 · 소스 코드Observatory세션 · 트레이스 · 로그Symbolizer크래시 → 소스 코드 줄Dartastic AI양쪽 데이터로 답변이슈 트래커GitHub · Jira · Linear모바일 + 데스크톱 앱휴대폰 · 태블릿 · 데스크톱OTLP 토큰으로 전송웹 앱브라우저에서 실행Browser OTLP 토큰으로 전송Dart 서버백엔드 · 서비스OTLP 토큰으로 전송

다운로드

Control Room에 로그인한 뒤, 모든 화면 상단의 “Help” 옆에 있는 Reference Demo 버튼을 누르세요.

“Help”와 “Sign Out” 옆에 “Reference Demo” 버튼이 있는 Control Room 헤더

dartastic-otel-reference-demo-<version>.tar.gz 파일이 다운로드됩니다. 코드를 보관하는 곳에 압축을 푸세요.

shell
tar -xzf dartastic-otel-reference-demo-*.tar.gz
cd dartastic-otel-reference-demo-*

최상위 폴더의 README.md 파일이 전체 가이드입니다. 아래 단계를 따르면 첫 실행까지 진행할 수 있습니다.

Dedicated: 귀사 서버를 가리키도록 설정

데모는 처음에 Dartastic Cloud를 가리키므로, Cloud에서는 이 단계에서 할 일이 없습니다. Dedicated에서는 하위 도메인을 넣어 아래 명령을 한 번 실행하세요.

shell
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 워크스페이스이므로, 최상위 폴더에서 모든 앱의 패키지를 한 번에 가져오세요.

shell
flutter pub get

이 명령이 성공하면 Dartastic Pub과 Pub 토큰이 제대로 작동하는 것입니다. 이제 앱을 시작하세요. tool/launch.sh 명령이 실행할 기기를 묻습니다.

shell
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_flutterANR(애플리케이션 응답 없음) 감지.
pii_demo_flutter텔레메트리에서 개인정보를 제외하는 방법.
webview_demo_flutter앱 안의 웹 페이지에서 나온 텔레메트리를 앱의 트레이스에 연결합니다.
플랫폼 Vitals릴리스 상태, Android Vitals, iOS MetricKit, 앱 시작, 기기 상태, 발열 상태, 불안정한 네트워크, 사용자 경험, Linux 서버 Vitals를 각각 하나의 앱으로 보여 줍니다.

각 앱은 Observatory에서 자신이 보낸 데이터로 연결되는 링크를 제공합니다. 기능을 익히려면 해당 앱을 실행한 뒤 코드를 읽어 보세요. 그 기능을 보여 주는 가장 작은 동작 예제입니다. AI 코딩 어시스턴트에게도 이 코드를 참고하게 하세요.

Observatory에서 볼 수 있는 내용

데모를 한 번 실행했을 때의 화면입니다. 직접 실행하면 수치는 달라지지만 각 화면이 보여 주는 내용은 같습니다.

프레임 빌드 시간

flutter.frame.build에 대한 “Metric” 화면의 all_demos_flutter 히트맵: 4분 동안의 프레임과, 실행이 진행될수록 올라가는 p95 선.
flutter.frame.build에 대한 “Metric” 화면의 all_demos_flutter 히트맵: 4분 동안의 프레임과, 실행이 진행될수록 올라가는 p95 선.

릴리스 상태

릴리스 상태 데모의 flutter.session 스팬(세션마다 하나)으로 필터링한 트레이스. 빨간색이 크래시가 발생한 세션입니다.
릴리스 상태 데모의 flutter.session 스팬(세션마다 하나)으로 필터링한 트레이스. 빨간색이 크래시가 발생한 세션입니다.

앱 시작

flutter.app.startup.duration에 대한 “Metric” 화면의 히트맵: 약 2.2초의 콜드 스타트 세 번과 33ms, 63ms의 핫 스타트 두 번.
flutter.app.startup.duration에 대한 “Metric” 화면의 히트맵: 약 2.2초의 콜드 스타트 세 번과 33ms, 63ms의 핫 스타트 두 번.

불안정한 네트워크

dartastic.network.flaky = true 조건으로 필터링한 트레이스: 불안정한 요청 두 건으로, 하나는 6.56초가 걸렸고 다른 하나는 114ms 만에 오류로 끝났습니다.
dartastic.network.flaky = true 조건으로 필터링한 트레이스: 불안정한 요청 두 건으로, 하나는 6.56초가 걸렸고 다른 하나는 114ms 만에 오류로 끝났습니다.

Interaction to Next Paint

flutter.experience.inp에 대한 “Metric” 화면의 히트맵: 상호작용 여덟 번 가운데 두 번은 16ms 미만, 여섯 번은 200~250ms.
flutter.experience.inp에 대한 “Metric” 화면의 히트맵: 상호작용 여덟 번 가운데 두 번은 16ms 미만, 여섯 번은 200~250ms.

First Contentful Paint

flutter.experience.fcp에 대한 “Metric” 화면: First Contentful Paint 한 번, 2.67초.
flutter.experience.fcp에 대한 “Metric” 화면: First Contentful Paint 한 번, 2.67초.

ANR 이벤트

anr_demo_flutter 앱의 dartastic.app.anr 이벤트로 필터링한 로그: ANR 세 건. 이벤트에는 심각도가 없어 “Unspecified”로 집계되며, 각 행에 이벤트 이름이 표시됩니다.
anr_demo_flutter 앱의 dartastic.app.anr 이벤트로 필터링한 로그: ANR 세 건. 이벤트에는 심각도가 없어 “Unspecified”로 집계되며, 각 행에 이벤트 이름이 표시됩니다.

ANR 지속 시간

같은 ANR 세 건을 flutter.anr.duration에 대한 “Metric” 화면에서 본 모습: 각각 6.0~6.6초이며, 내보낸 시점에 표시됩니다.
같은 ANR 세 건을 flutter.anr.duration에 대한 “Metric” 화면에서 본 모습: 각각 6.0~6.6초이며, 내보낸 시점에 표시됩니다.

iOS MetricKit 앱 종료

dartastic.app.exit.count에 대한 “Metric” 화면의 막대 그래프: 5분 구간 하나에 종료 50건(정상 43건, 메모리 부족 3건, watchdog 3건, 타임아웃 1건).
dartastic.app.exit.count에 대한 “Metric” 화면의 막대 그래프: 5분 구간 하나에 종료 50건(정상 43건, 메모리 부족 3건, watchdog 3건, 타임아웃 1건).