Từ lần đăng nhập đầu tiên đến câu trả lời về ứng dụng của bạn trong production.
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.
Bắt đầu
Từ lần đầu tìm hiểu OpenTelemetry đến trace đầu tiên của chính bạn trong Observatory. Mỗi bước dựa trên bước trước, nên hãy làm theo thứ tự.
Về OpenTelemetry
Bắt đầu với OpenTelemetry
Dartastic được xây dựng trên OpenTelemetry (OTel), tiêu chuẩn mở để ghi lại những gì phần mềm làm. Dartastic bám sát đặc tả OpenTelemetry: tên gọi, dữ liệu và cách gửi đều theo chuẩn. Những gì bạn học về OpenTelemetry áp dụng được cho Dartastic, và những gì bạn xây dựng với Dartastic vẫn là OpenTelemetry chuẩn.
Đặc tả này dễ tiếp cận. Trước khi đi tiếp, hãy dành một giờ đọc tài liệu OpenTelemetry để nắm những điều cơ bản:
Những gì đã xảy ra, từng bước một, và mỗi bước mất bao lâu. Một trace là cây các span: một lượt chạm, lệnh gọi mạng mà nó tạo ra, phần việc trên máy chủ đằng sau lệnh gọi đó, truy vấn cơ sở dữ liệu bên dưới. Một trace có thể đi từ ứng dụng sang máy chủ của bạn.
Các con số đo theo thời gian: thời gian frame, bộ nhớ, số request mỗi phút, số lỗi mỗi bản phát hành. Lưu trữ rẻ, nên chúng cho thấy xu hướng và kích hoạt cảnh báo.
Các dòng văn bản có thời điểm và mức độ nghiêm trọng. Trong OpenTelemetry, một log mang theo trace đang diễn ra khi nó được ghi, nên từ một log bạn có thể mở mọi thứ khác đã xảy ra vào thời điểm ấy.
Cả ba đều mang một tài nguyên: ứng dụng nào gửi, phiên bản nào, trên thiết bị nào. Dartastic bổ sung giám sát người dùng thực (phiên, màn hình, lượt chạm và phát lại), cũng được ghi lại dưới dạng tín hiệu chuẩn. Trang Tổng quan giải thích các thuật ngữ khác dùng trong những trang này.
1. Đăng nhập
Đăng nhập dartastic.io. Lần đầu tiên, bạn thiết lập tổ chức của mình: tài khoản sở hữu token, đồng đội và gói của bạn. Nếu một đồng đội đã mời bạn, hãy đăng nhập bằng địa chỉ email được mời, và bạn tham gia tổ chức của họ.
Khi đăng ký, tổ chức của bạn bắt đầu với Cloud Free, không cần thẻ. Bạn được hỏi:
Tên tổ chức và tên miền phụ: tên tổ chức, và tên miền phụ mà ứng dụng của bạn gửi telemetry đến. Tên miền phụ là của bạn mãi mãi.
Khu vực: nơi lưu trữ telemetry của bạn. Không thể thay đổi sau này.
Giới hạn RUM: mức phát lại cao nhất mà engine của bạn được ghi. Cloud Free lên đến mức Wireframe; Shadow và Pixel có trong các gói trả phí. Engine của bạn được rèn theo lựa chọn này, và không gì trên thiết bị vượt qua được giới hạn đó.
Dartastic AI: chạy bằng khóa mô hình của riêng bạn, bạn có thể thêm ngay lúc đó hoặc sau này.
Nếu chỉ dùng Dartastic Pub, hãy chọn một gói Pub trên trang Bảng giá trước khi đăng ký. Bạn đặt tên tổ chức và chọn khu vực, ngoài ra không cần gì thêm.
Nhấn Reference Demo ở đầu Control Room rồi giải nén. Bạn chạy nó ở bước 5: đây là cách nhanh nhất để thấy Dartastic hoạt động, và mã của nó cho thấy cách dùng mọi tính năng. Tìm hiểu thêm về Reference Demo.
3. Kết nối dart pub với Dartastic Pub của bạn
Các package Dartastic đến từ Dartastic Pub của bạn, không phải pub.dev, và dart pub cần một token để đọc từ đó. Phần lớn nhà phát triển chưa từng làm việc này; chỉ mất một phút, một lần cho mỗi máy tính.
Dartastic Pub cũng chuyển tiếp đến pub.dev. Khai báo package trong pubspec.yaml như bạn vẫn làm, các package từ pub.dev tự động được lấy từ pub.dev, cùng với các package Dartastic và các package riêng tư của bạn.
Name: một tên bất kỳ giúp phân biệt các token của bạn; chúng tôi đề xuất pub-org-read-write.
Organization: tổ chức có các package mà token này đọc và xuất bản.
Allow write (publish) access: đánh dấu ô này để xuất bản lên Dartastic Pub của bạn bằng token này. Nếu không, token chỉ đọc được, và đó là tất cả những gì Reference Demo cần, trừ symbolizer_demo_flutter và crash_demo_flutter, hai demo xuất bản lên Pub của bạn.
Nhấn Generate. Token của bạn được hiển thị một lần: Sao chép token bằng nút sao chép ngay bây giờ: khi đóng cửa sổ này, token không thể hiển thị lại. Granted scopes: Pub nghĩa là token này chỉ dùng cho Pub: nó không gửi được telemetry hay gọi bất kỳ dịch vụ nào khác.
Trong cửa sổ dòng lệnh, đưa token cho dart pub:
shell
dart pub token add https://pub.dartastic.io
Khi nó hỏi Enter secret token:, dán token rồi nhấn Enter. Lời nhắc không hiển thị gì khi bạn dán; điều đó là bình thường. Nó trả lời:
terminal
Enter secret token:
Requests to "https://pub.dartastic.io" will now be authenticated using the secret token.
Trong thư mục của Reference Demo, lấy các package của nó:
shell
flutter pub get
Nếu lệnh thành công, Pub và token của bạn đều hoạt động.
dart pub lưu token cho host đó và chỉ gửi token đến đó. Trang Pub hướng dẫn cách liệt kê, thay thế và xóa token, và cách xuất bản.
Token Pub truy cập được những package nào
Một token Pub truy cập được các package mà chủ sở hữu token được phép dùng, không hơn.
Quản trị viên tổ chức có mọi package trong tổ chức, nên token của họ cũng vậy.
Các đồng đội khác chỉ tạo được token cho các package họ đã được cấp. Quản trị viên cấp package cho đồng đội.
Xem Mời đồng đội để biết về các vai trò, và Pub để biết cách cấp package cho thành viên tổ chức.
4. Cho phép ứng dụng gửi telemetry
Trên màn hình Tokens, tạo một token OTLP, rồi export nó trong shell theo dạng chuẩn của OpenTelemetry. Giữ authorization viết thường:
Khi Docker đang chạy, khởi động demo thời tiết từ thư mục của Reference Demo và chọn một thiết bị:
shell
tool/launch.sh weather_flutter
Chạm để lấy thông tin thời tiết. Lượt chạm đó bắt đầu một trace đi qua ứ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.
6. Xem trong Observatory
Lượt chạm của bạn đến Observatory trong vài giây. Ứng dụng có liên kết đến những gì nó đã gửi: theo liên kết để mở trace và xem từng bước cùng thời gian của mỗi bước.
Chúng tôi dùng cookie thiết yếu để vận hành trang web này, và chỉ dùng cookie phân tích khi bạn đồng ý. Xem Chính sách cookie và Chính sách quyền riêng tư của chúng tôi.