Tổng quan
Dartastic cho bạn thấy ứng dụng Dart và Flutter của mình thực sự chạy thế nào trong tay người dùng, và giúp bạn sửa những gì trục trặc. Trang này là bản đồ. Hãy đọc một lần, rồi làm theo Bắt đầu từng bước một.
Nền tảng
Mỗi trang Trợ giúp đều có cùng hình này, với những phần trang đó nói đến được làm nổi bật, để bạn luôn biết mình đang ở đâu.
- Bạn build trên máy tính và trong CI của bạn. Ứng dụng của bạn lấy các package Dartastic từ Dartastic Pub, giống như cách nó lấy package từ pub.dev.
- Ứng dụng của bạn chạy trên điện thoại và máy tính, trong trình duyệt, và dưới dạng máy chủ Dart. Các package Dartastic OTel bên trong ghi lại những gì xảy ra và gửi đến Observatory.
- Khi có sự cố, Symbolizer đưa crash về lại đúng tệp và dòng mã của bạn, nhờ các symbol bạn đã xuất bản lên Pub cùng ứng dụng.
- Khi bạn muốn biết vì sao, bạn hỏi Dartastic AI. AI đọc telemetry và mã nguồn của bạn trên Pub, rồi trả lời kèm nguyên nhân và cách sửa.
- Control Room là nơi bạn thiết lập tất cả những điều này: nó tạo các token mở từng mũi tên trong sơ đồ.
Các thành phần
| Thành phần | Chức năng | Bạn gặp nó ở đâu |
|---|---|---|
| Control Room | Tài khoản của bạn. Tại đây bạn tạo token, mời đồng đội, chọn gói và tải Reference Demo. | dartastic.io/control-room, sau khi bạn đăng nhập |
| Dartastic Pub | Kho package riêng tư hoạt động như pub.dev. Bạn lấy các package Dartastic từ đó, lưu các package riêng tư của mình trên đó, và xuất bản mã nguồn ứng dụng lên đó. | dart pub get, dart pub publish |
| Dartastic OTel | Các package bạn thêm vào ứng dụng. Chúng ghi lại những gì xảy ra trong ứng dụng (màn hình, lượt chạm, lệnh gọi mạng, lỗi, crash, hiệu năng) dưới dạng OpenTelemetry và gửi đi. | pubspec.yaml và main() của bạn |
| Observatory | Nơi bạn xem. Phiên kèm phát lại, trace, log, metric, crash, dashboard và cảnh báo cho mọi thứ ứng dụng của bạn gửi đến. | Mở từ Control Room |
| Symbolizer | Biến stack trace khó đọc của một bản build phát hành bị làm rối mã trở lại thành tên tệp và số dòng của bạn. Nó tự chạy khi crash đến. | Không cần gọi gì: nó đọc các symbol bạn xuất bản lên Pub |
| Dartastic AI | Trả lời câu hỏi về ứng dụng của bạn bằng ngôn ngữ thường ngày. AI đọc telemetry và mã nguồn của bạn trên Pub, tìm nguyên nhân và đề xuất cách sửa. | Nút “Ask” trong Observatory và Control Room |
Những gì bạn sẽ thấy
Đây là Observatory. Mỗi phiên của người dùng được liệt kê cùng màn hình, lượt chạm, lỗi và tín hiệu bực bội của phiên đó:

Mở một phiên và phát lại. Ngay dưới đầu phát, bạn thấy trace, log và lỗi tại thời điểm đó, và có thể nhảy thẳng đến dòng mã:

Token kết nối các thành phần
Mỗi mũi tên trong sơ đồ cần một loại token riêng. Bạn tạo chúng trong Control Room, và mỗi token chỉ hiển thị cho bạn một lần duy nhất, nên hãy sao chép ngay khi tạo. Phần lớn nhà phát triển chưa từng dùng token với dart pub; trang Pub hướng dẫn bạn từng bước.
| Token | Từ | Đến | Cho phép |
|---|---|---|---|
| Token Pub | Máy tính của bạn | Dartastic Pub | dart pub get tải được các package Dartastic và các package riêng tư của bạn; dart pub publish tải lên được. |
| Trao đổi token CI | CI của bạn | Dartastic Pub | CI của bạn đọc và xuất bản package mà không cần lưu token nào trong đó. |
| Token OTLP | Ứng dụng của bạn trên điện thoại hoặc máy tính, máy chủ Dart của bạn | Observatory | Ứng dụng của bạn được gửi telemetry. |
| Token Browser OTLP | Ứng dụng Flutter web của bạn | Observatory | Ứng dụng web của bạn được gửi telemetry, chỉ từ các trang web bạn liệt kê. |
Mọi token bạn đang giữ được liệt kê trên một màn hình. Trang Tokens giải thích từng loại, và cách thu hồi hoặc thay thế một token.
Nơi nền tảng chạy: gói của bạn
- Cloud chạy trên hạ tầng Dartastic dùng chung giữa các khách hàng. Pub của bạn là
pub.dartastic.io. - Dedicated cấp cho tổ chức của bạn một máy chủ riêng, tại tên miền phụ bạn chọn: Pub của bạn là
pub.<subdomain>.dartastic.io. - Self-Hosted chạy toàn bộ nền tảng bên trong mạng của chính bạn.
Các bước giống nhau trên mọi gói. Khi một URL khác nhau, các trang này ghi cả hai. So sánh các gói.
Bạn cần gì
- Flutter 3.44 và Dart 3.12 trở lên cho mọi tính năng; Flutter 3.22 và Dart 3.4 cho mọi tính năng trừ metric Flutter. Mỗi package cần phiên bản nào.
- Một tài khoản Dartastic: đăng ký miễn phí. Khi đăng ký, tổ chức của bạn bắt đầu với Cloud Free, không cần thẻ.
- Chỉ cho backend thời tiết của Reference Demo: Docker.
Cách học
Chọn cách nào hợp với bạn; các cách đều đề cập cùng nội dung.
- Đọc các trang này theo thứ tự. Nút Trước và Tiếp ở cuối mỗi trang dẫn bạn đi tiếp.
- Chạy Dartastic OTel Reference Demo. Đây là phiên bản thương mại nâng cao của Dart OTel Reference Demo mã nguồn mở: nhiều demo hơn hẳn, là các ứng dụng Flutter chạy được, cho thấy cách dùng mọi tính năng của Dartastic, với phần thiết lập đã làm sẵn. Hãy đọc mã, sao chép từ đó, hoặc trỏ trợ lý lập trình AI của bạn vào đó. Tải Reference Demo.
- Hỏi: Hỗ trợ trả lời câu hỏi của bạn.
Các thuật ngữ dùng trong những trang này
- OpenTelemetry (OTel)
- Tiêu chuẩn mở để ghi lại những gì phần mềm làm. Dartastic dùng nó từ đầu đến cuối, nên không gì bạn viết bị phụ thuộc vào Dartastic.
- OTLP
- Định dạng truyền dữ liệu của OpenTelemetry: cách ứng dụng của bạn gửi những gì nó đã ghi lại.
- Trace và span
- Một span là một phần việc có đo thời gian (một lượt chạm, một lệnh gọi mạng, một truy vấn cơ sở dữ liệu). Một trace là cây các span của một thao tác, kể cả khi thao tác đó đi qua cả ứng dụng và máy chủ của bạn.
- Log
- Một dòng văn bản ứng dụng của bạn đã ghi, gắn với trace mà nó xảy ra trong đó.
- Metric
- Một con số đo theo thời gian: thời gian frame, bộ nhớ, số lượng request.
- Phiên
- Một lượt dùng ứng dụng của một người, từ lúc mở đến lúc rời đi, với mọi màn hình, lượt chạm, lỗi và trace trong đó.
- Phát lại
- Xem lại một phiên. Bạn chọn mức ghi lại: dòng thời gian sự kiện, wireframe, hoặc pixel thật.
- RUM
- Giám sát người dùng thực (Real User Monitoring): telemetry từ những người thật sự dùng ứng dụng của bạn, khác với dữ liệu từ kiểm thử.
- Làm rối mã và symbol
- Một bản build phát hành có thể xáo trộn các tên của nó (flutter build --obfuscate). Tệp symbol mà bản build ghi ra (--split-debug-info) là chìa khóa để gỡ rối chúng.
- Token
- Một chuỗi bí mật dài cho phép một thứ giao tiếp với đúng một thứ khác. Mỗi loại mở một đường trong sơ đồ ở trên.