Dartastic OTel Reference Demo
Các ứng dụng Flutter chạy được, cho thấy mọi tính năng của Dartastic, với phần thiết lập đã làm sẵn. Chạy chúng để thấy Dartastic hoạt động từ đầu đến cuối, rồi đọc mã và sao chép từ đó.
Đây là phiên bản thương mại nâng cao của Dart OTel Reference Demo mã nguồn mở, với nhiều demo hơn hẳn. Mọi ứng dụng đều lấy package từ Dartastic Pub của bạn và gửi đến Observatory của bạn, nên khi demo chạy được, tài khoản của bạn đã được chứng minh là hoạt động.
Tải về
Đăng nhập Control Room và nhấn Reference Demo ở đầu mọi màn hình, cạnh “Help”:

Bạn tải về dartastic-otel-reference-demo-<version>.tar.gz. Giải nén ở bất kỳ đâu bạn lưu mã nguồn:
tar -xzf dartastic-otel-reference-demo-*.tar.gz
cd dartastic-otel-reference-demo-*Tệp README.md ở thư mục gốc là hướng dẫn đầy đủ. Các bước dưới đây đưa bạn đến lần chạy đầu tiên.
Trên Dedicated: trỏ demo đến máy chủ của bạn
Demo ban đầu trỏ đến Dartastic Cloud, nên trên Cloud bạn không cần làm gì ở đây. Trên Dedicated, chạy lệnh này một lần với tên miền phụ của bạn:
tool/set-hosted-slug.sh <subdomain>Lệnh ghi tên miền phụ của bạn vào .env (git bỏ qua tệp này) và cập nhật các pubspec. Chạy lại với tên miền phụ khác để chuyển, hoặc với "" để quay về Cloud.
Các token demo cần
Tạo từng token trên màn hình Tokens của Control Room. Mỗi token chỉ hiển thị một lần, nên hãy sao chép ngay khi tạo.
| Token | Cần cho |
|---|---|
Token Pubdart pub token add (một lần) | Mọi demo: flutter pub get lấy package từ Dartastic Pub của bạn. |
Token OTLPOTEL_EXPORTER_OTLP_HEADERS | Mọi demo: các ứng dụng gửi telemetry đến Observatory của bạn. |
Token SymbolizerDARTASTIC_SYMBOLIZER_TOKEN | Chỉ symbolizer_demo_flutter. |
Một token Pub chỉ đọc là đủ cho mọi demo trừ symbolizer_demo_flutter và crash_demo_flutter, hai demo xuất bản lên Pub của bạn và cần token đọc và ghi. Trang Bắt đầu hướng dẫn cách thêm token Pub và export các token còn lại.
Export các token trong shell thay vì ghi chúng vào .env: một tệp .env được chia sẻ hoặc commit là cách secret thường bị lộ.
Chạy một demo
Demo là một Flutter workspace, nên hãy lấy package cho mọi ứng dụng cùng lúc từ thư mục gốc:
flutter pub getNếu lệnh thành công, Dartastic Pub và token Pub của bạn đều hoạt động. Sau đó khởi động một ứng dụng; tool/launch.sh hỏi bạn chạy trên thiết bị nào:
tool/launch.sh --list # every demo app
tool/launch.sh # weather_flutter
tool/launch.sh rum_demo_flutter- Docker chỉ cần cho
weather_fluttervàall_demos_flutter: chúng khởi chạy API thời tiết trên máy bạn để cho thấy một trace đi qua cả ứng dụng và máy chủ. - Các demo chạy trên Android, iOS, macOS, Windows và Linux, trên thiết bị thật và trình giả lập. Chúng không chạy trên web.
Bên trong có gì
| Ứng dụng | Cho thấy gì |
|---|---|
weather_flutter | Một lượt chạm được trace từ đầu đến cuối: ứng dụng, API thời tiết, bộ nhớ đệm của nó và dịch vụ thời tiết bên ngoài, trong một trace. |
all_demos_flutter | Gần như mọi demo, mỗi demo là một tab trong một ứng dụng. |
rum_demo_flutter | Phiên, lượt xem màn hình, lượt chạm và tín hiệu bực bội, kèm phát lại phiên. |
crash_demo_flutter | Crash được ghi lại và gửi đi ngay cả khi ứng dụng chết. |
symbolizer_demo_flutter | Một bản build phát hành bị làm rối mã có stack trace được đưa về lại tệp và dòng mã của bạn, và jank được truy đến tận widget. |
anr_demo_flutter | Phát hiện App Not Responding (ứng dụng không phản hồi). |
pii_demo_flutter | Giữ dữ liệu cá nhân ngoài telemetry của bạn. |
webview_demo_flutter | Telemetry từ một trang web bên trong ứng dụng, gắn vào trace của ứng dụng. |
| Vitals của nền tảng | Tình trạng bản phát hành, Android Vitals, iOS MetricKit, khởi động ứng dụng, trạng thái thiết bị, trạng thái nhiệt, mạng chập chờn, trải nghiệm người dùng và vitals của máy chủ Linux, mỗi thứ một ứng dụng. |
Mỗi ứng dụng có liên kết đến những gì nó đã gửi trong Observatory của bạn. Để học một tính năng, hãy chạy ứng dụng của tính năng đó, rồi đọc mã: đó là ví dụ chạy được nhỏ nhất của tính năng ấy. Bạn cũng có thể trỏ trợ lý lập trình AI của mình vào đó.
Những gì bạn thấy trong Observatory
Các màn hình từ một lần chạy các demo. Lần chạy của bạn cho số liệu riêng; những gì mỗi màn hình cho thấy thì giống nhau.
Thời gian build frame

Tình trạng bản phát hành

Khởi động ứng dụng

Mạng chập chờn

Interaction to Next Paint

First Contentful Paint

App Not Responding, dưới dạng sự kiện

App Not Responding, kéo dài bao lâu

Các lần thoát ứng dụng theo iOS MetricKit
