Những trang này hiển thị URL của Cloud. Đăng nhập trên Dedicated để các trang hiển thị URL máy chủ của bạn.

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.

XÂY DỰNGKIẾN TRÚC DARTASTICNGƯỜI DÙNGtokentickettoken Pubpushtrao đổi từ CIứng dụng đến tay người dùng: kho ứng dụng, web, máy chủsymbolcrashstack tracemã nguồntelemetryMáy tính nhà phát triểnflutter run · dart pub getCIGitHub Actions, GitLab, …Control Roomtạo token · phân quyền theo vai tròControl Planetổ chức · vai trò · tokenDartastic Pubpackage · mã nguồnObservatoryphiên · trace · logSymbolizercrash → dòng mã nguồnDartastic AItrả lời từ cả haiHệ thống quản lý ticketGitHub · Jira · LinearỨng dụng di động + desktopđiện thoại · máy tính bảng · máy tínhgửi bằng token OTLPỨng dụng webtrong trình duyệtgửi bằng token Browser OTLPMáy chủ Dartbackend · dịch vụgửi bằng token OTLP

Tải về

Đăng nhập Control Room và nhấn Reference Demo ở đầu mọi màn hình, cạnh “Help”:

Phần đầu trang của Control Room với nút “Reference Demo”, cạnh “Help” và “Sign Out”

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:

shell
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:

shell
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.

TokenCần cho
Token Pub
dart pub token add (một lần)
Mọi demo: flutter pub get lấy package từ Dartastic Pub của bạn.
Token OTLP
OTEL_EXPORTER_OTLP_HEADERS
Mọi demo: các ứng dụng gửi telemetry đến Observatory của bạn.
Token Symbolizer
DARTASTIC_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:

shell
flutter pub get

Nế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:

shell
tool/launch.sh --list          # every demo app
tool/launch.sh                 # weather_flutter
tool/launch.sh rum_demo_flutter
  • Docker chỉ cần cho weather_flutter và 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ụngCho thấy gì
weather_flutterMộ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_flutterGần như mọi demo, mỗi demo là một tab trong một ứng dụng.
rum_demo_flutterPhiê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_flutterCrash được ghi lại và gửi đi ngay cả khi ứng dụng chết.
symbolizer_demo_flutterMộ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_flutterPhát hiện App Not Responding (ứng dụng không phản hồi).
pii_demo_flutterGiữ dữ liệu cá nhân ngoài telemetry của bạn.
webview_demo_flutterTelemetry 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ảngTì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

all_demos_flutter trên màn hình “Metric” cho flutter.frame.build, dưới dạng heatmap: bốn phút frame, với đường p95 tăng dần trong suốt lần chạy.
all_demos_flutter trên màn hình “Metric” cho flutter.frame.build, dưới dạng heatmap: bốn phút frame, với đường p95 tăng dần trong suốt lần chạy.

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

Trace được lọc theo các span flutter.session của demo tình trạng bản phát hành, mỗi phiên một span. Span màu đỏ là phiên bị crash.
Trace được lọc theo các span flutter.session của demo tình trạng bản phát hành, mỗi phiên một span. Span màu đỏ là phiên bị crash.

Khởi động ứng dụng

Màn hình “Metric” cho flutter.app.startup.duration, dưới dạng heatmap: ba lần khởi động nguội khoảng 2,2 s và hai lần khởi động nóng 33 và 63 ms.
Màn hình “Metric” cho flutter.app.startup.duration, dưới dạng heatmap: ba lần khởi động nguội khoảng 2,2 s và hai lần khởi động nóng 33 và 63 ms.

Mạng chập chờn

Trace được lọc theo dartastic.network.flaky = true: hai request chập chờn, một mất 6,56 s và một 114 ms kết thúc bằng lỗi.
Trace được lọc theo dartastic.network.flaky = true: hai request chập chờn, một mất 6,56 s và một 114 ms kết thúc bằng lỗi.

Interaction to Next Paint

Màn hình “Metric” cho flutter.experience.inp, dưới dạng heatmap: tám lượt tương tác, hai lượt dưới 16 ms và sáu lượt ở mức 200 đến 250 ms.
Màn hình “Metric” cho flutter.experience.inp, dưới dạng heatmap: tám lượt tương tác, hai lượt dưới 16 ms và sáu lượt ở mức 200 đến 250 ms.

First Contentful Paint

Màn hình “Metric” cho flutter.experience.fcp: một lần first contentful paint, ở 2,67 s.
Màn hình “Metric” cho flutter.experience.fcp: một lần first contentful paint, ở 2,67 s.

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

Log được lọc theo các sự kiện dartastic.app.anr của anr_demo_flutter: ba ANR, được tính vào “Unspecified” vì một sự kiện không mang mức độ nghiêm trọng, và mỗi hàng hiển thị tên sự kiện của nó.
Log được lọc theo các sự kiện dartastic.app.anr của anr_demo_flutter: ba ANR, được tính vào “Unspecified” vì một sự kiện không mang mức độ nghiêm trọng, và mỗi hàng hiển thị tên sự kiện của nó.

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

Cùng ba ANR đó trên màn hình “Metric” cho flutter.anr.duration: mỗi lần 6,0 đến 6,6 s, tại thời điểm được export.
Cùng ba ANR đó trên màn hình “Metric” cho flutter.anr.duration: mỗi lần 6,0 đến 6,6 s, tại thời điểm được export.

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

Màn hình “Metric” cho dartastic.app.exit.count, dưới dạng cột: 50 lần thoát trong một bước năm phút, 43 bình thường, 3 do hết bộ nhớ, 3 do watchdog và 1 do timeout.
Màn hình “Metric” cho dartastic.app.exit.count, dưới dạng cột: 50 lần thoát trong một bước năm phút, 43 bình thường, 3 do hết bộ nhớ, 3 do watchdog và 1 do timeout.